Compartir a través de


az network application-gateway http-settings

Administrar la configuración HTTP de una puerta de enlace de aplicaciones.

Comandos

Nombre Description Tipo Estado
az network application-gateway http-settings create

Cree la configuración http.

Core GA
az network application-gateway http-settings delete

Elimina la configuración HTTP.

Core GA
az network application-gateway http-settings list

Enumerar la configuración HTTP.

Core GA
az network application-gateway http-settings show

Obtenga los detalles de la configuración http.

Core GA
az network application-gateway http-settings update

Actualice la configuración de HTTP.

Core GA
az network application-gateway http-settings wait

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

Core GA

az network application-gateway http-settings create

Cree la configuración http.

az network application-gateway http-settings create --gateway-name
                                                    --name
                                                    --port
                                                    --resource-group
                                                    [--affinity-cookie-name]
                                                    [--auth-certs]
                                                    [--connection-draining-timeout]
                                                    [--cookie-based-affinity {Disabled, Enabled}]
                                                    [--dedicated-backend-connection --dedicated-connection {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--enable-probe {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--host-name]
                                                    [--host-name-from-backend-pool {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--path]
                                                    [--probe]
                                                    [--protocol {Http, Https, Tcp, Tls}]
                                                    [--root-certs]
                                                    [--sni-name]
                                                    [--timeout]
                                                    [--validate-cert-ce --validate-cert-chain-and-expiry {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--validate-sni {0, 1, f, false, n, no, t, true, y, yes}]

Ejemplos

Cree la configuración http.

az network application-gateway http-settings create -g MyResourceGroup --gateway-name MyAppGateway -n MyHttpSettings --port 80 --protocol Http --cookie-based-affinity Disabled --timeout 30

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la configuración http de back-end.

--port

Número del puerto de destino en el back-end.

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

--affinity-cookie-name

Nombre usado para la cookie de afinidad.

--auth-certs

Lista separada por espacios de certificados de autenticación (nombres e identificadores) que se van a asociar a la configuración HTTP. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--connection-draining-timeout

Tiempo en segundos después de quitar un servidor back-end durante el cual la conexión abierta permanece activa. Oscila entre 0 (deshabilitado) y 3600.

Propiedad Valor
Valor predeterminado: 0
--cookie-based-affinity

Habilite o deshabilite la afinidad basada en cookies.

Propiedad Valor
Valor predeterminado: Disabled
Valores aceptados: Disabled, Enabled
--dedicated-backend-connection --dedicated-connection

Habilite o deshabilite la conexión dedicada por servidor backend. El valor predeterminado se establece en false.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-probe

Indica si el sondeo está habilitado.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--host-name

Encabezado de host enviado a los servidores back-end.

--host-name-from-backend-pool

Si se debe seleccionar el encabezado de host del nombre de host del servidor back-end.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

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

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--path

Ruta de acceso que prefijo todas las solicitudes HTTP.

--probe

Nombre o identificador del sondeo que se va a asociar a la configuración HTTP.

--protocol

Protocolo usado para comunicarse con el back-end.

Propiedad Valor
Valor predeterminado: Http
Valores aceptados: Http, Https, Tcp, Tls
--root-certs

Lista separada por espacios de certificados raíz de confianza (nombres e identificadores) que se van a asociar a la configuración HTTP. --host-name o --host-name-from-backend-pool es necesario cuando se establece este campo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--sni-name

Especifique un valor de SNI para que coincida con el nombre común del certificado en el back-end. De forma predeterminada, la puerta de enlace de aplicaciones usa el encabezado de host de la solicitud entrante como SNI. El valor predeterminado es NULL.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--timeout

Tiempo de espera de la solicitud en segundos.

--validate-cert-ce --validate-cert-chain-and-expiry

Verifique u omita las validaciones de cadena y expiración del certificado en el servidor back-end. El valor predeterminado se establece en true.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valor predeterminado: True
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--validate-sni

Cuando está habilitado, verifica si el nombre común del certificado proporcionado por el servidor back-end coincide con el valor de indicación de nombre de servidor (SNI). El valor predeterminado es true.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valor predeterminado: True
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
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 application-gateway http-settings delete

Elimina la configuración HTTP.

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

Ejemplos

Elimina la configuración HTTP.

az network application-gateway http-settings delete -g MyResourceGroup --gateway-name MyAppGateway -n MyHttpSettings

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la configuración http de back-end.

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

--no-wait

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

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
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 application-gateway http-settings list

Enumerar la configuración HTTP.

az network application-gateway http-settings list --gateway-name
                                                  --resource-group

Ejemplos

Enumerar la configuración HTTP.

az network application-gateway http-settings 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 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 application-gateway http-settings show

Obtenga los detalles de la configuración http.

az network application-gateway http-settings show --gateway-name
                                                  --name
                                                  --resource-group

Ejemplos

Obtenga los detalles de la configuración http.

az network application-gateway http-settings show -g MyResourceGroup --gateway-name MyAppGateway -n MyHttpSettings

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la configuración http de back-end.

--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 application-gateway http-settings update

Actualice la configuración de HTTP.

az network application-gateway http-settings update --gateway-name
                                                    --name
                                                    --resource-group
                                                    [--add]
                                                    [--affinity-cookie-name]
                                                    [--auth-certs]
                                                    [--connection-draining-timeout]
                                                    [--cookie-based-affinity {Disabled, Enabled}]
                                                    [--dedicated-backend-connection --dedicated-connection {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--enable-probe {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--host-name]
                                                    [--host-name-from-backend-pool {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--path]
                                                    [--port]
                                                    [--probe]
                                                    [--protocol {Http, Https, Tcp, Tls}]
                                                    [--remove]
                                                    [--root-certs]
                                                    [--set]
                                                    [--sni-name]
                                                    [--timeout]
                                                    [--validate-cert-ce --validate-cert-chain-and-expiry {0, 1, f, false, n, no, t, true, y, yes}]
                                                    [--validate-sni {0, 1, f, false, n, no, t, true, y, yes}]

Ejemplos

Actualice la configuración http para usar un nuevo sondeo.

az network application-gateway http-settings update -g MyResourceGroup --gateway-name MyAppGateway -n MyHttpSettings --probe MyNewProbe

Parámetros requeridos

--gateway-name

Nombre de la puerta de enlace de aplicaciones.

--name -n

Nombre de la configuración http de back-end.

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

--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
--affinity-cookie-name

Nombre usado para la cookie de afinidad.

--auth-certs

Lista separada por espacios de certificados de autenticación (nombres e identificadores) que se van a asociar a la configuración HTTP. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--connection-draining-timeout

Tiempo en segundos después de quitar un servidor back-end durante el cual la conexión abierta permanece activa. Oscila entre 0 (deshabilitado) y 3600.

--cookie-based-affinity

Habilite o deshabilite la afinidad basada en cookies.

Propiedad Valor
Valores aceptados: Disabled, Enabled
--dedicated-backend-connection --dedicated-connection

Habilite o deshabilite la conexión dedicada por servidor backend. El valor predeterminado se establece en false.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-probe

Indica si el sondeo está habilitado.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--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
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--host-name

Encabezado de host enviado a los servidores back-end.

--host-name-from-backend-pool

Si se debe seleccionar el encabezado de host del nombre de host del servidor back-end.

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

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

Propiedad Valor
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--path

Ruta de acceso que prefijo todas las solicitudes HTTP.

--port

Número del puerto de destino en el back-end.

--probe

Nombre o identificador del sondeo que se va a asociar a la configuración HTTP.

--protocol

Protocolo usado para comunicarse con el back-end.

Propiedad Valor
Valores aceptados: Http, Https, Tcp, Tls
--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
--root-certs

Lista separada por espacios de certificados raíz de confianza (nombres e identificadores) que se van a asociar a la configuración HTTP. --host-name o --host-name-from-backend-pool es necesario cuando se establece este campo. 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=<value>.

Propiedad Valor
Grupo de parámetros: Generic Update Arguments
--sni-name

Especifique un valor de SNI para que coincida con el nombre común del certificado en el back-end. De forma predeterminada, la puerta de enlace de aplicaciones usa el encabezado de host de la solicitud entrante como SNI. El valor predeterminado es NULL.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--timeout

Tiempo de espera de la solicitud en segundos.

--validate-cert-ce --validate-cert-chain-and-expiry

Verifique u omita las validaciones de cadena y expiración del certificado en el servidor back-end. El valor predeterminado se establece en true.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--validate-sni

Cuando está habilitado, verifica si el nombre común del certificado proporcionado por el servidor back-end coincide con el valor de indicación de nombre de servidor (SNI). El valor predeterminado es true.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
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 application-gateway http-settings wait

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

az network application-gateway http-settings wait [--created]
                                                  [--custom]
                                                  [--deleted]
                                                  [--exists]
                                                  [--gateway-name]
                                                  [--ids]
                                                  [--interval]
                                                  [--resource-group]
                                                  [--subscription]
                                                  [--timeout]
                                                  [--updated]

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.

--created

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--gateway-name

Nombre de la puerta de enlace de aplicaciones.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False