Partager via

az network application-gateway http-settings

Gérer les paramètres HTTP d’une passerelle Application Gateway.

Commandes

Nom Description Type État
az network application-gateway http-settings create

Créez des paramètres HTTP.

 Core GA
az network application-gateway http-settings delete

Supprimez les paramètres HTTP.

 Core GA
az network application-gateway http-settings list

Répertorier les paramètres HTTP.

 Core GA
az network application-gateway http-settings show

Obtenez les détails des paramètres HTTP.

 Core GA
az network application-gateway http-settings update

Mettez à jour les paramètres HTTP.

 Core GA
az network application-gateway http-settings wait

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

 Core GA

az network application-gateway http-settings create

Modifier

Créez des paramètres 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}]

Exemples

Créez des paramètres 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

Paramètres obligatoires

--gateway-name

Nom de la passerelle d’application.

--name -n

Nom des paramètres http du back-end.

--port

Numéro du port de destination sur le serveur principal.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--affinity-cookie-name

Nom utilisé pour le cookie d’affinité.

--auth-certs

Liste séparée par l’espace des certificats d’authentification (noms et ID) à associer aux paramètres HTTP. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--connection-draining-timeout

Durée en secondes après la suppression d’un serveur principal pendant laquelle la connexion ouverte reste active. Plage comprise entre 0 (Désactivé) et 3600.

Propriété Valeur
Valeur par défaut: 0
--cookie-based-affinity

Activez ou désactivez l’affinité basée sur les cookies.

Propriété Valeur
Valeur par défaut: Disabled
Valeurs acceptées: Disabled, Enabled
--dedicated-backend-connection --dedicated-connection

Activez ou désactivez la connexion dédiée par serveur principal. La valeur par défaut est false.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--enable-probe

Indique si la sonde est activée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--host-name

En-tête de l’hôte envoyé aux serveurs principaux.

--host-name-from-backend-pool

Indique s’il faut choisir l’en-tête de l’hôte à partir du nom d’hôte du serveur principal.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--path

Chemin d’accès qui préfixe toutes les requêtes HTTP.

--probe

Nom ou ID de la sonde à associer aux paramètres HTTP.

--protocol

Protocole utilisé pour communiquer avec le back-end.

Propriété Valeur
Valeur par défaut: Http
Valeurs acceptées: Http, Https, Tcp, Tls
--root-certs

Liste séparée par l’espace des certificats racines approuvés (noms et ID) à associer aux paramètres HTTP. --host-name ou --host-name-from-backend-pool est nécessaire lorsque ce champ est défini. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--sni-name

Spécifiez une valeur SNI qui corresponde au nom commun du certificat sur le backend. Par défaut, la passerelle d’application utilise l’en-tête d’hôte de la demande entrante en tant que SNI. La valeur par défaut est Null.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--timeout

Délai d’expiration de la demande en secondes.

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

Vérifiez ou ignorez les validations en chaîne et d’expiration du certificat sur le serveur principal. La valeur par défaut est true.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: True
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--validate-sni

Lorsqu’il est activé, vérifie si le nom commun du certificat fourni par le serveur principal correspond à la valeur SNI (Server Name Indication). La valeur par défaut est true.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeur par défaut: True
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az network application-gateway http-settings delete

Modifier

Supprimez les paramètres 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}]

Exemples

Supprimez les paramètres HTTP.

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

Paramètres obligatoires

--gateway-name

Nom de la passerelle d’application.

--name -n

Nom des paramètres http du back-end.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az network application-gateway http-settings list

Modifier

Répertorier les paramètres HTTP.

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

Exemples

Répertorier les paramètres HTTP.

az network application-gateway http-settings list -g MyResourceGroup --gateway-name MyAppGateway

Paramètres obligatoires

--gateway-name

Nom de la passerelle d’application.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az network application-gateway http-settings show

Modifier

Obtenez les détails des paramètres HTTP.

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

Exemples

Obtenez les détails des paramètres HTTP.

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

Paramètres obligatoires

--gateway-name

Nom de la passerelle d’application.

--name -n

Nom des paramètres http du back-end.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az network application-gateway http-settings update

Modifier

Mettez à jour les paramètres 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}]

Exemples

Mettez à jour les paramètres HTTP pour utiliser une nouvelle sonde.

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

Paramètres obligatoires

--gateway-name

Nom de la passerelle d’application.

--name -n

Nom des paramètres http du back-end.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--affinity-cookie-name

Nom utilisé pour le cookie d’affinité.

--auth-certs

Liste séparée par l’espace des certificats d’authentification (noms et ID) à associer aux paramètres HTTP. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--connection-draining-timeout

Durée en secondes après la suppression d’un serveur principal pendant laquelle la connexion ouverte reste active. Plage comprise entre 0 (Désactivé) et 3600.

--cookie-based-affinity

Activez ou désactivez l’affinité basée sur les cookies.

Propriété Valeur
Valeurs acceptées: Disabled, Enabled
--dedicated-backend-connection --dedicated-connection

Activez ou désactivez la connexion dédiée par serveur principal. La valeur par défaut est false.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--enable-probe

Indique si la sonde est activée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--host-name

En-tête de l’hôte envoyé aux serveurs principaux.

--host-name-from-backend-pool

Indique s’il faut choisir l’en-tête de l’hôte à partir du nom d’hôte du serveur principal.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--path

Chemin d’accès qui préfixe toutes les requêtes HTTP.

--port

Numéro du port de destination sur le serveur principal.

--probe

Nom ou ID de la sonde à associer aux paramètres HTTP.

--protocol

Protocole utilisé pour communiquer avec le back-end.

Propriété Valeur
Valeurs acceptées: Http, Https, Tcp, Tls
--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--root-certs

Liste séparée par l’espace des certificats racines approuvés (noms et ID) à associer aux paramètres HTTP. --host-name ou --host-name-from-backend-pool est nécessaire lorsque ce champ est défini. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

Propriété Valeur
Groupe de paramètres: Generic Update Arguments
--sni-name

Spécifiez une valeur SNI qui corresponde au nom commun du certificat sur le backend. Par défaut, la passerelle d’application utilise l’en-tête d’hôte de la demande entrante en tant que SNI. La valeur par défaut est Null.

Propriété Valeur
Groupe de paramètres: Properties Arguments
--timeout

Délai d’expiration de la demande en secondes.

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

Vérifiez ou ignorez les validations en chaîne et d’expiration du certificat sur le serveur principal. La valeur par défaut est true.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--validate-sni

Lorsqu’il est activé, vérifie si le nom commun du certificat fourni par le serveur principal correspond à la valeur SNI (Server Name Indication). La valeur par défaut est true.

Propriété Valeur
Groupe de paramètres: Properties Arguments
Valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az network application-gateway http-settings wait

Modifier

Placez l’interface CLI dans un état d’attente jusqu’à ce qu’une condition soit remplie.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
--deleted

Attendez la suppression.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--exists

Attendez que la ressource existe.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
--gateway-name

Nom de la passerelle d’application.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--interval

Intervalle d’interrogation en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 30
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--timeout

Délai maximal d’attente en secondes.

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Propriété Valeur
Groupe de paramètres: Wait Condition Arguments
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False