az afd rule

  • Référence

Gérer les règles de remise dans l’ensemble de règles spécifié.

Commandes

Nom Description Type Statut
az afd rule action

Gérer les règles de remise dans l’ensemble de règles spécifié.

 Core GA
az afd rule action add

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule action list

Obtenir une règle de remise existante dans un ensemble de règles.

 Core GA
az afd rule action remove

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule condition

Gérer les règles de remise dans l’ensemble de règles spécifié.

 Core GA
az afd rule condition add

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule condition list

Obtenir une règle de remise existante dans un ensemble de règles.

 Core GA
az afd rule condition remove

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule create

Créez une règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule delete

Supprimez une règle de remise existante dans un ensemble de règles.

 Core GA
az afd rule list

Répertorier toutes les règles de remise existantes dans un ensemble de règles.

 Core GA
az afd rule show

Obtenir une règle de remise existante dans un ensemble de règles.

 Core GA
az afd rule update

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

 Core GA
az afd rule wait

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

 Core GA

az afd rule create

Créez une règle de remise dans le jeu de règles spécifié.

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]

Exemples

Créez une règle pour ajouter un en-tête de réponse pour les demandes de Thaïlande.

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

Créer une règle pour la redirection http vers 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

Paramètres obligatoires

--name --rule-name -n

Nom de la règle de remise unique dans le point de terminaison.

--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

Paramètres facultatifs

--action-name

Nom de l’action pour la règle de remise : https://docs.microsoft.com/en-us/azure/frontdoor/front-door-rules-engine-actions.

--cache-behavior

Comportement de mise en cache pour les requêtes.

--cache-duration

Durée pendant laquelle le contenu doit être mis en cache. Le format autorisé est [d.]hh :mm :ss.

--custom-fragment

Fragment à ajouter à l’URL de redirection.

--custom-hostname

Hôte à rediriger. Laissez vide pour utiliser l’hôte entrant comme hôte de destination.

--custom-path

Chemin complet à rediriger. Le chemin d’accès ne peut pas être vide et doit commencer par /. Laissez vide pour utiliser le chemin entrant comme pat de destination.

--custom-querystring

Ensemble de chaînes de requête à placer dans l’URL de redirection.laissez vide pour conserver la chaîne de requête entrante.

--destination

Chemin d’accès de destination à utiliser dans la réécriture.

--enable-caching

Indique s’il faut activer la mise en cache sur l’itinéraire.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--enable-compression

Indique si la compression de contenu est activée sur AzureFrontDoor. La valeur par défaut est false. Si la compression est activée, le contenu est servi comme compressé si l’utilisateur demande une version compressée. Le contenu ne sera pas compressé sur AzureFrontDoorwhen demandé contenu est inférieur à 1 octet ou supérieur à 1 Mo.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--forwarding-protocol

Protocole utilisé par cette règle pour transférer le trafic vers les back-ends.

--header-action

Action d’en-tête pour les demandes.

--header-name

Nom de l’en-tête à modifier.

--header-value

Valeur de l'en-tête.

--match-processing-behavior

Si cette règle est une correspondance, le moteur de règles continue à exécuter les règles restantes ou à arrêter. S’il n’est pas présent, la valeur par défaut est Continuer.

valeurs acceptées: Continue, Stop
valeur par défaut: Continue
--match-values

Valeurs de correspondance de la condition de correspondance. Par exemple, les valeurs séparées par l’espace « GET » « HTTP ». Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--match-variable

Nom de la condition de correspondance : https://docs.microsoft.com/en-us/azure/frontdoor/rules-match-conditions.

--negate-condition

Si la valeur est true, annule la condition.

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.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--operator

Opérateur de la condition de correspondance.

--order

Ordre dans lequel les règles sont appliquées pour le point de terminaison. Valeurs possibles {0,1,2,3,Ã>â'>Â>Ã>â'>Â>Ã>Ã>â’â'>Â>}. Une règle avec un ordre inférieur est appliquée avant une règle avec un ordre supérieur. La règle avec l’ordre 0 est une règle spéciale. Elle ne nécessite aucune condition et les actions répertoriées dans celle-ci seront toujours appliquées.

--origin-group

Nom ou ID du groupe d’origine qui remplacerait le groupe d’origine par défaut.

--preserve-unmatched-path

Si la valeur est True, le chemin restant après l’ajout du modèle source au nouveau chemin de destination.

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--query-parameters

Interroger les paramètres à inclure ou exclure. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--query-string-caching-behavior

Définit la façon dont CDN met en cache les requêtes qui incluent des chaînes de requête. Vous pouvez ignorer toutes les chaînes de requête lors de la mise en cache, contourner la mise en cache pour empêcher les requêtes qui contiennent des chaînes de requête d’être mises en cache ou mettre en cache chaque requête avec une URL unique.

--redirect-protocol

Protocole à utiliser pour la redirection.

--redirect-type

Type de redirection utilisé par la règle lors de la redirection du trafic.

--selector

Sélecteur de la condition de correspondance.

--source-pattern

Modèle d’URI de requête qui identifie le type de requêtes qui peuvent être réécrites.

--transforms

Transformation à appliquer avant la mise en correspondance. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az afd rule delete

Supprimez une règle de remise existante dans un ensemble de règles.

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]

Exemples

Supprimez une règle portant le nom rule1.

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name --rule-name -n

Nom de la règle de remise unique dans le point de terminaison.

--no-wait

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

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

--subscription

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

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az afd rule list

Répertorier toutes les règles de remise existantes dans un ensemble de règles.

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

Exemples

Répertorier tous les itinéraires dans le point de terminaison spécifié.

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

Paramètres obligatoires

--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

Paramètres facultatifs

--max-items

Nombre total d’éléments à retourner dans la sortie de la commande. Si le nombre total d’éléments disponibles est supérieur à la valeur spécifiée, un jeton est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur du jeton dans --next-token l’argument d’une commande suivante.

--next-token

Jeton pour spécifier où commencer la pagination. Il s’agit de la valeur du jeton d’une réponse tronquée précédemment.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az afd rule show

Obtenir une règle de remise existante dans un ensemble de règles.

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

Exemples

affichez les détails de la règle de remise avec la règle de nom1.

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

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--name --rule-name -n

Nom de la règle de remise unique dans le point de terminaison.

--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az afd rule update

Mettez à jour une nouvelle règle de remise dans le jeu de règles spécifié.

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]

Paramètres facultatifs

--actions

Liste des actions exécutées lorsque toutes les conditions d’une règle sont satisfaites. Prendre en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

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

--conditions

Liste des conditions qui doivent être mises en correspondance pour que les actions soient exécutées Prennent en charge la syntaxe abrégée, json-file et yaml-file. Essayez « ?? » pour en montrer plus.

--force-string

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

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--match-processing-behavior

Si cette règle est une correspondance, le moteur de règles continue à exécuter les règles restantes ou à arrêter. S’il n’est pas présent, la valeur par défaut est Continuer.

valeurs acceptées: Continue, Stop
--name --rule-name -n

Nom de la règle de remise unique dans le point de terminaison.

--no-wait

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

valeurs acceptées: 0, 1, f, false, n, no, t, true, y, yes
--order

Ordre dans lequel les règles sont appliquées pour le point de terminaison. Valeurs possibles {0,1,2,3,ÃÂÒâƒÆ’Ò҃ÂƑâ¢Ã¢ŠÂ>Ã... ƒ‚ÒâƒÆ’ÒÃƑâƒâ€šÃ’ƒƒÃÆ') ƒÂÒâ>ÃÒÂƑÂƑÂF¢¢ŠÂ>Ã... ƒ‚ÒâƒÆ’ÒÃƑâƒâ€šÃ’ƒƒÃÆ') ƒÂÒâ>ÃÒÂƑÂƑÂF¢¢ŠÂ>Ã... Â>Âã’â>Ãâéâ’Å>Âã’Â>}. Une règle avec un ordre inférieur est appliquée avant une règle avec un ordre supérieur. La règle avec l’ordre 0 est une règle spéciale. Elle ne nécessite aucune condition et les actions répertoriées dans celle-ci seront toujours appliquées.

--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--remove

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

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

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

--subscription

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az afd rule wait

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

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

Paramètres facultatifs

--created

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

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

--deleted

Attendez la suppression.

valeur par défaut: False
--exists

Attendez que la ressource existe.

valeur par défaut: False
--ids

Un ou plusieurs ID de ressource (délimités par des espaces). 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 ».

--interval

Intervalle d’interrogation en secondes.

valeur par défaut: 30
--name --rule-name -n

Nom de la règle de remise unique dans le point de terminaison.

--profile-name

Nom du profil Azure Front Door Standard ou Azure Front Door Premium qui est unique dans le groupe de ressources.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--rule-set-name

Nom de l’ensemble de règles sous le profil.

--subscription

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

--timeout

Délai maximal d’attente en secondes.

valeur par défaut: 3600
--updated

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

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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