az network front-door routing-rule

Note

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

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

Commandes

Nom	Description	Type	État
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 à l’aide de 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.

Propriété	Valeur
Groupe de paramètres:	Routing Rule Arguments
Valeurs acceptées:	Forward, Redirect

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.

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

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--cache-duration

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

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--caching

Indique s’il faut activer la mise en cache pour cet itinéraire.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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 vide pour utiliser le chemin entrant.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--custom-fragment

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--custom-host

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--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 <key>=<value>. La première ? et & seront ajoutés automatiquement afin de ne pas les inclure dans le front, mais de séparer plusieurs chaînes de requête avec &.

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--disabled

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

Propriété	Valeur
Valeurs acceptées:	false, true

--dynamic-compression

Utilisez la compression dynamique pour le contenu mis en cache.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
Valeurs acceptées:	Disabled, Enabled

--forwarding-protocol

Protocole à utiliser pour transférer le trafic.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--redirect-protocol

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments
Valeur par défaut:	MatchRequest
Valeurs acceptées:	HttpOnly, HttpsOnly, MatchRequest

--redirect-type

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments
Valeur par défaut:	Moved
Valeurs acceptées:	Found, Moved, PermanentRedirect, TemporaryRedirect

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

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

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--cache-duration

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

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--caching

Indique s’il faut activer la mise en cache pour cet itinéraire.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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 vide pour utiliser le chemin entrant.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--custom-fragment

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--custom-host

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--custom-query-string

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments

--dynamic-compression

Utilisez la compression dynamique pour le contenu mis en cache.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
Valeurs acceptées:	Disabled, Enabled

--enabled

État activé.

Propriété	Valeur
Groupe de paramètres:	Probe Setting Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	False

--forwarding-protocol

Protocole à utiliser pour transférer le trafic.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Forward Routing Rule Arguments

--redirect-protocol

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments
Valeurs acceptées:	HttpOnly, HttpsOnly, MatchRequest

--redirect-type

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

Propriété	Valeur
Groupe de paramètres:	Redirect Routing Rule Arguments
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.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
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>.

Propriété	Valeur
Groupe de paramètres:	Generic Update Arguments
Valeur par défaut:	[]

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

Commentaires

Cette page a-t-elle été utile ?

Partager via

az network front-door routing-rule

Commandes

az network front-door routing-rule create

Paramètres obligatoires

Paramètres facultatifs

az network front-door routing-rule delete

Paramètres obligatoires

az network front-door routing-rule list

Paramètres obligatoires

az network front-door routing-rule show

Paramètres obligatoires

az network front-door routing-rule update

Paramètres obligatoires

Paramètres facultatifs

Commentaires