Rules - Update
Met à jour une règle de remise existante dans un ensemble de règles.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}?api-version=2025-04-15
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
profile
|
path | True |
string minLength: 1maxLength: 260 pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$ |
Nom d’Azure Front Door Standard ou d’Azure Front Door Premium qui est unique dans le groupe de ressources. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
rule
|
path | True |
string |
Nom de la règle de remise unique dans le point de terminaison. |
rule
|
path | True |
string |
Nom de l’ensemble de règles sous le profil. |
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Type | Description |
---|---|---|
properties.actions | DeliveryRuleAction[]: |
Liste des actions exécutées lorsque toutes les conditions d’une règle sont satisfaites. |
properties.conditions |
DeliveryRuleCondition[]:
|
Liste des conditions qui doivent être mises en correspondance pour que les actions soient exécutées |
properties.matchProcessingBehavior |
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. |
|
properties.order |
integer (int32) |
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. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Ok |
|
202 Accepted |
Accepté. La demande a été acceptée pour le traitement et l’opération se termine de manière asynchrone. En-têtes location: string |
|
Other Status Codes |
Réponse d’erreur Azure Front Door décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Rules_Update
Exemple de requête
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1/rules/rule1?api-version=2025-04-15
{
"properties": {
"order": 1,
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
]
}
}
Exemple de réponse
{
"name": "rule1",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/rulesets/ruleSet1/rules/rule1",
"type": "Microsoft.Cdn/profiles/rulesets/rules",
"properties": {
"order": 1,
"conditions": [
{
"name": "RequestMethod",
"parameters": {
"typeName": "DeliveryRuleRequestMethodConditionParameters",
"operator": "Equal",
"matchValues": [
"GET"
],
"negateCondition": false,
"transforms": []
}
}
],
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
],
"matchProcessingBehavior": "Continue",
"provisioningState": "Succeeded",
"deploymentStatus": "NotStarted"
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2025-04-15
{
"name": "rule1",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/rulesets/ruleSet1/rules/rule1",
"type": "Microsoft.Cdn/profiles/rulesets/rules",
"properties": {
"order": 1,
"conditions": [
{
"name": "RequestMethod",
"parameters": {
"typeName": "DeliveryRuleRequestMethodConditionParameters",
"operator": "Equal",
"matchValues": [
"GET"
],
"negateCondition": false,
"transforms": []
}
}
],
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
],
"matchProcessingBehavior": "Continue",
"provisioningState": "Updating",
"deploymentStatus": "NotStarted"
}
}
Définitions
Nom | Description |
---|---|
Afd |
État d’approvisionnement |
algorithm |
Algorithme à utiliser pour la signature d’URL |
cache |
Comportement de mise en cache pour les requêtes |
Cache |
Paramètres de mise en cache d’un itinéraire de type de mise en cache. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration. |
Cache |
Définit les paramètres de l’action d’expiration du cache. |
Cache |
Définit les paramètres de l’action de chaîne de requête de clé de cache. |
Cache |
Niveau auquel le contenu doit être mis en cache. |
Client |
Définit les paramètres des conditions de correspondance ClientPort |
Client |
Décrit l’opérateur à mettre en correspondance |
Cookies |
Définit les paramètres des conditions de correspondance cookies |
Cookies |
Décrit l’opérateur à mettre en correspondance |
created |
Type d’identité qui a créé la ressource. |
Delivery |
Définit l’action d’expiration du cache pour la règle de remise. |
Delivery |
Définit l’action de chaîne de requête de clé de cache pour la règle de remise. |
Delivery |
Définit la condition ClientPort pour la règle de remise. |
Delivery |
Définit la condition Cookies pour la règle de remise. |
Delivery |
Définit la condition HostName pour la règle de remise. |
Delivery |
Définit la condition HttpVersion pour la règle de remise. |
Delivery |
Définit la condition IsDevice pour la règle de remise. |
Delivery |
Définit la condition PostArgs pour la règle de remise. |
Delivery |
Définit la condition QueryString pour la règle de remise. |
Delivery |
Définit la condition RemoteAddress pour la règle de remise. |
Delivery |
Définit la condition RequestBody pour la règle de remise. |
Delivery |
Définit l’action d’en-tête de requête pour la règle de remise. |
Delivery |
Définit la condition RequestHeader pour la règle de remise. |
Delivery |
Définit la condition RequestMethod pour la règle de remise. |
Delivery |
Définit la condition RequestScheme pour la règle de remise. |
Delivery |
Définit la condition RequestUri pour la règle de remise. |
Delivery |
Définit l’action d’en-tête de réponse pour la règle de remise. |
Delivery |
Définit l’action de remplacement de la configuration de routage pour la règle de remise. Applicable uniquement aux profils Frontdoor Standard/Premium. |
Delivery |
Définit la condition ServerPort pour la règle de remise. |
Delivery |
Définit la condition SocketAddress pour la règle de remise. |
Delivery |
Définit la condition SslProtocol pour la règle de remise. |
Delivery |
Définit la condition UrlFileExtension pour la règle de remise. |
Delivery |
Définit la condition UrlFileName pour la règle de remise. |
Delivery |
Définit la condition UrlPath pour la règle de remise. |
Deployment |
|
Destination |
Protocole à utiliser pour la redirection. La valeur par défaut est MatchRequest |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
Error |
Réponse d’erreur |
Forwarding |
Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends. |
Header |
Action à effectuer |
Header |
Définit les paramètres de l’action d’en-tête de requête. |
Host |
Définit les paramètres des conditions de correspondance HostName |
Host |
Décrit l’opérateur à mettre en correspondance |
Http |
Définit les paramètres des conditions de correspondance HttpVersion |
Http |
Décrit l’opérateur à mettre en correspondance |
Is |
Définit les paramètres des conditions de correspondance IsDevice |
Is |
Valeur de correspondance pour la condition de la règle de remise |
Is |
Décrit l’opérateur à mettre en correspondance |
Match |
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. |
Origin |
Définit les paramètres de la configuration de remplacement du groupe d’origine. |
Origin |
Définit l’action de remplacement du groupe d’origine pour la règle de remise. |
Origin |
Définit les paramètres de l’action de remplacement du groupe d’origine. |
param |
Indique l’objectif du paramètre |
Post |
Définit les paramètres des conditions de correspondance PostArgs |
Post |
Décrit l’opérateur à mettre en correspondance |
query |
Comportement de mise en cache pour les requêtes |
Query |
Définit les paramètres des conditions de correspondance QueryString |
Query |
Décrit l’opérateur à mettre en correspondance |
Redirect |
Type de redirection utilisé par la règle lors de la redirection du trafic. |
Remote |
Définit les paramètres des conditions de correspondance RemoteAddress |
Remote |
Décrit l’opérateur à mettre en correspondance |
Request |
Définit les paramètres des conditions de correspondance RequestBody |
Request |
Décrit l’opérateur à mettre en correspondance |
Request |
Définit les paramètres des conditions de correspondance RequestHeader |
Request |
Décrit l’opérateur à mettre en correspondance |
Request |
Définit les paramètres des conditions de correspondance RequestMethod |
Request |
Valeur de correspondance pour la condition de la règle de remise |
Request |
Décrit l’opérateur à mettre en correspondance |
Request |
Définit les paramètres des conditions de correspondance RequestScheme |
Request |
Valeur de correspondance pour la condition de la règle de remise |
Request |
Définit les paramètres des conditions de correspondance RequestUri |
Request |
Décrit l’opérateur à mettre en correspondance |
Resource |
Référence à une autre ressource. |
Route |
Définit les paramètres de l’action de remplacement de configuration de routage. |
Rule |
Mappage de noms de règles conviviales aux informations liées aux règles ou aux secrets. |
rule |
Comportement de mise en cache pour les requêtes |
rule |
Indique si la compression de contenu est activée. 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 AzureFrontDoor lorsque le contenu demandé est inférieur à 1 octet ou supérieur à 1 Mo. |
rule |
Définit la façon dont Frontdoor 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, ignorer des chaînes de requête spécifiques, mettre en cache chaque requête avec une URL unique ou mettre en cache des chaînes de requête spécifiques. |
Rule |
Objet JSON de domaine requis pour la création ou la mise à jour du domaine. |
Server |
Définit les paramètres des conditions de correspondance ServerPort |
Server |
Décrit l’opérateur à mettre en correspondance |
Socket |
Définit les paramètres des conditions de correspondance SocketAddress |
Socket |
Décrit l’opérateur à mettre en correspondance |
Ssl |
Protocole d’une connexion TLS établie. |
Ssl |
Définit les paramètres des conditions de correspondance SslProtocol |
Ssl |
Décrit l’opérateur à mettre en correspondance |
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
transform |
Décrit les transformations appliquées avant la mise en correspondance |
Url |
Définit les paramètres des conditions de correspondance UrlFileExtension |
Url |
Décrit l’opérateur à mettre en correspondance |
Url |
Définit les paramètres des conditions de correspondance UrlFilename |
Url |
Décrit l’opérateur à mettre en correspondance |
Url |
Définit les paramètres des conditions de correspondance UrlPath |
Url |
Décrit l’opérateur à mettre en correspondance |
Url |
Définit l’action de redirection d’URL pour la règle de remise. |
Url |
Définit les paramètres de l’action de redirection d’URL. |
Url |
Définit l’action de réécriture d’URL pour la règle de remise. |
Url |
Définit les paramètres de l’action de réécriture d’URL. |
Url |
Définit l’action de signature d’URL pour la règle de remise. |
Url |
Définit les paramètres de l’action de signature d’URL. |
Url |
Définit comment identifier un paramètre à des fins spécifiques, par exemple expire |
AfdProvisioningState
État d’approvisionnement
Valeur | Description |
---|---|
Creating | |
Deleting | |
Failed | |
Succeeded | |
Updating |
algorithm
Algorithme à utiliser pour la signature d’URL
Valeur | Description |
---|---|
SHA256 |
cacheBehavior
Comportement de mise en cache pour les requêtes
Valeur | Description |
---|---|
BypassCache | |
Override | |
SetIfMissing |
CacheConfiguration
Paramètres de mise en cache d’un itinéraire de type de mise en cache. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration.
Nom | Type | Description |
---|---|---|
cacheBehavior |
Comportement de mise en cache pour les requêtes |
|
cacheDuration |
string |
Durée pendant laquelle le contenu doit être mis en cache. Le format autorisé est [d.]hh :mm :ss |
isCompressionEnabled |
Indique si la compression de contenu est activée. 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 AzureFrontDoor lorsque le contenu demandé est inférieur à 1 octet ou supérieur à 1 Mo. |
|
queryParameters |
string |
paramètres de requête à inclure ou exclure (virgule séparée). |
queryStringCachingBehavior |
Définit la façon dont Frontdoor 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, ignorer des chaînes de requête spécifiques, mettre en cache chaque requête avec une URL unique ou mettre en cache des chaînes de requête spécifiques. |
CacheExpirationActionParameters
Définit les paramètres de l’action d’expiration du cache.
Nom | Type | Description |
---|---|---|
cacheBehavior |
Comportement de mise en cache pour les requêtes |
|
cacheDuration |
string |
Durée pendant laquelle le contenu doit être mis en cache. Le format autorisé est [d.]hh :mm :ss |
cacheType |
Niveau auquel le contenu doit être mis en cache. |
|
typeName |
string:
Delivery |
CacheKeyQueryStringActionParameters
Définit les paramètres de l’action de chaîne de requête de clé de cache.
Nom | Type | Description |
---|---|---|
queryParameters |
string |
paramètres de requête à inclure ou exclure (virgule séparée). |
queryStringBehavior |
Comportement de mise en cache pour les requêtes |
|
typeName |
string:
Delivery |
CacheType
Niveau auquel le contenu doit être mis en cache.
Valeur | Description |
---|---|
All |
ClientPortMatchConditionParameters
Définit les paramètres des conditions de correspondance ClientPort
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
ClientPortOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
CookiesMatchConditionParameters
Définit les paramètres des conditions de correspondance cookies
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
selector |
string |
Nom des cookies à mettre en correspondance |
|
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
CookiesOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
createdByType
Type d’identité qui a créé la ressource.
Valeur | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DeliveryRuleCacheExpirationAction
Définit l’action d’expiration du cache pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Cache |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
DeliveryRuleCacheKeyQueryStringAction
Définit l’action de chaîne de requête de clé de cache pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Cache |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
DeliveryRuleClientPortCondition
Définit la condition ClientPort pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Client |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleCookiesCondition
Définit la condition Cookies pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Cookies |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleHostNameCondition
Définit la condition HostName pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Host |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleHttpVersionCondition
Définit la condition HttpVersion pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Http |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleIsDeviceCondition
Définit la condition IsDevice pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Is |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRulePostArgsCondition
Définit la condition PostArgs pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Post |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleQueryStringCondition
Définit la condition QueryString pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Query |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRemoteAddressCondition
Définit la condition RemoteAddress pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Remote |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRequestBodyCondition
Définit la condition RequestBody pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Request |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRequestHeaderAction
Définit l’action d’en-tête de requête pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Modify |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
DeliveryRuleRequestHeaderCondition
Définit la condition RequestHeader pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Request |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRequestMethodCondition
Définit la condition RequestMethod pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Request |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRequestSchemeCondition
Définit la condition RequestScheme pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Request |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleRequestUriCondition
Définit la condition RequestUri pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Request |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleResponseHeaderAction
Définit l’action d’en-tête de réponse pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Modify |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
DeliveryRuleRouteConfigurationOverrideAction
Définit l’action de remplacement de la configuration de routage pour la règle de remise. Applicable uniquement aux profils Frontdoor Standard/Premium.
Nom | Type | Description |
---|---|---|
name |
string:
Route |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
DeliveryRuleServerPortCondition
Définit la condition ServerPort pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Server |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleSocketAddrCondition
Définit la condition SocketAddress pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Socket |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleSslProtocolCondition
Définit la condition SslProtocol pour la règle de remise.
Nom | Type | Description |
---|---|---|
name | string: |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleUrlFileExtensionCondition
Définit la condition UrlFileExtension pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleUrlFileNameCondition
Définit la condition UrlFileName pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeliveryRuleUrlPathCondition
Définit la condition UrlPath pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de la condition de la règle de remise. |
parameters |
Définit les paramètres de la condition. |
DeploymentStatus
Valeur | Description |
---|---|
Failed | |
InProgress | |
NotStarted | |
Succeeded |
DestinationProtocol
Protocole à utiliser pour la redirection. La valeur par défaut est MatchRequest
Valeur | Description |
---|---|
Http | |
Https | |
MatchRequest |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
Nom | Type | Description |
---|---|---|
info |
object |
Informations supplémentaires. |
type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
ForwardingProtocol
Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.
Valeur | Description |
---|---|
HttpOnly | |
HttpsOnly | |
MatchRequest |
HeaderAction
Action à effectuer
Valeur | Description |
---|---|
Append | |
Delete | |
Overwrite |
HeaderActionParameters
Définit les paramètres de l’action d’en-tête de requête.
Nom | Type | Description |
---|---|---|
headerAction |
Action à effectuer |
|
headerName |
string |
Nom de l’en-tête à modifier |
typeName |
string:
Delivery |
|
value |
string |
Valeur de l’action spécifiée |
HostNameMatchConditionParameters
Définit les paramètres des conditions de correspondance HostName
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
HostNameOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
HttpVersionMatchConditionParameters
Définit les paramètres des conditions de correspondance HttpVersion
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
HttpVersionOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Equal |
IsDeviceMatchConditionParameters
Définit les paramètres des conditions de correspondance IsDevice
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
Valeur de correspondance pour la condition de la règle de remise |
||
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
IsDeviceMatchValue
Valeur de correspondance pour la condition de la règle de remise
Valeur | Description |
---|---|
Desktop | |
Mobile |
IsDeviceOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Equal |
MatchProcessingBehavior
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.
Valeur | Description |
---|---|
Continue | |
Stop |
OriginGroupOverride
Définit les paramètres de la configuration de remplacement du groupe d’origine.
Nom | Type | Description |
---|---|---|
forwardingProtocol |
Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends. |
|
originGroup |
définit le Groupe d’origine qui remplacerait DefaultOriginGroup sur l’itinéraire. |
OriginGroupOverrideAction
Définit l’action de remplacement du groupe d’origine pour la règle de remise.
Nom | Type | Description |
---|---|---|
name | string: |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
OriginGroupOverrideActionParameters
Définit les paramètres de l’action de remplacement du groupe d’origine.
Nom | Type | Description |
---|---|---|
originGroup |
définit le Groupe d’origine qui remplacerait DefaultOriginGroup. |
|
typeName |
string:
Delivery |
paramIndicator
Indique l’objectif du paramètre
Valeur | Description |
---|---|
Expires | |
KeyId | |
Signature |
PostArgsMatchConditionParameters
Définit les paramètres des conditions de correspondance PostArgs
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
selector |
string |
Nom de PostArg à mettre en correspondance |
|
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
PostArgsOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
queryStringBehavior
Comportement de mise en cache pour les requêtes
Valeur | Description |
---|---|
Exclude | |
ExcludeAll | |
Include | |
IncludeAll |
QueryStringMatchConditionParameters
Définit les paramètres des conditions de correspondance QueryString
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
QueryStringOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RedirectType
Type de redirection utilisé par la règle lors de la redirection du trafic.
Valeur | Description |
---|---|
Found | |
Moved | |
PermanentRedirect | |
TemporaryRedirect |
RemoteAddressMatchConditionParameters
Définit les paramètres des conditions de correspondance RemoteAddress
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Mettre en correspondance les valeurs à mettre en correspondance. L’opérateur s’applique à chaque valeur ici avec la sémantique OR. Si l’un d’eux correspond à la variable avec l’opérateur donné, cette condition de correspondance est considérée comme une correspondance. |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RemoteAddressOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
GeoMatch | |
IPMatch |
RequestBodyMatchConditionParameters
Définit les paramètres des conditions de correspondance RequestBody
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RequestBodyOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RequestHeaderMatchConditionParameters
Définit les paramètres des conditions de correspondance RequestHeader
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
selector |
string |
Nom de l’en-tête à mettre en correspondance |
|
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RequestHeaderOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RequestMethodMatchConditionParameters
Définit les paramètres des conditions de correspondance RequestMethod
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
Valeur de correspondance pour la condition de la règle de remise |
||
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RequestMethodMatchValue
Valeur de correspondance pour la condition de la règle de remise
Valeur | Description |
---|---|
DELETE | |
GET | |
HEAD | |
OPTIONS | |
POST | |
PUT | |
TRACE |
RequestMethodOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Equal |
RequestSchemeMatchConditionParameters
Définit les paramètres des conditions de correspondance RequestScheme
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
Valeur de correspondance pour la condition de la règle de remise |
||
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
enum:
Equal |
Décrit l’opérateur à mettre en correspondance |
|
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RequestSchemeMatchValue
Valeur de correspondance pour la condition de la règle de remise
Valeur | Description |
---|---|
HTTP | |
HTTPS |
RequestUriMatchConditionParameters
Définit les paramètres des conditions de correspondance RequestUri
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
RequestUriOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
ResourceReference
Référence à une autre ressource.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource. |
RouteConfigurationOverrideActionParameters
Définit les paramètres de l’action de remplacement de configuration de routage.
Nom | Type | Description |
---|---|---|
cacheConfiguration |
Configuration de mise en cache associée à cette règle. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration. |
|
originGroupOverride |
Référence à la configuration de remplacement du groupe d’origine. Laissez vide pour utiliser le groupe d’origines par défaut sur l’itinéraire. |
|
typeName |
string:
Delivery |
Rule
Mappage de noms de règles conviviales aux informations liées aux règles ou aux secrets.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
|
name |
string |
Nom de la ressource |
|
properties.actions | DeliveryRuleAction[]: |
Liste des actions exécutées lorsque toutes les conditions d’une règle sont satisfaites. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
Liste des conditions qui doivent être mises en correspondance pour que les actions soient exécutées |
|
properties.deploymentStatus | |||
properties.matchProcessingBehavior | Continue |
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. |
|
properties.order |
integer (int32) |
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. |
|
properties.provisioningState |
État d’approvisionnement |
||
properties.ruleSetName |
string |
Nom du jeu de règles contenant la règle. |
|
systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
||
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
ruleCacheBehavior
Comportement de mise en cache pour les requêtes
Valeur | Description |
---|---|
HonorOrigin | |
OverrideAlways | |
OverrideIfOriginMissing |
ruleIsCompressionEnabled
Indique si la compression de contenu est activée. 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 AzureFrontDoor lorsque le contenu demandé est inférieur à 1 octet ou supérieur à 1 Mo.
Valeur | Description |
---|---|
Disabled | |
Enabled |
ruleQueryStringCachingBehavior
Définit la façon dont Frontdoor 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, ignorer des chaînes de requête spécifiques, mettre en cache chaque requête avec une URL unique ou mettre en cache des chaînes de requête spécifiques.
Valeur | Description |
---|---|
IgnoreQueryString | |
IgnoreSpecifiedQueryStrings | |
IncludeSpecifiedQueryStrings | |
UseQueryString |
RuleUpdateParameters
Objet JSON de domaine requis pour la création ou la mise à jour du domaine.
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
properties.actions | DeliveryRuleAction[]: |
Liste des actions exécutées lorsque toutes les conditions d’une règle sont satisfaites. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
Liste des conditions qui doivent être mises en correspondance pour que les actions soient exécutées |
|
properties.matchProcessingBehavior | Continue |
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. |
|
properties.order |
integer (int32) |
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. |
|
properties.ruleSetName |
string |
Nom du jeu de règles contenant la règle. |
ServerPortMatchConditionParameters
Définit les paramètres des conditions de correspondance ServerPort
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
ServerPortOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
SocketAddrMatchConditionParameters
Définit les paramètres des conditions de correspondance SocketAddress
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
SocketAddrOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
IPMatch |
SslProtocol
Protocole d’une connexion TLS établie.
Valeur | Description |
---|---|
TLSv1 | |
TLSv1.1 | |
TLSv1.2 |
SslProtocolMatchConditionParameters
Définit les paramètres des conditions de correspondance SslProtocol
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
Valeur de correspondance pour la condition de la règle de remise |
||
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
SslProtocolOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Equal |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
Nom | Type | Description |
---|---|---|
createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
createdBy |
string |
Identité qui a créé la ressource. |
createdByType |
Type d’identité qui a créé la ressource. |
|
lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
transform
Décrit les transformations appliquées avant la mise en correspondance
Valeur | Description |
---|---|
Lowercase | |
RemoveNulls | |
Trim | |
Uppercase | |
UrlDecode | |
UrlEncode |
UrlFileExtensionMatchConditionParameters
Définit les paramètres des conditions de correspondance UrlFileExtension
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
UrlFileExtensionOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
UrlFileNameMatchConditionParameters
Définit les paramètres des conditions de correspondance UrlFilename
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
UrlFileNameOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
UrlPathMatchConditionParameters
Définit les paramètres des conditions de correspondance UrlPath
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
matchValues |
string[] |
Valeur de correspondance pour la condition de la règle de remise |
|
negateCondition |
boolean |
False |
Décrit s’il s’agit d’une condition de non-négation ou non |
operator |
Décrit l’opérateur à mettre en correspondance |
||
transforms |
Liste des transformations |
||
typeName |
string:
Delivery |
UrlPathOperator
Décrit l’opérateur à mettre en correspondance
Valeur | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx | |
Wildcard |
UrlRedirectAction
Définit l’action de redirection d’URL pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
UrlRedirectActionParameters
Définit les paramètres de l’action de redirection d’URL.
Nom | Type | Description |
---|---|---|
customFragment |
string |
Fragment à ajouter à l’URL de redirection. Le fragment fait partie de l’URL qui vient après #. N’incluez pas le #. |
customHostname |
string |
Hôte à rediriger. Laissez vide pour utiliser l’hôte entrant comme hôte de destination. |
customPath |
string |
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. |
customQueryString |
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 = . ? et & seront ajoutés automatiquement afin de ne pas les inclure. |
destinationProtocol |
Protocole à utiliser pour la redirection. La valeur par défaut est MatchRequest |
|
redirectType |
Type de redirection utilisé par la règle lors de la redirection du trafic. |
|
typeName |
string:
Delivery |
UrlRewriteAction
Définit l’action de réécriture d’URL pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
UrlRewriteActionParameters
Définit les paramètres de l’action de réécriture d’URL.
Nom | Type | Description |
---|---|---|
destination |
string |
Définissez l’URL relative à laquelle les requêtes ci-dessus seront réécrites. |
preserveUnmatchedPath |
boolean |
Indique s’il faut conserver un chemin sans correspondance. La valeur par défaut est true. |
sourcePattern |
string |
définissez un modèle d’URI de requête qui identifie le type de requêtes qui peuvent être réécrites. Si la valeur est vide, toutes les chaînes sont mises en correspondance. |
typeName |
string:
Delivery |
UrlSigningAction
Définit l’action de signature d’URL pour la règle de remise.
Nom | Type | Description |
---|---|---|
name |
string:
Url |
Nom de l’action pour la règle de remise. |
parameters |
Définit les paramètres de l’action. |
UrlSigningActionParameters
Définit les paramètres de l’action de signature d’URL.
Nom | Type | Description |
---|---|---|
algorithm |
Algorithme à utiliser pour la signature d’URL |
|
parameterNameOverride |
Définit les paramètres de chaîne de requête dans l’URL à prendre en compte pour les expirations, l’ID de clé, etc. |
|
typeName |
string:
Delivery |
UrlSigningParamIdentifier
Définit comment identifier un paramètre à des fins spécifiques, par exemple expire
Nom | Type | Description |
---|---|---|
paramIndicator |
Indique l’objectif du paramètre |
|
paramName |
string |
Nom du paramètre |