Partage via


az cdn endpoint rule

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Gérer les règles de remise d’un point de terminaison.

Commandes

Nom Description Type État
az cdn endpoint rule action

Gérer les actions de règle de remise pour un point de terminaison.

Core Preview
az cdn endpoint rule action add

Ajoutez une action à une règle de remise.

Core Preview
az cdn endpoint rule action remove

Supprimez une action d’une règle de remise.

Core Preview
az cdn endpoint rule action show

Afficher les règles de remise asscocier avec le point de terminaison.

Core Preview
az cdn endpoint rule add

Ajoutez une règle de remise à un point de terminaison CDN.

Core Preview
az cdn endpoint rule condition

Gérer les conditions de règle de remise d’un point de terminaison.

Core Preview
az cdn endpoint rule condition add

Ajoutez une condition à une règle de remise.

Core Preview
az cdn endpoint rule condition remove

Supprimez une condition d’une règle de remise.

Core Preview
az cdn endpoint rule condition show

Afficher les règles de remise associées au point de terminaison.

Core Preview
az cdn endpoint rule remove

Supprimez une règle de remise d’un point de terminaison.

Core Preview
az cdn endpoint rule show

Afficher les règles de remise associées au point de terminaison.

Core Preview

az cdn endpoint rule add

Préversion

Le groupe de commandes « cdn endpoint rule » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Ajoutez une règle de remise à un point de terminaison CDN.

az cdn endpoint rule add --action-name {CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite}
                         --order
                         [--cache-behavior {BypassCache, Override, SetIfMissing}]
                         [--cache-duration]
                         [--custom-fragment]
                         [--custom-hostname]
                         [--custom-path]
                         [--custom-querystring]
                         [--destination]
                         [--header-action {Append, Delete, Overwrite}]
                         [--header-name]
                         [--header-value]
                         [--ids]
                         [--match-values]
                         [--match-variable {ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath}]
                         [--name]
                         [--negate-condition {false, true}]
                         [--operator]
                         [--origin-group]
                         [--preserve-unmatched-path {false, true}]
                         [--profile-name]
                         [--query-parameters]
                         [--query-string-behavior {Exclude, ExcludeAll, Include, IncludeAll}]
                         [--redirect-protocol {Http, Https, MatchRequest}]
                         [--redirect-type {Found, Moved, PermanentRedirect, TemporaryRedirect}]
                         [--resource-group]
                         [--rule-name]
                         [--selector]
                         [--source-pattern]
                         [--subscription]
                         [--transform {Lowercase, Uppercase}]

Exemples

Créez une règle globale pour désactiver la mise en cache.

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 0 --rule-name global --action-name CacheExpiration --cache-behavior BypassCache

Créez une règle pour la redirection http vers https.

az cdn endpoint rule add -g group -n endpoint --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

Créez une règle pour distribuer des demandes avec « /test1 » dans son chemin d’URL vers le groupe d’origine avec le nom « origingroup1 ».

az cdn endpoint rule add -g group -n endpoint --profile-name profile --order 1 --rule-name "origin-group-override" --match-variable UrlPath --operator Contains --match-values /test1 --action-name "OriginGroupOverride" --origin-group origingroup1

Paramètres obligatoires

--action-name

Nom de l’action pour la règle de remise : https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-actions.

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: CacheExpiration, CacheKeyQueryString, ModifyRequestHeader, ModifyResponseHeader, OriginGroupOverride, UrlRedirect, UrlRewrite
--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.

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cache-behavior

Comportement de mise en cache pour les requêtes.

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: BypassCache, Override, SetIfMissing
--cache-duration

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

Propriété Valeur
Parameter group: Action Arguments
--custom-fragment

Fragment à ajouter à l’URL de redirection.

Propriété Valeur
Parameter group: Action Arguments
--custom-hostname

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

Propriété Valeur
Parameter group: Action 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
Parameter group: Action Arguments
--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.

Propriété Valeur
Parameter group: Action Arguments
--destination

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

Propriété Valeur
Parameter group: Action Arguments
--header-action

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

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: Append, Delete, Overwrite
--header-name

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

Propriété Valeur
Parameter group: Action Arguments
--header-value

Valeur de l’en-tête.

Propriété Valeur
Parameter group: Action 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
Parameter group: Resource Id Arguments
--match-values

Valeurs de correspondance de la condition de correspondance. Par exemple, les valeurs séparées par l’espace « GET » « HTTP ».

Propriété Valeur
Parameter group: Match Condition Arguments
--match-variable

Nom de la condition de correspondance : https://learn.microsoft.com/en-us/azure/cdn/cdn-standard-rules-engine-match-conditions.

Propriété Valeur
Parameter group: Match Condition Arguments
Valeurs acceptées: ClientPort, Cookies, HostName, HttpVersion, IsDevice, PostArgs, QueryString, RemoteAddress, RequestBody, RequestHeader, RequestMethod, RequestScheme, RequestUri, ServerPort, SocketAddr, SslProtocol, UrlFileExtension, UrlFileName, UrlPath
--name -n

Nom du point de terminaison CDN.

Propriété Valeur
Parameter group: Resource Id Arguments
--negate-condition

Si la valeur est true, annule la condition.

Propriété Valeur
Parameter group: Match Condition Arguments
Valeurs acceptées: false, true
--operator

Opérateur de la condition de correspondance.

Propriété Valeur
Parameter group: Match Condition Arguments
--origin-group

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

Propriété Valeur
Parameter group: Action Arguments
--preserve-unmatched-path

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

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: false, true
--profile-name

Nom du profil CDN qui est unique dans le groupe de ressources.

Propriété Valeur
Parameter group: Resource Id Arguments
--query-parameters

Paramètres de requête à inclure ou exclure (virgule séparées).

Propriété Valeur
Parameter group: Action Arguments
--query-string-behavior

Comportement de chaîne de requête pour les requêtes.

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: Exclude, ExcludeAll, Include, IncludeAll
--redirect-protocol

Protocole à utiliser pour la redirection.

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: Http, Https, MatchRequest
--redirect-type

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

Propriété Valeur
Parameter group: Action Arguments
Valeurs acceptées: Found, Moved, PermanentRedirect, TemporaryRedirect
--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
Parameter group: Resource Id Arguments
--rule-name

Nom de la règle, obligatoire uniquement pour la référence SKU Microsoft.

--selector

Sélecteur de la condition de correspondance.

Propriété Valeur
Parameter group: Match Condition Arguments
--source-pattern

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

Propriété Valeur
Parameter group: Action 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
Parameter group: Resource Id Arguments
--transform

Transformation à appliquer avant la mise en correspondance.

Propriété Valeur
Parameter group: Match Condition Arguments
Valeurs acceptées: Lowercase, Uppercase
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

Output format.

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

az cdn endpoint rule remove

Préversion

Le groupe de commandes « cdn endpoint rule » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Supprimez une règle de remise d’un point de terminaison.

az cdn endpoint rule remove [--ids]
                            [--name]
                            [--order]
                            [--profile-name]
                            [--resource-group]
                            [--rule-name]
                            [--subscription]

Exemples

Supprimez la règle globale.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --rule-name Global

Supprimez la règle avec l’ordre 4.

az cdn endpoint rule remove -g group -n endpoint --profile-name profile --order 4

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group: Resource Id Arguments
--name -n

Nom du point de terminaison CDN.

Propriété Valeur
Parameter group: Resource Id Arguments
--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.

--profile-name

Nom du profil CDN qui est unique dans le groupe de ressources.

Propriété Valeur
Parameter group: Resource Id Arguments
--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
Parameter group: Resource Id Arguments
--rule-name

Nom de la règle.

--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
Parameter group: Resource Id Arguments
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

Output format.

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

az cdn endpoint rule show

Préversion

Le groupe de commandes « cdn endpoint rule » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Afficher les règles de remise associées au point de terminaison.

az cdn endpoint rule show [--ids]
                          [--name]
                          [--profile-name]
                          [--resource-group]
                          [--subscription]

Exemples

afficher les règles de remise associées au point de terminaison.

az cdn endpoint rule show -g group -n endpoint --profile-name profile

Paramètres facultatifs

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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
Parameter group: Resource Id Arguments
--name -n

Nom du point de terminaison CDN.

Propriété Valeur
Parameter group: Resource Id Arguments
--profile-name

Nom du profil CDN qui est unique dans le groupe de ressources.

Propriété Valeur
Parameter group: Resource Id Arguments
--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
Parameter group: 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
Parameter group: Resource Id Arguments
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

Output format.

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