Compartir a través de

az network application-gateway rule

  • Referencia

Evalúe la información del sondeo y defina reglas de enrutamiento HTTP/HTTPS.

Para más información, visite https://learn.microsoft.com/en-us/azure/web-application-firewall/ag/application-gateway-customize-waf-rules-cli.

Comandos

Nombre Description Tipo Estado
az network application-gateway rule create

Cree una regla.

 Principal GA
az network application-gateway rule delete

Eliminar una regla.

 Principal GA
az network application-gateway rule list

Enumerar reglas.

 Principal GA
az network application-gateway rule show

Obtenga los detalles de una regla.

 Principal GA
az network application-gateway rule update

Actualice una regla.

 Principal GA
az network application-gateway rule wait

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

 Principal GA

az network application-gateway rule create

Editar

Cree una regla.

Las reglas se ejecutan en el orden en que se crean.

az network application-gateway rule create --gateway-name
                                           --name
                                           --resource-group
                                           [--address-pool]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--url-path-map]

Ejemplos

Cree una regla básica.

az network application-gateway rule create -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyBackendListener --rule-type Basic --address-pool MyAddressPool --http-settings MyHttpSettings

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la regla de enrutamiento de solicitudes.

--resource-group -g

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

Parámetros opcionales

--address-pool

Nombre o identificador del grupo de direcciones de back-end. Si solo existe una, omita usar como valor predeterminado.

--http-listener

Nombre o identificador del agente de escucha HTTP. Si solo existe una, omita usar como valor predeterminado.

--http-settings

Nombre o identificador de la configuración HTTP. Si solo existe una, omita usar como valor predeterminado.

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

Prioridad de la regla de enrutamiento de solicitudes. Los niveles de SKU admitidos se Standard_v2, WAF_v2.

--redirect-config

Nombre o identificador de la configuración de redireccionamiento que se va a usar con la regla creada.

--rewrite-rule-set

Nombre o identificador del conjunto de reglas de reescritura.

--rule-type

Tipo de la regla de enrutamiento de solicitudes.

Valores aceptados: Basic, PathBasedRouting
Valor predeterminado: Basic
--url-path-map

Nombre o identificador de la asignación de la ruta de acceso url.

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 application-gateway rule delete

Editar

Eliminar una regla.

az network application-gateway rule delete --gateway-name
                                           --name
                                           --resource-group
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Ejemplos

Eliminar una regla.

az network application-gateway rule delete -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la regla de enrutamiento de solicitudes.

--resource-group -g

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

Parámetros opcionales

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

Editar

Enumerar reglas.

az network application-gateway rule list --gateway-name
                                         --resource-group

Ejemplos

Enumerar reglas.

az network application-gateway rule list -g MyResourceGroup --gateway-name MyAppGateway

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

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

Editar

Obtenga los detalles de una regla.

az network application-gateway rule show --gateway-name
                                         --name
                                         --resource-group

Ejemplos

Obtenga los detalles de una regla.

az network application-gateway rule show -g MyResourceGroup --gateway-name MyAppGateway -n MyRule

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la regla de enrutamiento de solicitudes.

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

Editar

Actualice una regla.

az network application-gateway rule update --gateway-name
                                           --name
                                           --resource-group
                                           [--add]
                                           [--address-pool]
                                           [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--http-listener]
                                           [--http-settings]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--priority]
                                           [--redirect-config]
                                           [--remove]
                                           [--rewrite-rule-set]
                                           [--rule-type {Basic, PathBasedRouting}]
                                           [--set]
                                           [--url-path-map]

Ejemplos

La actualización de una regla usa un nuevo agente de escucha HTTP.

az network application-gateway rule update -g MyResourceGroup --gateway-name MyAppGateway -n MyRule --http-listener MyNewBackendListener

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la regla de enrutamiento de solicitudes.

--resource-group -g

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

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

--address-pool

Nombre o identificador del grupo de direcciones de back-end. Si solo existe una, omita usar como valor predeterminado.

--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
--http-listener

Nombre o identificador del agente de escucha HTTP. Si solo existe una, omita usar como valor predeterminado.

--http-settings

Nombre o identificador de la configuración HTTP. Si solo existe una, omita usar como valor predeterminado.

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

Prioridad de la regla de enrutamiento de solicitudes. Los niveles de SKU admitidos se Standard_v2, WAF_v2.

--redirect-config

Nombre o identificador de la configuración de redireccionamiento que se va a usar con la regla creada.

--remove

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

--rewrite-rule-set

Nombre o identificador del conjunto de reglas de reescritura.

--rule-type

Tipo de la regla de enrutamiento de solicitudes.

Valores aceptados: Basic, PathBasedRouting
--set

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

--url-path-map

Nombre o identificador de la asignación de la ruta de acceso url.

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

Editar

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

az network application-gateway rule wait [--created]
                                         [--custom]
                                         [--deleted]
                                         [--exists]
                                         [--gateway-name]
                                         [--ids]
                                         [--interval]
                                         [--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
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--gateway-name

Nombre de la puerta de enlace de aplicaciones.

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