Compartir a través de

az network front-door routing-rule

Note

Esta referencia forma parte de la extensión front-door para la CLI de Azure (versión 2.75.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.

 Extension GA
az network front-door routing-rule delete

Elimine una regla de enrutamiento de Front Door.

 Extension GA
az network front-door routing-rule list

Enumerar las reglas de enrutamiento de Front Door.

 Extension GA
az network front-door routing-rule show

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

 Extension GA
az network front-door routing-rule update

Actualice una regla de enrutamiento de Front Door.

 Extension 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.

Propiedad Valor
Grupo de parámetros: Routing Rule Arguments
Valores aceptados: Forward, Redirect

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--cache-duration

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--caching

Si se habilita el almacenamiento en caché para esta ruta.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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. Deje vacío para usar la ruta de acceso entrante.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--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 #.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--custom-host

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--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.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--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 <key>=<value> 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 &.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--disabled

Cree en un estado deshabilitado.

Propiedad Valor
Valores aceptados: false, true
--dynamic-compression

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
Valores aceptados: Disabled, Enabled
--forwarding-protocol

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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é.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--redirect-protocol

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
Valor predeterminado: MatchRequest
Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
Valor predeterminado: Moved
Valores aceptados: Found, Moved, PermanentRedirect, TemporaryRedirect
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
--backend-pool

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--cache-duration

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--caching

Si se habilita el almacenamiento en caché para esta ruta.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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. Deje vacío para usar la ruta de acceso entrante.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--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 #.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--custom-host

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--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.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--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 <key>=<value> 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 &.

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
--dynamic-compression

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
Valores aceptados: Disabled, Enabled
--enabled

Estado habilitado.

Propiedad Valor
Grupo de parámetros: Probe Setting Arguments
Valores aceptados: Disabled, Enabled
--force-string

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

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: False
--forwarding-protocol

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

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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é.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
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.

Propiedad Valor
Grupo de parámetros: Forward Routing Rule Arguments
--redirect-protocol

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
Valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

Propiedad Valor
Grupo de parámetros: Redirect Routing Rule Arguments
Valores aceptados: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

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

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
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>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
Valor predeterminado: []
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False