Rules - Update
Updates an existing delivery rule within a rule set.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}?api-version=2023-05-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
profile
|
path | True |
string |
Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. |
resource
|
path | True |
string |
Name of the Resource group within the Azure subscription. Regex pattern: |
rule
|
path | True |
string |
Name of the delivery rule which is unique within the endpoint. |
rule
|
path | True |
string |
Name of the rule set under the profile. |
subscription
|
path | True |
string |
Azure Subscription ID. |
api-version
|
query | True |
string |
Version of the API to be used with the client request. Current version is 2023-05-01. |
Request Body
Name | Type | Description |
---|---|---|
properties.actions | DeliveryRuleAction[]: |
A list of actions that are executed when all the conditions of a rule are satisfied. |
properties.conditions |
DeliveryRuleCondition[]:
|
A list of conditions that must be matched for the actions to be executed |
properties.matchProcessingBehavior |
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue. |
|
properties.order |
integer |
The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lesser order will be applied before a rule with a greater order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Accepted. The request has been accepted for processing and the operation will complete asynchronously. Headers location: string |
|
Other Status Codes |
Azure Front Door error response describing why the operation failed. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
Rules_Update
Sample Request
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1/rules/rule1?api-version=2023-05-01
{
"properties": {
"order": 1,
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
]
}
}
Sample Response
{
"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=2023-05-01
{
"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"
}
}
Definitions
Name | Description |
---|---|
Afd |
Error response |
Afd |
Provisioning status |
algorithm |
Algorithm to use for URL signing |
cache |
Caching behavior for the requests |
Cache |
Caching settings for a caching-type route. To disable caching, do not provide a cacheConfiguration object. |
Cache |
Defines the parameters for the cache expiration action. |
Cache |
Defines the parameters for the cache-key query string action. |
Cache |
The level at which the content needs to be cached. |
Client |
Defines the parameters for ClientPort match conditions |
Client |
Describes operator to be matched |
Cookies |
Defines the parameters for Cookies match conditions |
Cookies |
Describes operator to be matched |
Delivery |
Defines the cache expiration action for the delivery rule. |
Delivery |
Defines the cache-key query string action for the delivery rule. |
Delivery |
Defines the ClientPort condition for the delivery rule. |
Delivery |
Defines the Cookies condition for the delivery rule. |
Delivery |
Defines the HostName condition for the delivery rule. |
Delivery |
Defines the HttpVersion condition for the delivery rule. |
Delivery |
Defines the IsDevice condition for the delivery rule. |
Delivery |
Defines the PostArgs condition for the delivery rule. |
Delivery |
Defines the QueryString condition for the delivery rule. |
Delivery |
Defines the RemoteAddress condition for the delivery rule. |
Delivery |
Defines the RequestBody condition for the delivery rule. |
Delivery |
Defines the request header action for the delivery rule. |
Delivery |
Defines the RequestHeader condition for the delivery rule. |
Delivery |
Defines the RequestMethod condition for the delivery rule. |
Delivery |
Defines the RequestScheme condition for the delivery rule. |
Delivery |
Defines the RequestUri condition for the delivery rule. |
Delivery |
Defines the response header action for the delivery rule. |
Delivery |
Defines the route configuration override action for the delivery rule. Only applicable to Frontdoor Standard/Premium Profiles. |
Delivery |
Defines the ServerPort condition for the delivery rule. |
Delivery |
Defines the SocketAddress condition for the delivery rule. |
Delivery |
Defines the SslProtocol condition for the delivery rule. |
Delivery |
Defines the UrlFileExtension condition for the delivery rule. |
Delivery |
Defines the UrlFileName condition for the delivery rule. |
Delivery |
Defines the UrlPath condition for the delivery rule. |
Deployment |
|
Destination |
Protocol to use for the redirect. The default value is MatchRequest |
Error |
The resource management error additional info. |
Error |
The error detail. |
Forwarding |
Protocol this rule will use when forwarding traffic to backends. |
Header |
Action to perform |
Header |
Defines the parameters for the request header action. |
Host |
Defines the parameters for HostName match conditions |
Host |
Describes operator to be matched |
Http |
Defines the parameters for HttpVersion match conditions |
Http |
Describes operator to be matched |
Identity |
The type of identity that creates/modifies resources |
Is |
Defines the parameters for IsDevice match conditions |
Is |
Describes operator to be matched |
Match |
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue. |
Match |
The match value for the condition of the delivery rule |
Origin |
Defines the parameters for the origin group override configuration. |
Origin |
Defines the origin group override action for the delivery rule. |
Origin |
Defines the parameters for the origin group override action. |
param |
Indicates the purpose of the parameter |
Post |
Defines the parameters for PostArgs match conditions |
Post |
Describes operator to be matched |
query |
Caching behavior for the requests |
Query |
Defines the parameters for QueryString match conditions |
Query |
Describes operator to be matched |
Redirect |
The redirect type the rule will use when redirecting traffic. |
Remote |
Defines the parameters for RemoteAddress match conditions |
Remote |
Describes operator to be matched |
Request |
Defines the parameters for RequestBody match conditions |
Request |
Describes operator to be matched |
Request |
Defines the parameters for RequestHeader match conditions |
Request |
Describes operator to be matched |
Request |
Defines the parameters for RequestMethod match conditions |
Request |
Describes operator to be matched |
Request |
Defines the parameters for RequestScheme match conditions |
Request |
Defines the parameters for RequestUri match conditions |
Request |
Describes operator to be matched |
Resource |
Reference to another resource. |
Route |
Defines the parameters for the route configuration override action. |
Rule |
Friendly Rules name mapping to the any Rules or secret related information. |
rule |
Caching behavior for the requests |
rule |
Indicates whether content compression is enabled. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on AzureFrontDoor when requested content is smaller than 1 byte or larger than 1 MB. |
rule |
Defines how Frontdoor caches requests that include query strings. You can ignore any query strings when caching, ignore specific query strings, cache every request with a unique URL, or cache specific query strings. |
Rule |
The domain JSON object required for domain creation or update. |
Server |
Defines the parameters for ServerPort match conditions |
Server |
Describes operator to be matched |
Socket |
Defines the parameters for SocketAddress match conditions |
Socket |
Describes operator to be matched |
Ssl |
The protocol of an established TLS connection. |
Ssl |
Defines the parameters for SslProtocol match conditions |
Ssl |
Describes operator to be matched |
System |
Read only system data |
transform |
Describes what transforms are applied before matching |
Url |
Defines the parameters for UrlFileExtension match conditions |
Url |
Describes operator to be matched |
Url |
Defines the parameters for UrlFilename match conditions |
Url |
Describes operator to be matched |
Url |
Defines the parameters for UrlPath match conditions |
Url |
Describes operator to be matched |
Url |
Defines the url redirect action for the delivery rule. |
Url |
Defines the parameters for the url redirect action. |
Url |
Defines the url rewrite action for the delivery rule. |
Url |
Defines the parameters for the url rewrite action. |
Url |
Defines the url signing action for the delivery rule. |
Url |
Defines the parameters for the Url Signing action. |
Url |
Defines how to identify a parameter for a specific purpose e.g. expires |
AfdErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
AfdProvisioningState
Provisioning status
Name | Type | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
algorithm
Algorithm to use for URL signing
Name | Type | Description |
---|---|---|
SHA256 |
string |
cacheBehavior
Caching behavior for the requests
Name | Type | Description |
---|---|---|
BypassCache |
string |
|
Override |
string |
|
SetIfMissing |
string |
CacheConfiguration
Caching settings for a caching-type route. To disable caching, do not provide a cacheConfiguration object.
Name | Type | Description |
---|---|---|
cacheBehavior |
Caching behavior for the requests |
|
cacheDuration |
string |
The duration for which the content needs to be cached. Allowed format is [d.]hh:mm:ss |
isCompressionEnabled |
Indicates whether content compression is enabled. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on AzureFrontDoor when requested content is smaller than 1 byte or larger than 1 MB. |
|
queryParameters |
string |
query parameters to include or exclude (comma separated). |
queryStringCachingBehavior |
Defines how Frontdoor caches requests that include query strings. You can ignore any query strings when caching, ignore specific query strings, cache every request with a unique URL, or cache specific query strings. |
CacheExpirationActionParameters
Defines the parameters for the cache expiration action.
Name | Type | Description |
---|---|---|
cacheBehavior |
Caching behavior for the requests |
|
cacheDuration |
string |
The duration for which the content needs to be cached. Allowed format is [d.]hh:mm:ss |
cacheType |
The level at which the content needs to be cached. |
|
typeName |
enum:
Delivery |
CacheKeyQueryStringActionParameters
Defines the parameters for the cache-key query string action.
Name | Type | Description |
---|---|---|
queryParameters |
string |
query parameters to include or exclude (comma separated). |
queryStringBehavior |
Caching behavior for the requests |
|
typeName |
enum:
Delivery |
CacheType
The level at which the content needs to be cached.
Name | Type | Description |
---|---|---|
All |
string |
ClientPortMatchConditionParameters
Defines the parameters for ClientPort match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
ClientPortOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
CookiesMatchConditionParameters
Defines the parameters for Cookies match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
selector |
string |
Name of Cookies to be matched |
|
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
CookiesOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
DeliveryRuleCacheExpirationAction
Defines the cache expiration action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Cache |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
DeliveryRuleCacheKeyQueryStringAction
Defines the cache-key query string action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Cache |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
DeliveryRuleClientPortCondition
Defines the ClientPort condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Client |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleCookiesCondition
Defines the Cookies condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Cookies |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleHostNameCondition
Defines the HostName condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Host |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleHttpVersionCondition
Defines the HttpVersion condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Http |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleIsDeviceCondition
Defines the IsDevice condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Is |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRulePostArgsCondition
Defines the PostArgs condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Post |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleQueryStringCondition
Defines the QueryString condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Query |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRemoteAddressCondition
Defines the RemoteAddress condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Remote |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRequestBodyCondition
Defines the RequestBody condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Request |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRequestHeaderAction
Defines the request header action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Modify |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
DeliveryRuleRequestHeaderCondition
Defines the RequestHeader condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Request |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRequestMethodCondition
Defines the RequestMethod condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Request |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRequestSchemeCondition
Defines the RequestScheme condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Request |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleRequestUriCondition
Defines the RequestUri condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Request |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleResponseHeaderAction
Defines the response header action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Modify |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
DeliveryRuleRouteConfigurationOverrideAction
Defines the route configuration override action for the delivery rule. Only applicable to Frontdoor Standard/Premium Profiles.
Name | Type | Description |
---|---|---|
name |
string:
Route |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
DeliveryRuleServerPortCondition
Defines the ServerPort condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Server |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleSocketAddrCondition
Defines the SocketAddress condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Socket |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleSslProtocolCondition
Defines the SslProtocol condition for the delivery rule.
Name | Type | Description |
---|---|---|
name | string: |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleUrlFileExtensionCondition
Defines the UrlFileExtension condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleUrlFileNameCondition
Defines the UrlFileName condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeliveryRuleUrlPathCondition
Defines the UrlPath condition for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the condition for the delivery rule. |
parameters |
Defines the parameters for the condition. |
DeploymentStatus
Name | Type | Description |
---|---|---|
Failed |
string |
|
InProgress |
string |
|
NotStarted |
string |
|
Succeeded |
string |
DestinationProtocol
Protocol to use for the redirect. The default value is MatchRequest
Name | Type | Description |
---|---|---|
Http |
string |
|
Https |
string |
|
MatchRequest |
string |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ErrorDetail
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ForwardingProtocol
Protocol this rule will use when forwarding traffic to backends.
Name | Type | Description |
---|---|---|
HttpOnly |
string |
|
HttpsOnly |
string |
|
MatchRequest |
string |
HeaderAction
Action to perform
Name | Type | Description |
---|---|---|
Append |
string |
|
Delete |
string |
|
Overwrite |
string |
HeaderActionParameters
Defines the parameters for the request header action.
Name | Type | Description |
---|---|---|
headerAction |
Action to perform |
|
headerName |
string |
Name of the header to modify |
typeName |
enum:
Delivery |
|
value |
string |
Value for the specified action |
HostNameMatchConditionParameters
Defines the parameters for HostName match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
HostNameOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
HttpVersionMatchConditionParameters
Defines the parameters for HttpVersion match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
HttpVersionOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Equal |
string |
IdentityType
The type of identity that creates/modifies resources
Name | Type | Description |
---|---|---|
application |
string |
|
key |
string |
|
managedIdentity |
string |
|
user |
string |
IsDeviceMatchConditionParameters
Defines the parameters for IsDevice match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
The match value for the condition of the delivery rule |
||
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
IsDeviceOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Equal |
string |
MatchProcessingBehavior
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue.
Name | Type | Description |
---|---|---|
Continue |
string |
|
Stop |
string |
MatchValues
The match value for the condition of the delivery rule
Name | Type | Description |
---|---|---|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
OPTIONS |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
OriginGroupOverride
Defines the parameters for the origin group override configuration.
Name | Type | Description |
---|---|---|
forwardingProtocol |
Protocol this rule will use when forwarding traffic to backends. |
|
originGroup |
defines the OriginGroup that would override the DefaultOriginGroup on route. |
OriginGroupOverrideAction
Defines the origin group override action for the delivery rule.
Name | Type | Description |
---|---|---|
name | string: |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
OriginGroupOverrideActionParameters
Defines the parameters for the origin group override action.
Name | Type | Description |
---|---|---|
originGroup |
defines the OriginGroup that would override the DefaultOriginGroup. |
|
typeName |
enum:
Delivery |
paramIndicator
Indicates the purpose of the parameter
Name | Type | Description |
---|---|---|
Expires |
string |
|
KeyId |
string |
|
Signature |
string |
PostArgsMatchConditionParameters
Defines the parameters for PostArgs match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
selector |
string |
Name of PostArg to be matched |
|
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
PostArgsOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
queryStringBehavior
Caching behavior for the requests
Name | Type | Description |
---|---|---|
Exclude |
string |
|
ExcludeAll |
string |
|
Include |
string |
|
IncludeAll |
string |
QueryStringMatchConditionParameters
Defines the parameters for QueryString match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
QueryStringOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
RedirectType
The redirect type the rule will use when redirecting traffic.
Name | Type | Description |
---|---|---|
Found |
string |
|
Moved |
string |
|
PermanentRedirect |
string |
|
TemporaryRedirect |
string |
RemoteAddressMatchConditionParameters
Defines the parameters for RemoteAddress match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
Match values to match against. The operator will apply to each value in here with OR semantics. If any of them match the variable with the given operator this match condition is considered a match. |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RemoteAddressOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
GeoMatch |
string |
|
IPMatch |
string |
RequestBodyMatchConditionParameters
Defines the parameters for RequestBody match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RequestBodyOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
RequestHeaderMatchConditionParameters
Defines the parameters for RequestHeader match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
selector |
string |
Name of Header to be matched |
|
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RequestHeaderOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
RequestMethodMatchConditionParameters
Defines the parameters for RequestMethod match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
The match value for the condition of the delivery rule |
||
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RequestMethodOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Equal |
string |
RequestSchemeMatchConditionParameters
Defines the parameters for RequestScheme match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
The match value for the condition of the delivery rule |
||
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
enum:
Equal |
Describes operator to be matched |
|
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RequestUriMatchConditionParameters
Defines the parameters for RequestUri match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
RequestUriOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
ResourceReference
Reference to another resource.
Name | Type | Description |
---|---|---|
id |
string |
Resource ID. |
RouteConfigurationOverrideActionParameters
Defines the parameters for the route configuration override action.
Name | Type | Description |
---|---|---|
cacheConfiguration |
The caching configuration associated with this rule. To disable caching, do not provide a cacheConfiguration object. |
|
originGroupOverride |
A reference to the origin group override configuration. Leave empty to use the default origin group on route. |
|
typeName |
enum:
Delivery |
Rule
Friendly Rules name mapping to the any Rules or secret related information.
Name | Type | Default Value | Description |
---|---|---|---|
id |
string |
Resource ID. |
|
name |
string |
Resource name. |
|
properties.actions | DeliveryRuleAction[]: |
A list of actions that are executed when all the conditions of a rule are satisfied. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
A list of conditions that must be matched for the actions to be executed |
|
properties.deploymentStatus | |||
properties.matchProcessingBehavior | Continue |
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue. |
|
properties.order |
integer |
The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lesser order will be applied before a rule with a greater order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied. |
|
properties.provisioningState |
Provisioning status |
||
properties.ruleSetName |
string |
The name of the rule set containing the rule. |
|
systemData |
Read only system data |
||
type |
string |
Resource type. |
ruleCacheBehavior
Caching behavior for the requests
Name | Type | Description |
---|---|---|
HonorOrigin |
string |
|
OverrideAlways |
string |
|
OverrideIfOriginMissing |
string |
ruleIsCompressionEnabled
Indicates whether content compression is enabled. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on AzureFrontDoor when requested content is smaller than 1 byte or larger than 1 MB.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ruleQueryStringCachingBehavior
Defines how Frontdoor caches requests that include query strings. You can ignore any query strings when caching, ignore specific query strings, cache every request with a unique URL, or cache specific query strings.
Name | Type | Description |
---|---|---|
IgnoreQueryString |
string |
|
IgnoreSpecifiedQueryStrings |
string |
|
IncludeSpecifiedQueryStrings |
string |
|
UseQueryString |
string |
RuleUpdateParameters
The domain JSON object required for domain creation or update.
Name | Type | Default Value | Description |
---|---|---|---|
properties.actions | DeliveryRuleAction[]: |
A list of actions that are executed when all the conditions of a rule are satisfied. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
A list of conditions that must be matched for the actions to be executed |
|
properties.matchProcessingBehavior | Continue |
If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue. |
|
properties.order |
integer |
The order in which the rules are applied for the endpoint. Possible values {0,1,2,3,………}. A rule with a lesser order will be applied before a rule with a greater order. Rule with order 0 is a special rule. It does not require any condition and actions listed in it will always be applied. |
|
properties.ruleSetName |
string |
The name of the rule set containing the rule. |
ServerPortMatchConditionParameters
Defines the parameters for ServerPort match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
ServerPortOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
SocketAddrMatchConditionParameters
Defines the parameters for SocketAddress match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
SocketAddrOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
IPMatch |
string |
SslProtocol
The protocol of an established TLS connection.
Name | Type | Description |
---|---|---|
TLSv1 |
string |
|
TLSv1.1 |
string |
|
TLSv1.2 |
string |
SslProtocolMatchConditionParameters
Defines the parameters for SslProtocol match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
The match value for the condition of the delivery rule |
||
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
SslProtocolOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Equal |
string |
SystemData
Read only system data
Name | Type | Description |
---|---|---|
createdAt |
string |
The timestamp of resource creation (UTC) |
createdBy |
string |
An identifier for the identity that created the resource |
createdByType |
The type of identity that created the resource |
|
lastModifiedAt |
string |
The timestamp of resource last modification (UTC) |
lastModifiedBy |
string |
An identifier for the identity that last modified the resource |
lastModifiedByType |
The type of identity that last modified the resource |
transform
Describes what transforms are applied before matching
Name | Type | Description |
---|---|---|
Lowercase |
string |
|
RemoveNulls |
string |
|
Trim |
string |
|
Uppercase |
string |
|
UrlDecode |
string |
|
UrlEncode |
string |
UrlFileExtensionMatchConditionParameters
Defines the parameters for UrlFileExtension match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
UrlFileExtensionOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
UrlFileNameMatchConditionParameters
Defines the parameters for UrlFilename match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
UrlFileNameOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
UrlPathMatchConditionParameters
Defines the parameters for UrlPath match conditions
Name | Type | Default Value | Description |
---|---|---|---|
matchValues |
string[] |
The match value for the condition of the delivery rule |
|
negateCondition |
boolean |
False |
Describes if this is negate condition or not |
operator |
Describes operator to be matched |
||
transforms |
List of transforms |
||
typeName |
enum:
Delivery |
UrlPathOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Any |
string |
|
BeginsWith |
string |
|
Contains |
string |
|
EndsWith |
string |
|
Equal |
string |
|
GreaterThan |
string |
|
GreaterThanOrEqual |
string |
|
LessThan |
string |
|
LessThanOrEqual |
string |
|
RegEx |
string |
|
Wildcard |
string |
UrlRedirectAction
Defines the url redirect action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
UrlRedirectActionParameters
Defines the parameters for the url redirect action.
Name | Type | Description |
---|---|---|
customFragment |
string |
Fragment to add to the redirect URL. Fragment is the part of the URL that comes after #. Do not include the #. |
customHostname |
string |
Host to redirect. Leave empty to use the incoming host as the destination host. |
customPath |
string |
The full path to redirect. Path cannot be empty and must start with /. Leave empty to use the incoming path as destination path. |
customQueryString |
string |
The set of query strings to be placed in the redirect URL. Setting this value would replace any existing query string; leave empty to preserve the incoming query string. Query string must be in = format. ? and & will be added automatically so do not include them. |
destinationProtocol |
Protocol to use for the redirect. The default value is MatchRequest |
|
redirectType |
The redirect type the rule will use when redirecting traffic. |
|
typeName |
enum:
Delivery |
UrlRewriteAction
Defines the url rewrite action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
UrlRewriteActionParameters
Defines the parameters for the url rewrite action.
Name | Type | Description |
---|---|---|
destination |
string |
Define the relative URL to which the above requests will be rewritten by. |
preserveUnmatchedPath |
boolean |
Whether to preserve unmatched path. Default value is true. |
sourcePattern |
string |
define a request URI pattern that identifies the type of requests that may be rewritten. If value is blank, all strings are matched. |
typeName |
enum:
Delivery |
UrlSigningAction
Defines the url signing action for the delivery rule.
Name | Type | Description |
---|---|---|
name |
string:
Url |
The name of the action for the delivery rule. |
parameters |
Defines the parameters for the action. |
UrlSigningActionParameters
Defines the parameters for the Url Signing action.
Name | Type | Description |
---|---|---|
algorithm |
Algorithm to use for URL signing |
|
parameterNameOverride |
Defines which query string parameters in the url to be considered for expires, key id etc. |
|
typeName |
enum:
Delivery |
UrlSigningParamIdentifier
Defines how to identify a parameter for a specific purpose e.g. expires
Name | Type | Description |
---|---|---|
paramIndicator |
Indicates the purpose of the parameter |
|
paramName |
string |
Parameter name |