Compartir a través de

az afd route

  • Referencia

Administrar rutas en un punto de conexión de AFD.

Comandos

Nombre Description Tipo Estado
az afd route create

Cree una nueva ruta con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

 Core GA
az afd route delete

Elimine una ruta existente con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

 Core GA
az afd route list

Enumere todos los orígenes existentes dentro de un perfil.

 Core GA
az afd route show

Obtenga una ruta existente con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

 Core GA
az afd route update

Actualice una nueva ruta con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

 Core GA
az afd route wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Core GA

az afd route create

Cree una nueva ruta con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

az afd route create --endpoint-name
                    --name
                    --profile-name
                    --resource-group
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--rule-sets]
                    [--supported-protocols]

Ejemplos

Crea una ruta para asociar el dominio predeterminado del punto de conexión a un grupo de origen para todas las solicitudes HTTPS.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --https-redirect Disabled --origin-group og001 --supported-protocols Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest

Crea una ruta para asociar el dominio predeterminado del punto de conexión a un grupo de origen para todas las solicitudes y usar los conjuntos de reglas especificados para personalizar el comportamiento de ruta.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2 --origin-group og001 --supported-protocols Http Https --link-to-default-domain Enabled --forwarding-protocol MatchRequest --https-redirect Disabled

Crea una ruta para asociar el dominio predeterminado del punto de conexión y un dominio personalizado con un grupo de origen para todas las solicitudes con los patrones de ruta de acceso especificados y redirigir todo el tráfico para que use Https.

az afd route create -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --patterns-to-match /test1/* /tes2/* --origin-group og001 --supported-protocols Http Https --custom-domains cd001 --forwarding-protocol MatchRequest --https-redirect Enabled --link-to-default-domain Enabled

Parámetros requeridos

--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--name --route-name -n

Nombre de la regla de enrutamiento.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

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

Parámetros opcionales

--content-types-to-compress

Lista de tipos de contenido en los que se aplica la compresión. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--custom-domains

Dominios personalizados a los que hace referencia este punto de conexión. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--enable-caching

Indica si el almacenamiento en caché está enanble en esa ruta.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indica si la compresión de contenido está habilitada en AzureFrontDoor. El valor predeterminado es Falso. Si la compresión está habilitada, el contenido se servirá como comprimido si el usuario solicita una versión comprimida. El contenido no se comprimirá en AzureFrontDoor cuando el contenido solicitado sea inferior a 1 byte o superior a 1 MB.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Si desea habilitar el uso de esta regla. Los valores permitidos son "Enabled" o "Disabled".

valores aceptados: Disabled, Enabled
--forwarding-protocol

Protocolo que usará esta regla al reenviar el tráfico a los servidores back-end.

valores aceptados: HttpOnly, HttpsOnly, MatchRequest
valor predeterminado: MatchRequest
--https-redirect

Si se va a redirigir automáticamente el tráfico HTTP al tráfico HTTPS. Tenga en cuenta que esta es una manera fácil de configurar esta regla y será la primera regla que se ejecuta.

valores aceptados: Disabled, Enabled
valor predeterminado: Disabled
--link-to-default-domain

Si esta ruta se vinculará al dominio de punto de conexión predeterminado.

valores aceptados: Disabled, Enabled
valor predeterminado: Disabled
--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Nombre o identificador del grupo de origen al que se va a asociar.

--origin-path

Ruta de acceso de directorio en el origen que AzureFrontDoor puede usar para recuperar contenido, por ejemplo, contoso.cloudapp.net/originpath.

--patterns-to-match

Patrones de ruta de la regla. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--query-parameters

Parámetros de consulta que se van a incluir o excluir. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--query-string-caching-behavior

Define cómo Frontdoor almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir cadenas de consulta específicas, almacenar en caché cada solicitud con una dirección URL única o almacenar en caché cadenas de consulta específicas.

--rule-sets

Colección de identificadores o nombre del conjunto de reglas al que hace referencia la ruta. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--supported-protocols

Lista de protocolos admitidos para esta ruta. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

valor predeterminado: ['Http', 'Https']
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 afd route delete

Elimine una ruta existente con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

az afd route delete [--endpoint-name]
                    [--ids]
                    [--name]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--profile-name]
                    [--resource-group]
                    [--subscription]
                    [--yes]

Ejemplos

Elimine una ruta denominada route1.

az afd route delete -g group --profile-name profile --endpoint-name endpoint1 --route-name route1

Parámetros opcionales

--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --route-name -n

Nombre de la regla de enrutamiento.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

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

--subscription

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

--yes -y

No solicita confirmación.

valor predeterminado: False
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 afd route list

Enumere todos los orígenes existentes dentro de un perfil.

az afd route list --endpoint-name
                  --profile-name
                  --resource-group
                  [--max-items]
                  [--next-token]

Parámetros requeridos

--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

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

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

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 afd route show

Obtenga una ruta existente con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

az afd route show [--endpoint-name]
                  [--ids]
                  [--name]
                  [--profile-name]
                  [--resource-group]
                  [--subscription]

Parámetros opcionales

--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name --route-name -n

Nombre de la regla de enrutamiento.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

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

--subscription

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

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 afd route update

Actualice una nueva ruta con el nombre de ruta especificado en la suscripción, el grupo de recursos, el perfil y el punto de conexión de AzureFrontDoor especificados.

az afd route update [--add]
                    [--content-types-to-compress]
                    [--custom-domains]
                    [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                    [--enabled-state {Disabled, Enabled}]
                    [--endpoint-name]
                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                    [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                    [--https-redirect {Disabled, Enabled}]
                    [--ids]
                    [--link-to-default-domain {Disabled, Enabled}]
                    [--name]
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                    [--origin-group]
                    [--origin-path]
                    [--patterns-to-match]
                    [--profile-name]
                    [--query-parameters]
                    [--query-string-caching-behavior]
                    [--remove]
                    [--resource-group]
                    [--rule-sets]
                    [--set]
                    [--subscription]
                    [--supported-protocols]

Ejemplos

Actualice una ruta para aceptar solicitudes Http y Https y redirigir todo el tráfico para que use Https.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --supported-protocols Http Https --https-redirect Enabled

Actualice la configuración de los conjuntos de reglas de una ruta para personalizar el comportamiento de la ruta.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --rule-sets ruleset1 rulseset2

Actualice la configuración de compresión de una ruta para habilitar la compresión para los tipos de contenido especificados.

az afd route update -g group --endpoint-name endpoint1 --profile-name profile --route-name route1 --query-string-caching-behavior IgnoreQueryString --enable-compression true --content-types-to-compress text/javascript text/plain

Parámetros opcionales

--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 o JSON string>.

--content-types-to-compress

Lista de tipos de contenido en los que se aplica la compresión. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--custom-domains

Dominios personalizados a los que hace referencia este punto de conexión. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--enable-caching

Indica si el almacenamiento en caché está enanble en esa ruta.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indica si la compresión de contenido está habilitada en AzureFrontDoor. El valor predeterminado es false. Si la compresión está habilitada, el contenido se servirá como comprimido si el usuario solicita una versión comprimida. El contenido no se comprimirá en AzureFrontDoor cuando el contenido solicitado sea inferior a 1 byte o superior a 1 MB.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enabled-state

Si desea habilitar el uso de esta regla. Los valores permitidos son "Enabled" o "Disabled".

valores aceptados: Disabled, Enabled
--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--force-string

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

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protocolo que usará esta regla al reenviar el tráfico a los servidores back-end.

valores aceptados: HttpOnly, HttpsOnly, MatchRequest
--https-redirect

Si se va a redirigir automáticamente el tráfico HTTP al tráfico HTTPS. Tenga en cuenta que esta es una manera fácil de configurar esta regla y será la primera regla que se ejecuta.

valores aceptados: Disabled, Enabled
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--link-to-default-domain

Si esta ruta se vinculará al dominio de punto de conexión predeterminado.

valores aceptados: Disabled, Enabled
--name --route-name -n

Nombre de la regla de enrutamiento.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--origin-group

Nombre o identificador del grupo de origen al que se va a asociar.

--origin-path

Ruta de acceso de directorio en el origen que AzureFrontDoor puede usar para recuperar contenido, por ejemplo, contoso.cloudapp.net/originpath.

--patterns-to-match

Patrones de ruta de la regla. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--query-parameters

Parámetros de consulta que se van a incluir o excluir. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--query-string-caching-behavior

Define cómo Frontdoor almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir cadenas de consulta específicas, almacenar en caché cada solicitud con una dirección URL única o almacenar en caché cadenas de consulta específicas.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--rule-sets

Colección de identificadores o nombre del conjunto de reglas al que hace referencia la ruta. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--set

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

--subscription

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

--supported-protocols

Lista de protocolos admitidos para esta ruta. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 afd route wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az afd route wait [--created]
                  [--custom]
                  [--deleted]
                  [--endpoint-name]
                  [--exists]
                  [--ids]
                  [--interval]
                  [--name]
                  [--profile-name]
                  [--resource-group]
                  [--subscription]
                  [--timeout]
                  [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--endpoint-name

Nombre del punto de conexión en el perfil que es único globalmente.

--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--name --route-name -n

Nombre de la regla de enrutamiento.

--profile-name

Nombre del perfil de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos.

--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
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.