Compartir a través de

az network front-door routing-rule

  • Referencia

Nota:

Esta referencia forma parte de la extensión front-door para la CLI de Azure (versión 2.57.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az network front-door routing-rule . Obtenga más información sobre las extensiones.

Administrar reglas de enrutamiento de Front Door.

Comandos

Nombre Description Tipo Estado
az network front-door routing-rule create

Cree una regla de enrutamiento de Front Door.

 Extensión GA
az network front-door routing-rule delete

Elimine una regla de enrutamiento de Front Door.

 Extensión GA
az network front-door routing-rule list

Enumerar las reglas de enrutamiento de Front Door.

 Extensión GA
az network front-door routing-rule show

Obtenga los detalles de una regla de enrutamiento de Front Door.

 Extensión GA
az network front-door routing-rule update

Actualice una regla de enrutamiento de Front Door.

 Extensión GA

az network front-door routing-rule create

Cree una regla de enrutamiento de Front Door.

Cree una regla de enrutamiento de Front Door para reenviar las solicitudes a un back-end o redirigir a los usuarios a una dirección URL diferente.

Ejemplo 1: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Ejemplo 2: az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

Parámetros requeridos

--front-door-name -f

Nombre de Front Door.

--frontend-endpoints

Lista separada por espacios de nombres o identificadores de punto de conexión de front-end.

--name -n

Nombre de la regla de enrutamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--route-type

Tipo de ruta para definir cómo Front Door debe controlar las solicitudes de esta ruta, es decir, reenviarlas a un back-end o redirigir a los usuarios a una dirección URL diferente.

Valores aceptados: Forward, Redirect

Parámetros opcionales

--accepted-protocols

Lista separada por espacios de protocolos que se van a aceptar. Valor predeterminado: Http.

--backend-pool

Nombre o identificador de un grupo de back-end. Es necesario crear una regla de enrutamiento de reenvío.

--cache-duration

Duración durante la que se debe almacenar en caché el contenido. El formato permitido es la duración ISO 8601.

--caching

Si desea habilitar el almacenamiento en caché para esta ruta.

Valores aceptados: Disabled, Enabled
--custom-forwarding-path

Ruta de acceso personalizada que se usa para reescribir las rutas de acceso de recursos coincidentes con esta regla. Déjela en blanco para usar la ruta de acceso entrante.

--custom-fragment

Fragmento que se va a agregar a la dirección URL de redireccionamiento. El fragmento es la parte de la dirección URL que viene después de #. No incluya #.

--custom-host

Host para redirigir. Deje vacío para usar el host entrante como host de destino.

--custom-path

Ruta de acceso completa que se va a redirigir. La ruta de acceso no puede estar vacía y debe comenzar con /. Deje vacío para usar la ruta de acceso entrante como ruta de acceso de destino.

--custom-query-string

Conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento. Establecer este valor reemplazaría cualquier cadena de consulta existente; deje vacío para conservar la cadena de consulta entrante. La cadena de consulta debe estar en formato = . ¿La primera? y & se agregarán automáticamente, por lo que no los incluyan en el frente, pero separe varias cadenas de consulta con &.

--disabled

Cree en un estado deshabilitado.

Valores aceptados: false, true
--dynamic-compression

Use la compresión dinámica para el contenido almacenado en caché.

Valores aceptados: Disabled, Enabled
--forwarding-protocol

Protocolo que se va a usar para reenviar el tráfico.

Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--patterns

Lista separada por espacios de patrones que deben coincidir. Valor predeterminado: '/*'.

--query-parameter-strip-directive

Tratamiento de los términos de consulta url al formar la clave de caché.

Valores aceptados: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parámetros de consulta para incluir o excluir (separados por comas) al usar el tipo de directiva StripAllExcept o StripAllExcept de consulta, respectivamente.

--redirect-protocol

Protocolo del destino al que se redirige el tráfico.

Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
Valor predeterminado: MatchRequest
--redirect-type

El tipo de redireccionamiento que usará la regla al redirigir el tráfico.

Valores aceptados: Found, Moved, PermanentRedirect, TemporaryRedirect
Valor predeterminado: Moved
--rules-engine

Nombre o identificador de una configuración del motor de reglas. Para desvincular la propiedad , "--remove rulesEngine".

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network front-door routing-rule delete

Elimine una regla de enrutamiento de Front Door.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

Parámetros requeridos

--front-door-name -f

Nombre de Front Door.

--name -n

Nombre de la regla de enrutamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network front-door routing-rule list

Enumerar las reglas de enrutamiento de Front Door.

az network front-door routing-rule list --front-door-name
                                        --resource-group

Parámetros requeridos

--front-door-name -f

Nombre de Front Door.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network front-door routing-rule show

Obtenga los detalles de una regla de enrutamiento de Front Door.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

Parámetros requeridos

--front-door-name -f

Nombre de Front Door.

--name -n

Nombre de la regla de enrutamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az network front-door routing-rule update

Actualice una regla de enrutamiento de Front Door.

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

Parámetros requeridos

--front-door-name -f

Nombre de Front Door.

--name -n

Nombre de la regla de enrutamiento.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--accepted-protocols

Lista separada por espacios de protocolos que se van a aceptar. Valor predeterminado: Http.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

Valor predeterminado: []
--backend-pool

Nombre o identificador de un grupo de back-end. Es necesario crear una regla de enrutamiento de reenvío.

--cache-duration

Duración durante la que se debe almacenar en caché el contenido. El formato permitido es la duración ISO 8601.

--caching

Si desea habilitar el almacenamiento en caché para esta ruta.

Valores aceptados: Disabled, Enabled
--custom-forwarding-path

Ruta de acceso personalizada que se usa para reescribir las rutas de acceso de recursos coincidentes con esta regla. Déjela en blanco para usar la ruta de acceso entrante.

--custom-fragment

Fragmento que se va a agregar a la dirección URL de redireccionamiento. El fragmento es la parte de la dirección URL que viene después de #. No incluya #.

--custom-host

Host para redirigir. Deje vacío para usar el host entrante como host de destino.

--custom-path

Ruta de acceso completa que se va a redirigir. La ruta de acceso no puede estar vacía y debe comenzar con /. Deje vacío para usar la ruta de acceso entrante como ruta de acceso de destino.

--custom-query-string

Conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento. Establecer este valor reemplazaría cualquier cadena de consulta existente; deje vacío para conservar la cadena de consulta entrante. La cadena de consulta debe estar en formato = . ¿La primera? y & se agregarán automáticamente, por lo que no los incluyan en el frente, pero separe varias cadenas de consulta con &.

--dynamic-compression

Use la compresión dinámica para el contenido almacenado en caché.

Valores aceptados: Disabled, Enabled
--enabled

Estado habilitado.

Valores aceptados: Disabled, Enabled
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valor predeterminado: False
--forwarding-protocol

Protocolo que se va a usar para reenviar el tráfico.

Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Lista separada por espacios de nombres o identificadores de punto de conexión de front-end.

--patterns

Lista separada por espacios de patrones que deben coincidir. Valor predeterminado: '/*'.

--query-parameter-strip-directive

Tratamiento de los términos de consulta url al formar la clave de caché.

Valores aceptados: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Parámetros de consulta para incluir o excluir (separados por comas) al usar el tipo de directiva StripAllExcept o StripAllExcept de consulta, respectivamente.

--redirect-protocol

Protocolo del destino al que se redirige el tráfico.

Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

El tipo de redireccionamiento que usará la regla al redirigir el tráfico.

Valores aceptados: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

Valor predeterminado: []
--rules-engine

Nombre o identificador de una configuración del motor de reglas. Para desvincular la propiedad , "--remove rulesEngine".

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

Valor predeterminado: []
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.