Partager via


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
profileName
path True

string

minLength: 1
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

ruleName
path True

string

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

ruleSetName
path True

string

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

subscriptionId
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

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

Rule

Ok

202 Accepted

Rule

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

ErrorResponse

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
AfdProvisioningState

État d’approvisionnement

algorithm

Algorithme à utiliser pour la signature d’URL

cacheBehavior

Comportement de mise en cache pour les requêtes

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.

CacheExpirationActionParameters

Définit les paramètres de l’action d’expiration du cache.

CacheKeyQueryStringActionParameters

Définit les paramètres de l’action de chaîne de requête de clé de cache.

CacheType

Niveau auquel le contenu doit être mis en cache.

ClientPortMatchConditionParameters

Définit les paramètres des conditions de correspondance ClientPort

ClientPortOperator

Décrit l’opérateur à mettre en correspondance

CookiesMatchConditionParameters

Définit les paramètres des conditions de correspondance cookies

CookiesOperator

Décrit l’opérateur à mettre en correspondance

createdByType

Type d’identité qui a créé la ressource.

DeliveryRuleCacheExpirationAction

Définit l’action d’expiration du cache pour la règle de remise.

DeliveryRuleCacheKeyQueryStringAction

Définit l’action de chaîne de requête de clé de cache pour la règle de remise.

DeliveryRuleClientPortCondition

Définit la condition ClientPort pour la règle de remise.

DeliveryRuleCookiesCondition

Définit la condition Cookies pour la règle de remise.

DeliveryRuleHostNameCondition

Définit la condition HostName pour la règle de remise.

DeliveryRuleHttpVersionCondition

Définit la condition HttpVersion pour la règle de remise.

DeliveryRuleIsDeviceCondition

Définit la condition IsDevice pour la règle de remise.

DeliveryRulePostArgsCondition

Définit la condition PostArgs pour la règle de remise.

DeliveryRuleQueryStringCondition

Définit la condition QueryString pour la règle de remise.

DeliveryRuleRemoteAddressCondition

Définit la condition RemoteAddress pour la règle de remise.

DeliveryRuleRequestBodyCondition

Définit la condition RequestBody pour la règle de remise.

DeliveryRuleRequestHeaderAction

Définit l’action d’en-tête de requête pour la règle de remise.

DeliveryRuleRequestHeaderCondition

Définit la condition RequestHeader pour la règle de remise.

DeliveryRuleRequestMethodCondition

Définit la condition RequestMethod pour la règle de remise.

DeliveryRuleRequestSchemeCondition

Définit la condition RequestScheme pour la règle de remise.

DeliveryRuleRequestUriCondition

Définit la condition RequestUri pour la règle de remise.

DeliveryRuleResponseHeaderAction

Définit l’action d’en-tête de réponse pour la règle de remise.

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.

DeliveryRuleServerPortCondition

Définit la condition ServerPort pour la règle de remise.

DeliveryRuleSocketAddrCondition

Définit la condition SocketAddress pour la règle de remise.

DeliveryRuleSslProtocolCondition

Définit la condition SslProtocol pour la règle de remise.

DeliveryRuleUrlFileExtensionCondition

Définit la condition UrlFileExtension pour la règle de remise.

DeliveryRuleUrlFileNameCondition

Définit la condition UrlFileName pour la règle de remise.

DeliveryRuleUrlPathCondition

Définit la condition UrlPath pour la règle de remise.

DeploymentStatus
DestinationProtocol

Protocole à utiliser pour la redirection. La valeur par défaut est MatchRequest

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ForwardingProtocol

Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.

HeaderAction

Action à effectuer

HeaderActionParameters

Définit les paramètres de l’action d’en-tête de requête.

HostNameMatchConditionParameters

Définit les paramètres des conditions de correspondance HostName

HostNameOperator

Décrit l’opérateur à mettre en correspondance

HttpVersionMatchConditionParameters

Définit les paramètres des conditions de correspondance HttpVersion

HttpVersionOperator

Décrit l’opérateur à mettre en correspondance

IsDeviceMatchConditionParameters

Définit les paramètres des conditions de correspondance IsDevice

IsDeviceMatchValue

Valeur de correspondance pour la condition de la règle de remise

IsDeviceOperator

Décrit l’opérateur à mettre en correspondance

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.

OriginGroupOverride

Définit les paramètres de la configuration de remplacement du groupe d’origine.

OriginGroupOverrideAction

Définit l’action de remplacement du groupe d’origine pour la règle de remise.

OriginGroupOverrideActionParameters

Définit les paramètres de l’action de remplacement du groupe d’origine.

paramIndicator

Indique l’objectif du paramètre

PostArgsMatchConditionParameters

Définit les paramètres des conditions de correspondance PostArgs

PostArgsOperator

Décrit l’opérateur à mettre en correspondance

queryStringBehavior

Comportement de mise en cache pour les requêtes

QueryStringMatchConditionParameters

Définit les paramètres des conditions de correspondance QueryString

QueryStringOperator

Décrit l’opérateur à mettre en correspondance

RedirectType

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

RemoteAddressMatchConditionParameters

Définit les paramètres des conditions de correspondance RemoteAddress

RemoteAddressOperator

Décrit l’opérateur à mettre en correspondance

RequestBodyMatchConditionParameters

Définit les paramètres des conditions de correspondance RequestBody

RequestBodyOperator

Décrit l’opérateur à mettre en correspondance

RequestHeaderMatchConditionParameters

Définit les paramètres des conditions de correspondance RequestHeader

RequestHeaderOperator

Décrit l’opérateur à mettre en correspondance

RequestMethodMatchConditionParameters

Définit les paramètres des conditions de correspondance RequestMethod

RequestMethodMatchValue

Valeur de correspondance pour la condition de la règle de remise

RequestMethodOperator

Décrit l’opérateur à mettre en correspondance

RequestSchemeMatchConditionParameters

Définit les paramètres des conditions de correspondance RequestScheme

RequestSchemeMatchValue

Valeur de correspondance pour la condition de la règle de remise

RequestUriMatchConditionParameters

Définit les paramètres des conditions de correspondance RequestUri

RequestUriOperator

Décrit l’opérateur à mettre en correspondance

ResourceReference

Référence à une autre ressource.

RouteConfigurationOverrideActionParameters

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.

ruleCacheBehavior

Comportement de mise en cache pour les requêtes

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.

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.

RuleUpdateParameters

Objet JSON de domaine requis pour la création ou la mise à jour du domaine.

ServerPortMatchConditionParameters

Définit les paramètres des conditions de correspondance ServerPort

ServerPortOperator

Décrit l’opérateur à mettre en correspondance

SocketAddrMatchConditionParameters

Définit les paramètres des conditions de correspondance SocketAddress

SocketAddrOperator

Décrit l’opérateur à mettre en correspondance

SslProtocol

Protocole d’une connexion TLS établie.

SslProtocolMatchConditionParameters

Définit les paramètres des conditions de correspondance SslProtocol

SslProtocolOperator

Décrit l’opérateur à mettre en correspondance

systemData

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

UrlFileExtensionMatchConditionParameters

Définit les paramètres des conditions de correspondance UrlFileExtension

UrlFileExtensionOperator

Décrit l’opérateur à mettre en correspondance

UrlFileNameMatchConditionParameters

Définit les paramètres des conditions de correspondance UrlFilename

UrlFileNameOperator

Décrit l’opérateur à mettre en correspondance

UrlPathMatchConditionParameters

Définit les paramètres des conditions de correspondance UrlPath

UrlPathOperator

Décrit l’opérateur à mettre en correspondance

UrlRedirectAction

Définit l’action de redirection d’URL pour la règle de remise.

UrlRedirectActionParameters

Définit les paramètres de l’action de redirection d’URL.

UrlRewriteAction

Définit l’action de réécriture d’URL pour la règle de remise.

UrlRewriteActionParameters

Définit les paramètres de l’action de réécriture d’URL.

UrlSigningAction

Définit l’action de signature d’URL pour la règle de remise.

UrlSigningActionParameters

Définit les paramètres de l’action de signature d’URL.

UrlSigningParamIdentifier

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

ruleCacheBehavior

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

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.

queryParameters

string

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

queryStringCachingBehavior

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.

CacheExpirationActionParameters

Définit les paramètres de l’action d’expiration du cache.

Nom Type Description
cacheBehavior

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

CacheType

Niveau auquel le contenu doit être mis en cache.

typeName string:

DeliveryRuleCacheExpirationActionParameters

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

queryStringBehavior

Comportement de mise en cache pour les requêtes

typeName string:

DeliveryRuleCacheKeyQueryStringBehaviorActionParameters

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

ClientPortOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleClientPortConditionParameters

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

CookiesOperator

Décrit l’opérateur à mettre en correspondance

selector

string

Nom des cookies à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleCookiesConditionParameters

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:

CacheExpiration

Nom de l’action pour la règle de remise.

parameters

CacheExpirationActionParameters

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:

CacheKeyQueryString

Nom de l’action pour la règle de remise.

parameters

CacheKeyQueryStringActionParameters

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:

ClientPort

Nom de la condition de la règle de remise.

parameters

ClientPortMatchConditionParameters

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

CookiesMatchConditionParameters

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:

HostName

Nom de la condition de la règle de remise.

parameters

HostNameMatchConditionParameters

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:

HttpVersion

Nom de la condition de la règle de remise.

parameters

HttpVersionMatchConditionParameters

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:

IsDevice

Nom de la condition de la règle de remise.

parameters

IsDeviceMatchConditionParameters

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:

PostArgs

Nom de la condition de la règle de remise.

parameters

PostArgsMatchConditionParameters

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:

QueryString

Nom de la condition de la règle de remise.

parameters

QueryStringMatchConditionParameters

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:

RemoteAddress

Nom de la condition de la règle de remise.

parameters

RemoteAddressMatchConditionParameters

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:

RequestBody

Nom de la condition de la règle de remise.

parameters

RequestBodyMatchConditionParameters

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:

ModifyRequestHeader

Nom de l’action pour la règle de remise.

parameters

HeaderActionParameters

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:

RequestHeader

Nom de la condition de la règle de remise.

parameters

RequestHeaderMatchConditionParameters

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:

RequestMethod

Nom de la condition de la règle de remise.

parameters

RequestMethodMatchConditionParameters

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:

RequestScheme

Nom de la condition de la règle de remise.

parameters

RequestSchemeMatchConditionParameters

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:

RequestUri

Nom de la condition de la règle de remise.

parameters

RequestUriMatchConditionParameters

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:

ModifyResponseHeader

Nom de l’action pour la règle de remise.

parameters

HeaderActionParameters

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:

RouteConfigurationOverride

Nom de l’action pour la règle de remise.

parameters

RouteConfigurationOverrideActionParameters

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:

ServerPort

Nom de la condition de la règle de remise.

parameters

ServerPortMatchConditionParameters

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:

SocketAddr

Nom de la condition de la règle de remise.

parameters

SocketAddrMatchConditionParameters

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:

SslProtocol

Nom de la condition de la règle de remise.

parameters

SslProtocolMatchConditionParameters

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:

UrlFileExtension

Nom de la condition de la règle de remise.

parameters

UrlFileExtensionMatchConditionParameters

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:

UrlFileName

Nom de la condition de la règle de remise.

parameters

UrlFileNameMatchConditionParameters

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:

UrlPath

Nom de la condition de la règle de remise.

parameters

UrlPathMatchConditionParameters

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

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

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

HeaderAction

Action à effectuer

headerName

string

Nom de l’en-tête à modifier

typeName string:

DeliveryRuleHeaderActionParameters

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

HostNameOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleHostNameConditionParameters

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

HttpVersionOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleHttpVersionConditionParameters

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

IsDeviceMatchValue[]

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

IsDeviceOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleIsDeviceConditionParameters

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

ForwardingProtocol

Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.

originGroup

ResourceReference

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:

OriginGroupOverride

Nom de l’action pour la règle de remise.

parameters

OriginGroupOverrideActionParameters

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

ResourceReference

définit le Groupe d’origine qui remplacerait DefaultOriginGroup.

typeName string:

DeliveryRuleOriginGroupOverrideActionParameters

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

PostArgsOperator

Décrit l’opérateur à mettre en correspondance

selector

string

Nom de PostArg à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRulePostArgsConditionParameters

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

QueryStringOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleQueryStringConditionParameters

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

RemoteAddressOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleRemoteAddressConditionParameters

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

RequestBodyOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleRequestBodyConditionParameters

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

RequestHeaderOperator

Décrit l’opérateur à mettre en correspondance

selector

string

Nom de l’en-tête à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleRequestHeaderConditionParameters

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

RequestMethodMatchValue[]

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

RequestMethodOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleRequestMethodConditionParameters

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

RequestSchemeMatchValue[]

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

transform[]

Liste des transformations

typeName string:

DeliveryRuleRequestSchemeConditionParameters

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

RequestUriOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleRequestUriConditionParameters

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

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

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:

DeliveryRuleRouteConfigurationOverrideActionParameters

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

DeploymentStatus

properties.matchProcessingBehavior

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

AfdProvisioningState

État d’approvisionnement

properties.ruleSetName

string

Nom du jeu de règles contenant la règle.

systemData

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

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

ServerPortOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleServerPortConditionParameters

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

SocketAddrOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleSocketAddrConditionParameters

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

SslProtocol[]

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

SslProtocolOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleSslProtocolConditionParameters

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

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

createdByType

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

UrlFileExtensionOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleUrlFileExtensionMatchConditionParameters

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

UrlFileNameOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleUrlFilenameConditionParameters

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

UrlPathOperator

Décrit l’opérateur à mettre en correspondance

transforms

transform[]

Liste des transformations

typeName string:

DeliveryRuleUrlPathMatchConditionParameters

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:

UrlRedirect

Nom de l’action pour la règle de remise.

parameters

UrlRedirectActionParameters

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

DestinationProtocol

Protocole à utiliser pour la redirection. La valeur par défaut est MatchRequest

redirectType

RedirectType

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

typeName string:

DeliveryRuleUrlRedirectActionParameters

UrlRewriteAction

Définit l’action de réécriture d’URL pour la règle de remise.

Nom Type Description
name string:

UrlRewrite

Nom de l’action pour la règle de remise.

parameters

UrlRewriteActionParameters

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:

DeliveryRuleUrlRewriteActionParameters

UrlSigningAction

Définit l’action de signature d’URL pour la règle de remise.

Nom Type Description
name string:

UrlSigning

Nom de l’action pour la règle de remise.

parameters

UrlSigningActionParameters

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

algorithm

Algorithme à utiliser pour la signature d’URL

parameterNameOverride

UrlSigningParamIdentifier[]

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:

DeliveryRuleUrlSigningActionParameters

UrlSigningParamIdentifier

Définit comment identifier un paramètre à des fins spécifiques, par exemple expire

Nom Type Description
paramIndicator

paramIndicator

Indique l’objectif du paramètre

paramName

string

Nom du paramètre