Share via


az afd rule

Administrar reglas de entrega dentro del conjunto de reglas especificado.

Comandos

Nombre Description Tipo Estado
az afd rule action

Administrar reglas de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule action add

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule action list

Obtenga una regla de entrega existente dentro de un conjunto de reglas.

Core GA
az afd rule action remove

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule condition

Administrar reglas de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule condition add

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule condition list

Obtenga una regla de entrega existente dentro de un conjunto de reglas.

Core GA
az afd rule condition remove

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule create

Cree una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule delete

Elimine una regla de entrega existente dentro de un conjunto de reglas.

Core GA
az afd rule list

Enumere todas las reglas de entrega existentes dentro de un conjunto de reglas.

Core GA
az afd rule show

Obtenga una regla de entrega existente dentro de un conjunto de reglas.

Core GA
az afd rule update

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

Core GA
az afd rule wait

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

Core GA

az afd rule create

Cree una nueva regla de entrega dentro del conjunto de reglas especificado.

az afd rule create --name
                   --profile-name
                   --resource-group
                   --rule-set-name
                   [--action-name]
                   [--cache-behavior]
                   [--cache-duration]
                   [--custom-fragment]
                   [--custom-hostname]
                   [--custom-path]
                   [--custom-querystring]
                   [--destination]
                   [--enable-caching {0, 1, f, false, n, no, t, true, y, yes}]
                   [--enable-compression {0, 1, f, false, n, no, t, true, y, yes}]
                   [--forwarding-protocol]
                   [--header-action]
                   [--header-name]
                   [--header-value]
                   [--match-processing-behavior {Continue, Stop}]
                   [--match-values]
                   [--match-variable]
                   [--negate-condition {0, 1, f, false, n, no, t, true, y, yes}]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--operator]
                   [--order]
                   [--origin-group]
                   [--preserve-unmatched-path {0, 1, f, false, n, no, t, true, y, yes}]
                   [--query-parameters]
                   [--query-string-caching-behavior]
                   [--redirect-protocol]
                   [--redirect-type]
                   [--selector]
                   [--source-pattern]
                   [--transforms]

Ejemplos

Cree una regla para anexar un encabezado de respuesta para las solicitudes de Tailandia.

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 2 --match-variable RemoteAddress --operator GeoMatch --match-values TH --rule-name disablecaching --action-name ModifyResponseHeader --header-action Append --header-name X-CDN --header-value AFDX

Creación de una regla para la redirección http a https

az afd rule create -g group --rule-set-name ruleset1 --profile-name profile --order 1 --rule-name "redirect" --match-variable RequestScheme --operator Equal --match-values HTTP --action-name "UrlRedirect" --redirect-protocol Https --redirect-type Moved

Parámetros requeridos

--name --rule-name -n

Nombre de la regla de entrega que es única dentro del punto de conexión.

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

--rule-set-name

Nombre del conjunto de reglas en el perfil.

Parámetros opcionales

--action-name
--cache-behavior

Comportamiento de almacenamiento en caché de las solicitudes.

--cache-duration

Duración durante la que se debe almacenar en caché el contenido. El formato permitido es [d.]hh:mm:ss.

--custom-fragment

Fragmento que se va a agregar a la dirección URL de redireccionamiento.

--custom-hostname

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 pat de destino.

--custom-querystring

El conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento.deje vacío para conservar la cadena de consulta entrante.

--destination

Ruta de acceso de destino que se usará en la reescritura.

--enable-caching

Indica si se va a habilitar el almacenamiento en caché en la 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
--forwarding-protocol

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

--header-action

Acción de encabezado para las solicitudes.

--header-name

Nombre del encabezado que se va a modificar.

--header-value

Valor del encabezado.

--match-processing-behavior

Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar.

valores aceptados: Continue, Stop
valor predeterminado: Continue
--match-values

Coincide con los valores de la condición de coincidencia. Por ejemplo, valores separados por espacios "GET" "HTTP". Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--match-variable
--negate-condition

Si es true, niega la condición.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--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
--operator

Operador de la condición de coincidencia.

--order

Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,3,Ã?â'}¢Ã}â'}Â?Â?ââ'}. Una regla con un orden menor se aplicará antes de una regla con un orden mayor. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán.

--origin-group

Nombre o identificador del OriginGroup que invalidaría el originGroup predeterminado.

--preserve-unmatched-path

Si es True, la ruta de acceso restante después del patrón de origen se anexará a la nueva ruta de acceso de destino.

valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--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 la red CDN almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir el almacenamiento en caché para evitar que las solicitudes que contienen cadenas de consulta se almacenen en caché o almacenen en caché todas las solicitudes con una dirección URL única.

--redirect-protocol

Protocolo que se va a usar para el redireccionamiento.

--redirect-type

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

--selector

Selector de la condición de coincidencia.

--source-pattern

Patrón de URI de solicitud que identifica el tipo de solicitudes que se pueden reescribir.

--transforms

Transformación que se va a aplicar antes de la coincidencia. 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 rule delete

Elimine una regla de entrega existente dentro de un conjunto de reglas.

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

Ejemplos

Quite una regla con el nombre rule1.

az afd rule delete -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parámetros opcionales

--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 --rule-name -n

Nombre de la regla de entrega que es única dentro del punto de conexión.

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

--rule-set-name

Nombre del conjunto de reglas en el perfil.

--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 rule list

Enumere todas las reglas de entrega existentes dentro de un conjunto de reglas.

az afd rule list --profile-name
                 --resource-group
                 --rule-set-name
                 [--max-items]
                 [--next-token]

Ejemplos

Enumere todas las rutas dentro del punto de conexión especificado.

az afd route list -g group --profile-name profile --endpoint-name endpoint1

Parámetros requeridos

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

--rule-set-name

Nombre del conjunto de reglas en el perfil.

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 rule show

Obtenga una regla de entrega existente dentro de un conjunto de reglas.

az afd rule show [--ids]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--subscription]

Ejemplos

mostrar detalles de la regla de entrega con el nombre rule1.

az afd rule show -g group --rule-set-name ruleSetName --profile-name profile --rule-name rule1

Parámetros opcionales

--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 --rule-name -n

Nombre de la regla de entrega que es única dentro del punto de conexión.

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

--rule-set-name

Nombre del conjunto de reglas en el perfil.

--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 rule update

Actualice una nueva regla de entrega dentro del conjunto de reglas especificado.

az afd rule update [--actions]
                   [--add]
                   [--conditions]
                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                   [--ids]
                   [--match-processing-behavior {Continue, Stop}]
                   [--name]
                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                   [--order]
                   [--profile-name]
                   [--remove]
                   [--resource-group]
                   [--rule-set-name]
                   [--set]
                   [--subscription]

Parámetros opcionales

--actions

Lista de acciones que se ejecutan cuando se cumplen todas las condiciones de una regla. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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

--conditions

Lista de condiciones que deben coincidir para que las acciones se ejecuten compatibilidad con la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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

--match-processing-behavior

Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar.

valores aceptados: Continue, Stop
--name --rule-name -n

Nombre de la regla de entrega que es única dentro del punto de conexión.

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

Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,3,ÃшÆ'Æ’ÀšÃ'Â?Ã?ÃÆ'Ã'¢áââ⢚€Ã...... ¡Ã‚Ã'€ÃшÆ'Ã́'Â'?šÀšÃ'€Ã?Æ’ÀÀšÃ'¢ÃʺʕáÃ̒áÃ˾ Ã...... ¡Ã‚Ã'€ÃшÆ'Ã́'Â'?šÀšÃ'€Ã?Æ’ÀÀšÃ'¢ÃʺʕáÃ̒áÃ˾ Ã...... ¡Ã‚Ã'€ÃшÆ'ââ'?Å¡Ã!ÀšÃ'€€}. Una regla con un orden menor se aplicará antes de una regla con un orden mayor. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán.

--profile-name

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

--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-set-name

Nombre del conjunto de reglas en el perfil.

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

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 rule wait

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

az afd rule wait [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--interval]
                 [--name]
                 [--profile-name]
                 [--resource-group]
                 [--rule-set-name]
                 [--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
--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 --rule-name -n

Nombre de la regla de entrega que es única dentro del punto de conexión.

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

--rule-set-name

Nombre del conjunto de reglas en el perfil.

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