Partager via

az network front-door routing-rule

  • Référence

Remarque

Cette référence fait partie de l’extension front-door pour Azure CLI (version 2.57.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az network front-door routing-rule . En savoir plus sur les extensions.

Gérer les règles de routage Front Door.

Commandes

Nom Description Type Statut
az network front-door routing-rule create

Créez une règle de routage Front Door.

 Extension GA
az network front-door routing-rule delete

Supprimez une règle de routage Front Door.

 Extension GA
az network front-door routing-rule list

Répertorier les règles de routage Front Door.

 Extension GA
az network front-door routing-rule show

Obtenez les détails d’une règle de routage Front Door.

 Extension GA
az network front-door routing-rule update

Mettez à jour une règle de routage Front Door.

 Extension GA

az network front-door routing-rule create

Créez une règle de routage Front Door.

Créez une règle de routage Front Door pour transférer les requêtes vers un back-end ou rediriger les utilisateurs vers une AUTRE URL.

Exemple 1 : az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Forward --backend-pool DefaultBackendPool -n forwardRoutingrule1 --patterns /forward1

Exemple 2 : az network front-door routing-rule create -f frontdoor1 -g rg1 --frontend-endpoints DefaultFrontendEndpoint --route-type Redirect --custom-host redirecthost.com -n redirectRouteRule1 --patterns /redirect1 --custom-query-string querystring.

az network front-door routing-rule create --front-door-name
                                          --frontend-endpoints
                                          --name
                                          --resource-group
                                          --route-type {Forward, Redirect}
                                          [--accepted-protocols]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--disabled {false, true}]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--rules-engine]

Paramètres obligatoires

--front-door-name -f

Nom de la porte d’entrée.

--frontend-endpoints

Liste séparée par l’espace des noms ou ID de point de terminaison front-end.

--name -n

Nom de la règle de routage.

--resource-group -g

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

--route-type

Type de routage pour définir la façon dont Front Door doit gérer les demandes de cette route, c’est-à-dire les transférer vers un back-end ou rediriger les utilisateurs vers une AUTRE URL.

valeurs acceptées: Forward, Redirect

Paramètres facultatifs

--accepted-protocols

Liste de protocoles séparés par l’espace à accepter. Valeur par défaut : Http.

--backend-pool

Nom ou ID d’un pool principal. Il est nécessaire de créer une règle de routage avant.

--cache-duration

Durée pendant laquelle le contenu doit être mis en cache. Le format autorisé est la durée ISO 8601.

--caching

Indique s’il faut activer la mise en cache pour cette route.

valeurs acceptées: Disabled, Enabled
--custom-forwarding-path

Chemin d’accès personnalisé utilisé pour réécrire les chemins de ressources mis en correspondance par cette règle. Laissez cette option vide pour utiliser le chemin entrant.

--custom-fragment

Fragment à ajouter à l’URL de redirection. Le fragment fait partie de l’URL qui vient après #. N’incluez pas le #.

--custom-host

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 chemin de destination.

--custom-query-string

Ensemble de chaînes de requête à placer dans l’URL de redirection. La définition de cette valeur remplace toute chaîne de requête existante ; laissez vide pour conserver la chaîne de requête entrante. La chaîne de requête doit être au format = . La première ? et &sera ajouté automatiquement afin de ne pas les inclure dans le front, mais séparez plusieurs chaînes de requête avec &.

--disabled

Créez dans un état désactivé.

valeurs acceptées: false, true
--dynamic-compression

Utilisez la compression dynamique pour le contenu mis en cache.

valeurs acceptées: Disabled, Enabled
--forwarding-protocol

Protocole à utiliser pour transférer le trafic.

valeurs acceptées: HttpOnly, HttpsOnly, MatchRequest
--patterns

Liste séparée par l’espace des modèles à mettre en correspondance. Valeur par défaut : '/*'.

--query-parameter-strip-directive

Traitement des termes de requête d’URL lors de la formation de la clé de cache.

valeurs acceptées: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Paramètres de requête à inclure ou exclure (séparés par des virgules) lors de l’utilisation respectivement du type strip-strip-directive StripAllExcept ou StripOnly.

--redirect-protocol

Protocole de la destination vers laquelle le trafic est redirigé.

valeurs acceptées: HttpOnly, HttpsOnly, MatchRequest
valeur par défaut: MatchRequest
--redirect-type

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

valeurs acceptées: Found, Moved, PermanentRedirect, TemporaryRedirect
valeur par défaut: Moved
--rules-engine

Nom ou ID d’une configuration du moteur de règles. Pour dissocier la propriété, « --remove rulesEngine ».

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 network front-door routing-rule delete

Supprimez une règle de routage Front Door.

az network front-door routing-rule delete --front-door-name
                                          --name
                                          --resource-group

Paramètres obligatoires

--front-door-name -f

Nom de la porte d’entrée.

--name -n

Nom de la règle de routage.

--resource-group -g

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

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 network front-door routing-rule list

Répertorier les règles de routage Front Door.

az network front-door routing-rule list --front-door-name
                                        --resource-group

Paramètres obligatoires

--front-door-name -f

Nom de la porte d’entrée.

--resource-group -g

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

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 network front-door routing-rule show

Obtenez les détails d’une règle de routage Front Door.

az network front-door routing-rule show --front-door-name
                                        --name
                                        --resource-group

Paramètres obligatoires

--front-door-name -f

Nom de la porte d’entrée.

--name -n

Nom de la règle de routage.

--resource-group -g

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

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 network front-door routing-rule update

Mettez à jour une règle de routage Front Door.

az network front-door routing-rule update --front-door-name
                                          --name
                                          --resource-group
                                          [--accepted-protocols]
                                          [--add]
                                          [--backend-pool]
                                          [--cache-duration]
                                          [--caching {Disabled, Enabled}]
                                          [--custom-forwarding-path]
                                          [--custom-fragment]
                                          [--custom-host]
                                          [--custom-path]
                                          [--custom-query-string]
                                          [--dynamic-compression {Disabled, Enabled}]
                                          [--enabled {Disabled, Enabled}]
                                          [--force-string]
                                          [--forwarding-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--frontend-endpoints]
                                          [--patterns]
                                          [--query-parameter-strip-directive {StripAll, StripAllExcept, StripNone, StripOnly}]
                                          [--query-parameters]
                                          [--redirect-protocol {HttpOnly, HttpsOnly, MatchRequest}]
                                          [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                                          [--remove]
                                          [--rules-engine]
                                          [--set]

Paramètres obligatoires

--front-door-name -f

Nom de la porte d’entrée.

--name -n

Nom de la règle de routage.

--resource-group -g

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

Paramètres facultatifs

--accepted-protocols

Liste de protocoles séparés par l’espace à accepter. Valeur par défaut : Http.

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

valeur par défaut: []
--backend-pool

Nom ou ID d’un pool principal. Il est nécessaire de créer une règle de routage avant.

--cache-duration

Durée pendant laquelle le contenu doit être mis en cache. Le format autorisé est la durée ISO 8601.

--caching

Indique s’il faut activer la mise en cache pour cette route.

valeurs acceptées: Disabled, Enabled
--custom-forwarding-path

Chemin d’accès personnalisé utilisé pour réécrire les chemins de ressources mis en correspondance par cette règle. Laissez cette option vide pour utiliser le chemin entrant.

--custom-fragment

Fragment à ajouter à l’URL de redirection. Le fragment fait partie de l’URL qui vient après #. N’incluez pas le #.

--custom-host

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 chemin de destination.

--custom-query-string

Ensemble de chaînes de requête à placer dans l’URL de redirection. La définition de cette valeur remplace toute chaîne de requête existante ; laissez vide pour conserver la chaîne de requête entrante. La chaîne de requête doit être au format = . La première ? et &sera ajouté automatiquement afin de ne pas les inclure dans le front, mais séparez plusieurs chaînes de requête avec &.

--dynamic-compression

Utilisez la compression dynamique pour le contenu mis en cache.

valeurs acceptées: Disabled, Enabled
--enabled

État activé.

valeurs acceptées: Disabled, Enabled
--force-string

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

valeur par défaut: False
--forwarding-protocol

Protocole à utiliser pour transférer le trafic.

valeurs acceptées: HttpOnly, HttpsOnly, MatchRequest
--frontend-endpoints

Liste séparée par l’espace des noms ou ID de point de terminaison front-end.

--patterns

Liste séparée par l’espace des modèles à mettre en correspondance. Valeur par défaut : '/*'.

--query-parameter-strip-directive

Traitement des termes de requête d’URL lors de la formation de la clé de cache.

valeurs acceptées: StripAll, StripAllExcept, StripNone, StripOnly
--query-parameters

Paramètres de requête à inclure ou exclure (séparés par des virgules) lors de l’utilisation respectivement du type strip-strip-directive StripAllExcept ou StripOnly.

--redirect-protocol

Protocole de la destination vers laquelle le trafic est redirigé.

valeurs acceptées: HttpOnly, HttpsOnly, MatchRequest
--redirect-type

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

valeurs acceptées: Found, Moved, PermanentRedirect, TemporaryRedirect
--remove

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

valeur par défaut: []
--rules-engine

Nom ou ID d’une configuration du moteur de règles. Pour dissocier la propriété, « --remove rulesEngine ».

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

valeur par défaut: []
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.