Endpoints - Create
Creates a new CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}?api-version=2024-02-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
endpoint
|
path | True |
string |
Name of the endpoint under the profile which is unique globally. |
profile
|
path | True |
string |
Name of the CDN profile which is unique within the resource group. |
resource
|
path | True |
string |
Name of the Resource group within the Azure subscription. Regex pattern: |
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 2024-02-01. |
Request Body
Name | Required | Type | Description |
---|---|---|---|
location | True |
string |
Resource location. |
properties.origins | True |
The source of the content being delivered via CDN. |
|
properties.contentTypesToCompress |
string[] |
List of content types on which compression applies. The value should be a valid MIME type. |
|
properties.defaultOriginGroup |
A reference to the origin group. |
||
properties.deliveryPolicy |
A policy that specifies the delivery rules to be used for an endpoint. |
||
properties.geoFilters |
List of rules defining the user's geo access within a CDN endpoint. Each geo filter defines an access rule to a specified path or content, e.g. block APAC for path /pictures/ |
||
properties.isCompressionEnabled |
boolean |
Indicates whether content compression is enabled on CDN. Default value is false. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on CDN when requested content is smaller than 1 byte or larger than 1 MB. |
|
properties.isHttpAllowed |
boolean |
Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
|
properties.isHttpsAllowed |
boolean |
Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
|
properties.optimizationType |
Specifies what scenario the customer wants this CDN endpoint to optimize for, e.g. Download, Media services. With this information, CDN can apply scenario driven optimization. |
||
properties.originGroups |
The origin groups comprising of origins that are used for load balancing the traffic based on availability. |
||
properties.originHostHeader |
string |
The host header value sent to the origin with each request. This property at Endpoint is only allowed when endpoint uses single origin and can be overridden by the same property specified at origin.If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default. |
|
properties.originPath |
string |
A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath. |
|
properties.probePath |
string |
Path to a file hosted on the origin which helps accelerate delivery of the dynamic content and calculate the most optimal routes for the CDN. This is relative to the origin path. This property is only relevant when using a single origin. |
|
properties.queryStringCachingBehavior |
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL. |
||
properties.urlSigningKeys |
List of keys used to validate the signed URL hashes. |
||
properties.webApplicationFirewallPolicyLink |
Defines the Web Application Firewall policy for the endpoint (if applicable) |
||
tags |
object |
Resource tags. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK. The request has succeeded. |
|
201 Created |
Created. The request has been fulfilled and a new endpoint has been created. |
|
202 Accepted |
Accepted and the operation will complete asynchronously. Headers location: string |
|
Other Status Codes |
CDN 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
Endpoints_Create
Sample request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1?api-version=2024-02-01
{
"location": "WestUs",
"tags": {
"key1": "value1"
},
"properties": {
"originHostHeader": "www.bing.com",
"originPath": "/photos",
"contentTypesToCompress": [
"text/html",
"application/octet-stream"
],
"isCompressionEnabled": true,
"isHttpAllowed": true,
"isHttpsAllowed": true,
"queryStringCachingBehavior": "BypassCaching",
"defaultOriginGroup": {
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
},
"deliveryPolicy": {
"description": "Test description for a policy.",
"rules": [
{
"name": "rule1",
"order": 1,
"conditions": [
{
"name": "RemoteAddress",
"parameters": {
"operator": "IPMatch",
"negateCondition": true,
"matchValues": [
"192.168.1.0/24",
"10.0.0.0/24"
],
"typeName": "DeliveryRuleRemoteAddressConditionParameters"
}
}
],
"actions": [
{
"name": "CacheExpiration",
"parameters": {
"cacheBehavior": "Override",
"cacheDuration": "10:10:09",
"typeName": "DeliveryRuleCacheExpirationActionParameters",
"cacheType": "All"
}
},
{
"name": "ModifyResponseHeader",
"parameters": {
"headerAction": "Overwrite",
"headerName": "Access-Control-Allow-Origin",
"value": "*",
"typeName": "DeliveryRuleHeaderActionParameters"
}
},
{
"name": "ModifyRequestHeader",
"parameters": {
"headerAction": "Overwrite",
"headerName": "Accept-Encoding",
"value": "gzip",
"typeName": "DeliveryRuleHeaderActionParameters"
}
}
]
}
]
},
"origins": [
{
"name": "origin1",
"properties": {
"hostName": "www.someDomain1.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain1.net",
"priority": 1,
"weight": 50,
"enabled": true
}
},
{
"name": "origin2",
"properties": {
"hostName": "www.someDomain2.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain2.net",
"priority": 2,
"weight": 50,
"enabled": true
}
}
],
"originGroups": [
{
"name": "originGroup1",
"properties": {
"healthProbeSettings": {
"probePath": "/health.aspx",
"probeRequestType": "GET",
"probeProtocol": "Http",
"probeIntervalInSeconds": 120
},
"origins": [
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
},
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
}
],
"responseBasedOriginErrorDetectionSettings": {
"responseBasedDetectedErrorTypes": "TcpErrorsOnly",
"responseBasedFailoverThresholdPercentage": 10
}
}
}
]
}
}
Sample response
{
"name": "endpoint4899",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
"type": "Microsoft.Cdn/profiles/endpoints",
"tags": {
"kay1": "value1"
},
"location": "WestUs",
"properties": {
"hostName": "endpoint4899.azureedge-test.net",
"originHostHeader": "www.bing.com",
"provisioningState": "Creating",
"resourceState": "Creating",
"isHttpAllowed": true,
"isHttpsAllowed": true,
"queryStringCachingBehavior": "BypassCaching",
"originPath": "/photos",
"defaultOriginGroup": {
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
},
"origins": [
{
"name": "origin1",
"properties": {
"hostName": "www.someDomain1.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain1.net",
"priority": 1,
"weight": 50,
"enabled": true
}
},
{
"name": "origin2",
"properties": {
"hostName": "www.someDomain2.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain2.net",
"priority": 2,
"weight": 50,
"enabled": true
}
}
],
"originGroups": [
{
"name": "originGroup1",
"properties": {
"healthProbeSettings": {
"probePath": "/health.aspx",
"probeRequestType": "GET",
"probeProtocol": "Http",
"probeIntervalInSeconds": 120
},
"origins": [
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
},
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
}
],
"responseBasedOriginErrorDetectionSettings": {
"responseBasedDetectedErrorTypes": "TcpErrorsOnly",
"responseBasedFailoverThresholdPercentage": 10
}
}
}
],
"contentTypesToCompress": [
"text/html",
"application/octet-stream"
],
"isCompressionEnabled": true,
"optimizationType": null,
"probePath": null,
"geoFilters": [],
"deliveryPolicy": {
"description": "Test description for a policy.",
"rules": [
{
"name": "rule1",
"order": 1,
"conditions": [
{
"name": "RemoteAddress",
"parameters": {
"typeName": "DeliveryRuleRemoteAddressConditionParameters",
"operator": "IPMatch",
"negateCondition": true,
"matchValues": [
"192.168.1.0/24",
"10.0.0.0/24"
],
"transforms": []
}
}
],
"actions": [
{
"name": "CacheExpiration",
"parameters": {
"typeName": "DeliveryRuleCacheExpirationActionParameters",
"cacheBehavior": "Override",
"cacheDuration": "10:10:09",
"cacheType": "All"
}
},
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Access-Control-Allow-Origin",
"value": "*"
}
},
{
"name": "ModifyRequestHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Accept-Encoding",
"value": "gzip"
}
}
]
}
]
}
}
}
{
"name": "endpoint4899",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
"type": "Microsoft.Cdn/profiles/endpoints",
"tags": {
"kay1": "value1"
},
"location": "WestUs",
"properties": {
"hostName": "endpoint4899.azureedge-test.net",
"originHostHeader": "www.bing.com",
"provisioningState": "Creating",
"resourceState": "Creating",
"isHttpAllowed": true,
"isHttpsAllowed": true,
"queryStringCachingBehavior": "BypassCaching",
"originPath": "/photos",
"defaultOriginGroup": {
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
},
"origins": [
{
"name": "origin1",
"properties": {
"hostName": "www.someDomain1.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain1.net",
"priority": 1,
"weight": 50,
"enabled": true
}
},
{
"name": "origin2",
"properties": {
"hostName": "www.someDomain2.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain2.net",
"priority": 2,
"weight": 50,
"enabled": true
}
}
],
"originGroups": [
{
"name": "originGroup1",
"properties": {
"healthProbeSettings": {
"probePath": "/health.aspx",
"probeRequestType": "GET",
"probeProtocol": "Http",
"probeIntervalInSeconds": 120
},
"origins": [
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
},
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
}
],
"responseBasedOriginErrorDetectionSettings": {
"responseBasedDetectedErrorTypes": "TcpErrorsOnly",
"responseBasedFailoverThresholdPercentage": 10
}
}
}
],
"contentTypesToCompress": [
"text/html",
"application/octet-stream"
],
"isCompressionEnabled": true,
"optimizationType": null,
"probePath": null,
"geoFilters": [],
"deliveryPolicy": {
"description": "Test description for a policy.",
"rules": [
{
"name": "rule1",
"order": 1,
"conditions": [
{
"name": "RemoteAddress",
"parameters": {
"typeName": "DeliveryRuleRemoteAddressConditionParameters",
"operator": "IPMatch",
"negateCondition": true,
"matchValues": [
"192.168.1.0/24",
"10.0.0.0/24"
],
"transforms": []
}
}
],
"actions": [
{
"name": "CacheExpiration",
"parameters": {
"typeName": "DeliveryRuleCacheExpirationActionParameters",
"cacheBehavior": "Override",
"cacheDuration": "10:10:09",
"cacheType": "All"
}
},
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Access-Control-Allow-Origin",
"value": "*"
}
},
{
"name": "ModifyRequestHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Accept-Encoding",
"value": "gzip"
}
}
]
}
]
}
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01
{
"name": "endpoint4899",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1",
"type": "Microsoft.Cdn/profiles/endpoints",
"tags": {
"kay1": "value1"
},
"location": "WestUs",
"properties": {
"hostName": "endpoint4899.azureedge-test.net",
"originHostHeader": "www.bing.com",
"provisioningState": "Creating",
"resourceState": "Creating",
"isHttpAllowed": true,
"isHttpsAllowed": true,
"queryStringCachingBehavior": "BypassCaching",
"originPath": "/photos",
"defaultOriginGroup": {
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/originGroups/originGroup1"
},
"origins": [
{
"name": "origin1",
"properties": {
"hostName": "www.someDomain1.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain1.net",
"priority": 1,
"weight": 50,
"enabled": true
}
},
{
"name": "origin2",
"properties": {
"hostName": "www.someDomain2.net",
"httpPort": 80,
"httpsPort": 443,
"originHostHeader": "www.someDomain2.net",
"priority": 2,
"weight": 50,
"enabled": true
}
}
],
"originGroups": [
{
"name": "originGroup1",
"properties": {
"healthProbeSettings": {
"probePath": "/health.aspx",
"probeRequestType": "GET",
"probeProtocol": "Http",
"probeIntervalInSeconds": 120
},
"origins": [
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin1"
},
{
"id": "/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/origins/origin2"
}
],
"responseBasedOriginErrorDetectionSettings": {
"responseBasedDetectedErrorTypes": "TcpErrorsOnly",
"responseBasedFailoverThresholdPercentage": 10
}
}
}
],
"contentTypesToCompress": [
"text/html",
"application/octet-stream"
],
"isCompressionEnabled": true,
"optimizationType": null,
"probePath": null,
"geoFilters": [],
"deliveryPolicy": {
"description": "Test description for a policy.",
"rules": [
{
"name": "rule1",
"order": 1,
"conditions": [
{
"name": "RemoteAddress",
"parameters": {
"typeName": "DeliveryRuleRemoteAddressConditionParameters",
"operator": "IPMatch",
"negateCondition": true,
"matchValues": [
"192.168.1.0/24",
"10.0.0.0/24"
],
"transforms": []
}
}
],
"actions": [
{
"name": "CacheExpiration",
"parameters": {
"typeName": "DeliveryRuleCacheExpirationActionParameters",
"cacheBehavior": "Override",
"cacheDuration": "10:10:09",
"cacheType": "All"
}
},
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Access-Control-Allow-Origin",
"value": "*"
}
},
{
"name": "ModifyRequestHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "Accept-Encoding",
"value": "gzip"
}
}
]
}
]
}
}
}
Definitions
Name | Description |
---|---|
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 |
Deep |
Custom domains created on the CDN endpoint. |
Deep |
The main origin of CDN content which is added when creating a CDN endpoint. |
Deep |
The origin group for CDN content which is added when creating a CDN endpoint. Traffic is sent to the origins within the origin group based on origin health. |
Delivery |
A policy that specifies the delivery rules to be used for an endpoint. |
Delivery |
A rule that specifies a set of actions and conditions |
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. |
Destination |
Protocol to use for the redirect. The default value is MatchRequest |
Endpoint |
CDN endpoint is the entity within a CDN profile containing configuration information such as origin, protocol, content caching and delivery behavior. The CDN endpoint uses the URL format .azureedge.net. |
Endpoint |
Provisioning status of the endpoint. |
Endpoint |
Resource status of the endpoint. |
Error |
The resource management error additional info. |
Error |
The error detail. |
Error |
Error response |
Forwarding |
Protocol this rule will use when forwarding traffic to backends. |
Geo |
Rules defining user's geo access within a CDN endpoint. |
Geo |
Action of the geo filter, i.e. allow or block access. |
Header |
Action to perform |
Header |
Defines the parameters for the request header action. |
Health |
The JSON object that contains the properties to send health probes to origin. |
Health |
The type of health probe request that is made. |
Host |
Defines the parameters for HostName match conditions |
Host |
Describes operator to be matched |
Http |
The JSON object that represents the range for http status codes |
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 |
The match value for the condition of the delivery rule |
Is |
Describes operator to be matched |
Key |
Describes the parameters for using a user's KeyVault for URL Signing Key. |
Key |
|
Optimization |
Specifies what scenario the customer wants this CDN endpoint to optimize, e.g. Download, Media services. With this information we can apply scenario driven optimization. |
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 |
Private |
The approval status for the connection to the Private Link |
Probe |
Protocol to use for health probe. |
query |
Caching behavior for the requests |
Query |
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL. |
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 |
The match value for the condition of the delivery rule |
Request |
Describes operator to be matched |
Request |
Defines the parameters for RequestScheme match conditions |
Request |
The match value for the condition of the delivery rule |
Request |
Defines the parameters for RequestUri match conditions |
Request |
Describes operator to be matched |
Resource |
Reference to another resource. |
Response |
Type of response errors for real user requests for which origin will be deemed unhealthy |
Response |
The JSON object that contains the properties to determine origin health using real requests/responses. |
Route |
Defines the parameters for the route configuration override action. |
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. |
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 |
Url signing key |
Url |
Defines how to identify a parameter for a specific purpose e.g. expires |
Web |
Defines the Web Application Firewall policy for the endpoint (if applicable) |
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
DeepCreatedCustomDomain
Custom domains created on the CDN endpoint.
Name | Type | Description |
---|---|---|
name |
string |
Custom domain name. |
properties.hostName |
string |
The host name of the custom domain. Must be a domain name. |
properties.validationData |
string |
Special validation or data may be required when delivering CDN to some regions due to local compliance reasons. E.g. ICP license number of a custom domain is required to deliver content in China. |
DeepCreatedOrigin
The main origin of CDN content which is added when creating a CDN endpoint.
Name | Type | Description |
---|---|---|
name |
string |
Origin name which must be unique within the endpoint. |
properties.enabled |
boolean |
Origin is enabled for load balancing or not. By default, origin is always enabled. |
properties.hostName |
string |
The address of the origin. It can be a domain name, IPv4 address, or IPv6 address. This should be unique across all origins in an endpoint. |
properties.httpPort |
integer |
The value of the HTTP port. Must be between 1 and 65535. |
properties.httpsPort |
integer |
The value of the HTTPS port. Must be between 1 and 65535. |
properties.originHostHeader |
string |
The host header value sent to the origin with each request. If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default. |
properties.priority |
integer |
Priority of origin in given origin group for load balancing. Higher priorities will not be used for load balancing if any lower priority origin is healthy.Must be between 1 and 5. |
properties.privateEndpointStatus |
The approval status for the connection to the Private Link |
|
properties.privateLinkAlias |
string |
The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' |
properties.privateLinkApprovalMessage |
string |
A custom message to be included in the approval request to connect to the Private Link. |
properties.privateLinkLocation |
string |
The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated |
properties.privateLinkResourceId |
string |
The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' |
properties.weight |
integer |
Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 |
DeepCreatedOriginGroup
The origin group for CDN content which is added when creating a CDN endpoint. Traffic is sent to the origins within the origin group based on origin health.
Name | Type | Description |
---|---|---|
name |
string |
Origin group name which must be unique within the endpoint. |
properties.healthProbeSettings |
Health probe settings to the origin that is used to determine the health of the origin. |
|
properties.origins |
The source of the content being delivered via CDN within given origin group. |
|
properties.responseBasedOriginErrorDetectionSettings |
The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. |
|
properties.trafficRestorationTimeToHealedOrNewEndpointsInMinutes |
integer |
Time in minutes to shift the traffic to the endpoint gradually when an unhealthy endpoint comes healthy or a new endpoint is added. Default is 10 mins. This property is currently not supported. |
DeliveryPolicy
A policy that specifies the delivery rules to be used for an endpoint.
Name | Type | Description |
---|---|---|
description |
string |
User-friendly description of the policy. |
rules |
A list of the delivery rules. |
DeliveryRule
A rule that specifies a set of actions and conditions
Name | Type | Description |
---|---|---|
actions | DeliveryRuleAction[]: |
A list of actions that are executed when all the conditions of a rule are satisfied. |
conditions |
DeliveryRuleCondition[]:
|
A list of conditions that must be matched for the actions to be executed |
name |
string |
Name of the rule |
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. |
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. |
DestinationProtocol
Protocol to use for the redirect. The default value is MatchRequest
Name | Type | Description |
---|---|---|
Http |
string |
|
Https |
string |
|
MatchRequest |
string |
Endpoint
CDN endpoint is the entity within a CDN profile containing configuration information such as origin, protocol, content caching and delivery behavior. The CDN endpoint uses the URL format .azureedge.net.
Name | Type | Default value | Description |
---|---|---|---|
id |
string |
Resource ID. |
|
location |
string |
Resource location. |
|
name |
string |
Resource name. |
|
properties.contentTypesToCompress |
string[] |
List of content types on which compression applies. The value should be a valid MIME type. |
|
properties.customDomains |
The custom domains under the endpoint. |
||
properties.defaultOriginGroup |
A reference to the origin group. |
||
properties.deliveryPolicy |
A policy that specifies the delivery rules to be used for an endpoint. |
||
properties.geoFilters |
List of rules defining the user's geo access within a CDN endpoint. Each geo filter defines an access rule to a specified path or content, e.g. block APAC for path /pictures/ |
||
properties.hostName |
string |
The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net |
|
properties.isCompressionEnabled |
boolean |
Indicates whether content compression is enabled on CDN. Default value is false. If compression is enabled, content will be served as compressed if user requests for a compressed version. Content won't be compressed on CDN when requested content is smaller than 1 byte or larger than 1 MB. |
|
properties.isHttpAllowed |
boolean |
True |
Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
properties.isHttpsAllowed |
boolean |
True |
Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
properties.optimizationType |
Specifies what scenario the customer wants this CDN endpoint to optimize for, e.g. Download, Media services. With this information, CDN can apply scenario driven optimization. |
||
properties.originGroups |
The origin groups comprising of origins that are used for load balancing the traffic based on availability. |
||
properties.originHostHeader |
string |
The host header value sent to the origin with each request. This property at Endpoint is only allowed when endpoint uses single origin and can be overridden by the same property specified at origin.If you leave this blank, the request hostname determines this value. Azure CDN origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default. |
|
properties.originPath |
string |
A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath. |
|
properties.origins |
The source of the content being delivered via CDN. |
||
properties.probePath |
string |
Path to a file hosted on the origin which helps accelerate delivery of the dynamic content and calculate the most optimal routes for the CDN. This is relative to the origin path. This property is only relevant when using a single origin. |
|
properties.provisioningState |
Provisioning status of the endpoint. |
||
properties.queryStringCachingBehavior | NotSet |
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL. |
|
properties.resourceState |
Resource status of the endpoint. |
||
properties.urlSigningKeys |
List of keys used to validate the signed URL hashes. |
||
properties.webApplicationFirewallPolicyLink |
Defines the Web Application Firewall policy for the endpoint (if applicable) |
||
systemData |
Read only system data |
||
tags |
object |
Resource tags. |
|
type |
string |
Resource type. |
EndpointProvisioningState
Provisioning status of the endpoint.
Name | Type | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
EndpointResourceState
Resource status of the endpoint.
Name | Type | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Running |
string |
|
Starting |
string |
|
Stopped |
string |
|
Stopping |
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. |
ErrorResponse
Error response
Name | Type | Description |
---|---|---|
error |
The error object. |
ForwardingProtocol
Protocol this rule will use when forwarding traffic to backends.
Name | Type | Description |
---|---|---|
HttpOnly |
string |
|
HttpsOnly |
string |
|
MatchRequest |
string |
GeoFilter
Rules defining user's geo access within a CDN endpoint.
Name | Type | Description |
---|---|---|
action |
Action of the geo filter, i.e. allow or block access. |
|
countryCodes |
string[] |
Two letter country or region codes defining user country or region access in a geo filter, e.g. AU, MX, US. |
relativePath |
string |
Relative path applicable to geo filter. (e.g. '/mypictures', '/mypicture/kitty.jpg', and etc.) |
GeoFilterActions
Action of the geo filter, i.e. allow or block access.
Name | Type | Description |
---|---|---|
Allow |
string |
|
Block |
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 |
string:
Delivery |
|
value |
string |
Value for the specified action |
HealthProbeParameters
The JSON object that contains the properties to send health probes to origin.
Name | Type | Description |
---|---|---|
probeIntervalInSeconds |
integer |
The number of seconds between health probes.Default is 240sec. |
probePath |
string |
The path relative to the origin that is used to determine the health of the origin. |
probeProtocol |
Protocol to use for health probe. |
|
probeRequestType |
The type of health probe request that is made. |
HealthProbeRequestType
The type of health probe request that is made.
Name | Type | Description |
---|---|---|
GET |
string |
|
HEAD |
string |
|
NotSet |
string |
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 |
string:
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 |
HttpErrorRangeParameters
The JSON object that represents the range for http status codes
Name | Type | Description |
---|---|---|
begin |
integer |
The inclusive start of the http status code range. |
end |
integer |
The inclusive end of the http status code range. |
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 |
string:
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 |
string:
Delivery |
IsDeviceMatchValue
The match value for the condition of the delivery rule
Name | Type | Description |
---|---|---|
Desktop |
string |
|
Mobile |
string |
IsDeviceOperator
Describes operator to be matched
Name | Type | Description |
---|---|---|
Equal |
string |
KeyVaultSigningKeyParameters
Describes the parameters for using a user's KeyVault for URL Signing Key.
Name | Type | Description |
---|---|---|
resourceGroupName |
string |
Resource group of the user's Key Vault containing the secret |
secretName |
string |
The name of secret in Key Vault. |
secretVersion |
string |
The version(GUID) of secret in Key Vault. |
subscriptionId |
string |
Subscription Id of the user's Key Vault containing the secret |
typeName | ||
vaultName |
string |
The name of the user's Key Vault containing the secret |
KeyVaultSigningKeyParametersType
Name | Type | Description |
---|---|---|
KeyVaultSigningKeyParameters |
string |
OptimizationType
Specifies what scenario the customer wants this CDN endpoint to optimize, e.g. Download, Media services. With this information we can apply scenario driven optimization.
Name | Type | Description |
---|---|---|
DynamicSiteAcceleration |
string |
|
GeneralMediaStreaming |
string |
|
GeneralWebDelivery |
string |
|
LargeFileDownload |
string |
|
VideoOnDemandMediaStreaming |
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 |
string:
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 |
string:
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 |
PrivateEndpointStatus
The approval status for the connection to the Private Link
Name | Type | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
|
Timeout |
string |
ProbeProtocol
Protocol to use for health probe.
Name | Type | Description |
---|---|---|
Http |
string |
|
Https |
string |
|
NotSet |
string |
queryStringBehavior
Caching behavior for the requests
Name | Type | Description |
---|---|---|
Exclude |
string |
|
ExcludeAll |
string |
|
Include |
string |
|
IncludeAll |
string |
QueryStringCachingBehavior
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.
Name | Type | Description |
---|---|---|
BypassCaching |
string |
|
IgnoreQueryString |
string |
|
NotSet |
string |
|
UseQueryString |
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
Delivery |
RequestMethodMatchValue
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 |
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 |
string:
Delivery |
RequestSchemeMatchValue
The match value for the condition of the delivery rule
Name | Type | Description |
---|---|---|
HTTP |
string |
|
HTTPS |
string |
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 |
string:
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. |
ResponseBasedDetectedErrorTypes
Type of response errors for real user requests for which origin will be deemed unhealthy
Name | Type | Description |
---|---|---|
None |
string |
|
TcpAndHttpErrors |
string |
|
TcpErrorsOnly |
string |
ResponseBasedOriginErrorDetectionParameters
The JSON object that contains the properties to determine origin health using real requests/responses.
Name | Type | Description |
---|---|---|
httpErrorRanges |
The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. |
|
responseBasedDetectedErrorTypes |
Type of response errors for real user requests for which origin will be deemed unhealthy |
|
responseBasedFailoverThresholdPercentage |
integer |
The percentage of failed requests in the sample where failover should trigger. |
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 |
string:
Delivery |
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 |
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
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 |
string:
Delivery |
UrlSigningKey
Url signing key
Name | Type | Description |
---|---|---|
keyId |
string |
Defines the customer defined key Id. This id will exist in the incoming request to indicate the key used to form the hash. |
keySourceParameters |
Defines the parameters for using customer key vault for Url Signing Key. |
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 |
WebApplicationFirewallPolicyLink
Defines the Web Application Firewall policy for the endpoint (if applicable)
Name | Type | Description |
---|---|---|
id |
string |
Resource ID. |