Microsoft.Cdn (stable:2025-04-15)

2025/06/04 • 112 updated methods

CheckEndpointNameAvailability (updated)
Description :  Check the availability of a resource name. This is needed for resources where name is globally unique, such as a afdx endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckEndpointNameAvailability",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/checkEndpointNameAvailability
{
checkEndpointNameAvailabilityInput:
{
Description: Input to check. ,
Required: True ,
}
{
name:
{
Description: The resource name to validate. ,
Required: True ,
}
string ,
type:
{
Description: The type of the resource whose name is to be validated. ,
Enum:
{
Microsoft.Cdn/Profiles/Endpoints: No description available. ,
Microsoft.Cdn/Profiles/AfdEndpoints: No description available. ,
}
,
Required: True ,
}
enum ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates whether the name is available. ,
Required: False ,
}
boolean ,
availableHostname:
{
Description: Returns the available hostname generated based on the AutoGeneratedDomainNameLabelScope when the name is available, otherwise it returns empty string ,
Required: False ,
}
string ,
reason:
{
Description: The reason why the name is not available. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the name is not available. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDProfiles_CheckEndpointNameAvailability (updated)
Description :  Check the availability of an afdx endpoint name, and return the globally unique endpoint host name.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDProfiles_CheckEndpointNameAvailability",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkEndpointNameAvailability
{
checkEndpointNameAvailabilityInput:
{
Description: Input to check. ,
Required: True ,
}
{
name:
{
Description: The resource name to validate. ,
Required: True ,
}
string ,
type:
{
Description: The type of the resource whose name is to be validated. ,
Enum:
{
Microsoft.Cdn/Profiles/Endpoints: No description available. ,
Microsoft.Cdn/Profiles/AfdEndpoints: No description available. ,
}
,
Required: True ,
}
enum ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates whether the name is available. ,
Required: False ,
}
boolean ,
availableHostname:
{
Description: Returns the available hostname generated based on the AutoGeneratedDomainNameLabelScope when the name is available, otherwise it returns empty string ,
Required: False ,
}
string ,
reason:
{
Description: The reason why the name is not available. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the name is not available. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDProfiles_ListResourceUsage (updated)
Description :  Checks the quota and actual usage of endpoints under the given Azure Front Door profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDProfiles_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/usages
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of resource usages. ,
Required: False ,
}
[
{
id:
{
Description: Resource identifier. ,
Required: False ,
}
string ,
unit:
{
Description: An enum describing the unit of measurement. ,
Enum:
{
Count: No description available. ,
}
,
Required: True ,
}
enum ,
currentValue:
{
Description: The current value of the usage. ,
Format: int64 ,
Required: True ,
}
integer ,
limit:
{
Description: The limit of usage. ,
Format: int64 ,
Required: True ,
}
integer ,
name:
{
Description: The name of the type of usage. ,
Required: True ,
}
{
value:
{
Description: A string describing the resource name. ,
Required: False ,
}
string ,
localizedValue:
{
Description: A localized string describing the resource name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDProfiles_CheckHostNameAvailability (updated)
Description :  Validates the custom domain mapping to ensure it maps to the correct Azure Front Door endpoint in DNS.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDProfiles_CheckHostNameAvailability",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkHostNameAvailability
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
checkHostNameAvailabilityInput:
{
Description: Custom domain to be validated. ,
Required: True ,
}
{
hostName:
{
Description: The host name to validate. ,
Required: True ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates whether the name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the name is not available. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the name is not available. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDProfiles_ValidateSecret (updated)
Description :  Validate a Secret in the profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDProfiles_ValidateSecret",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/validateSecret
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
validateSecretInput:
{
Description: The Secret source. ,
Required: True ,
}
{
secretType:
{
Description: The secret type. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
secretSource:
{
Description: Resource reference to the Azure Key Vault secret. Expected to be in format of /subscriptions/{​​​​​​​​​subscriptionId}​​​​​​​​​/resourceGroups/{​​​​​​​​​resourceGroupName}​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​/providers/Microsoft.KeyVault/vaults/{vaultName}​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​/secrets/{secretName}​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​ ,
Required: True ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
secretVersion:
{
Description: Secret version, if customer is using a specific version. ,
Required: False ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
status:
{
Description: The validation status. ,
Enum:
{
Valid: No description available. ,
Invalid: No description available. ,
AccessDenied: No description available. ,
CertificateExpired: No description available. ,
}
,
Required: False ,
}
enum ,
message:
{
Description: Detailed error message ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDProfiles_Upgrade (updated)
Description :  Upgrade a profile from Standard_AzureFrontDoor to Premium_AzureFrontDoor.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDProfiles_Upgrade",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/upgrade
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
profileUpgradeParameters:
{
Description: Profile upgrade input parameter. ,
Required: True ,
}
{
wafMappingList:
{
Description: Web Application Firewall (WAF) and security policy mapping for the profile upgrade ,
Required: True ,
}
[
{
securityPolicyName:
{
Description: The security policy name. ,
Required: True ,
}
string ,
changeToWafPolicy:
{
Description: The new waf resource for the security policy to use. ,
Required: True ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: A profile is a logical grouping of endpoints that share the same settings. ,
}
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_ListByProfile (updated)
Description :  Lists existing AzureFrontDoor domains.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor domains within a profile. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of domain objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_Get (updated)
Description :  Gets an existing AzureFrontDoor domain with the specified domain name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the domain under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_Create (updated)
Description :  Creates a new domain within the specified profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the domain under the profile which is unique globally ,
Required: True ,
}
string ,
customDomain:
{
Description: Domain properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (201)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (202)

{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_Update (updated)
Description :  Updates an existing domain within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the domain under the profile which is unique globally ,
Required: True ,
}
string ,
customDomainUpdateProperties:
{
Description: Domain properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the domain. ,
Required: False ,
}
string ,
tlsSettings:
{
Description: The configuration specifying how to enable HTTPS for the domain - using AzureFrontDoor managed certificate or user's own certificate. If not specified, enabling ssl uses AzureFrontDoor managed certificate by default. ,
Required: False ,
}
{
certificateType:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
cipherSuiteSetType:
{
Description: cipher suite set type that will be used for Https ,
Enum:
{
Customized: No description available. ,
TLS10_2019: No description available. ,
TLS12_2022: No description available. ,
TLS12_2023: No description available. ,
}
,
Required: False ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https when cipherSuiteSetType is Customized. ,
Enum:
{
TLS10: No description available. ,
TLS12: No description available. ,
TLS13: No description available. ,
}
,
Required: False ,
}
enum ,
customizedCipherSuiteSet:
{
Description: Customized cipher suites object that will be used for Https when cipherSuiteSetType is Customized. ,
Required: False ,
}
{
cipherSuiteSetForTls12:
{
Description: Cipher suites for TLS 1.2. Required at least one in minimumTlsVersion TLS 1.2. ,
Required: False ,
}
[
string ,
]
,
cipherSuiteSetForTls13:
{
Description: Cipher suites for TLS 1.3. Required at least one in minimumTlsVersion TLS 1.2, TLS 1.3. ,
Required: False ,
}
[
string ,
]
,
}
,
secret:
{
Description: Resource reference to the secret. ie. subs/rg/profile/secret ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
azureDnsZone:
{
Description: Resource reference to the Azure DNS zone ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
preValidatedCustomDomainResourceId:
{
Description: Resource reference to the Azure resource where custom domain ownership was prevalidated ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
domainValidationState:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. DCV stands for DomainControlValidation. ,
Enum:
{
Unknown: No description available. ,
Submitting: No description available. ,
Pending: No description available. ,
Rejected: No description available. ,
TimedOut: No description available. ,
PendingRevalidation: No description available. ,
Approved: No description available. ,
RefreshingValidationToken: No description available. ,
InternalError: No description available. ,
}
,
Required: False ,
}
enum ,
hostName:
{
Description: The host name of the domain. Must be a domain name. ,
Required: True ,
}
string ,
extendedProperties:
{
Description: Key-Value pair representing migration properties for domains. ,
Required: False ,
}
object ,
validationProperties:
{
Description: Values the customer needs to validate domain ownership ,
Required: False ,
}
{
validationToken:
{
Description: Challenge used for DNS TXT record or file based validation ,
Required: False ,
}
string ,
expirationDate:
{
Description: The date time that the token expires ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_Delete (updated)
Description :  Deletes an existing AzureFrontDoor domain with the specified domain name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the domain under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDCustomDomains_RefreshValidationToken (updated)
Description :  Updates the domain validation token.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDCustomDomains_RefreshValidationToken",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/customDomains/{customDomainName}/refreshValidationToken
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the domain under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_ListByProfile (updated)
Description :  Lists existing AzureFrontDoor endpoints.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor endpoints within a profile ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of endpoint objects if there is any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_Get (updated)
Description :  Gets an existing AzureFrontDoor endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_Create (updated)
Description :  Creates a new AzureFrontDoor endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
endpoint:
{
Description: Endpoint properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Azure Front Door endpoint is the entity within a Azure Front Door profile containing configuration information such as origin, protocol, content caching and delivery behavior. The AzureFrontDoor endpoint uses the URL format .azureedge.net. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_Update (updated)
Description :  Updates an existing AzureFrontDoor endpoint with the specified endpoint name under the specified subscription, resource group and profile. Only tags can be updated after creating an endpoint. To update origins, use the Update Origin operation. To update origin groups, use the Update Origin group operation. To update domains, use the Update Custom Domain operation.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
endpointUpdateProperties:
{
Description: Endpoint update properties ,
Required: True ,
}
{
tags:
{
Description: Endpoint tags. ,
Required: False ,
}
object ,
properties:
{
Description: The JSON object containing endpoint update parameters. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the endpoint. ,
Required: False ,
}
string ,
enabledState:
{
Description: Whether to enable use of this rule. Permitted values are 'Enabled' or 'Disabled' ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Azure Front Door endpoint is the entity within a Azure Front Door profile containing configuration information such as origin, protocol, content caching and delivery behavior. The AzureFrontDoor endpoint uses the URL format .azureedge.net. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
autoGeneratedDomainNameLabelScope:
{
Description: Indicates the endpoint name reuse scope. The default value is TenantReuse. ,
Enum:
{
TenantReuse: No description available. ,
SubscriptionReuse: No description available. ,
ResourceGroupReuse: No description available. ,
NoReuse: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_Delete (updated)
Description :  Deletes an existing AzureFrontDoor endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_PurgeContent (updated)
Description :  Removes a content from AzureFrontDoor.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_PurgeContent",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/purge
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
contents:
{
Description: The list of paths to the content and the list of linked domains to be purged. Path can be a full URL, e.g. '/pictures/city.png' which removes a single file, or a directory with a wildcard, e.g. '/pictures/*' which removes all folders and files in the directory. ,
Required: True ,
}
{
contentPaths:
{
Description: The path to the content to be purged. Can describe a file path or a wild card directory. ,
Required: True ,
}
[
string ,
]
,
domains:
{
Description: List of domains. ,
Required: False ,
}
[
string ,
]
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_ListResourceUsage (updated)
Description :  Checks the quota and actual usage of endpoints under the given Azure Front Door profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/usages
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of resource usages. ,
Required: False ,
}
[
{
id:
{
Description: Resource identifier. ,
Required: False ,
}
string ,
unit:
{
Description: An enum describing the unit of measurement. ,
Enum:
{
Count: No description available. ,
}
,
Required: True ,
}
enum ,
currentValue:
{
Description: The current value of the usage. ,
Format: int64 ,
Required: True ,
}
integer ,
limit:
{
Description: The limit of usage. ,
Format: int64 ,
Required: True ,
}
integer ,
name:
{
Description: The name of the type of usage. ,
Required: True ,
}
{
value:
{
Description: A string describing the resource name. ,
Required: False ,
}
string ,
localizedValue:
{
Description: A localized string describing the resource name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDEndpoints_ValidateCustomDomain (updated)
Description :  Validates the custom domain mapping to ensure it maps to the correct Azure Front Door endpoint in DNS.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDEndpoints_ValidateCustomDomain",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/validateCustomDomain
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainProperties:
{
Description: Custom domain to be validated. ,
Required: True ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
customDomainValidated:
{
Description: Indicates whether the custom domain is valid or not. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the custom domain is not valid. ,
Required: False ,
}
string ,
message:
{
Description: Error message describing why the custom domain is not valid. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_ListByProfile (updated)
Description :  Lists all of the existing origin groups within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of Azure Front Door origin groups within an Azure Front Door endpoint ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of origin objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_Get (updated)
Description :  Gets an existing origin group within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_Create (updated)
Description :  Creates a new origin group within the specified profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
originGroup:
{
Description: Origin group properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: AFDOrigin group comprising of origins is used for load balancing to origins when the content cannot be served from Azure Front Door. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_Update (updated)
Description :  Updates an existing origin group within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
originGroupUpdateProperties:
{
Description: Origin group properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the origin group. ,
Required: False ,
}
string ,
loadBalancingSettings:
{
Description: Load balancing settings for a backend pool ,
Required: False ,
}
{
sampleSize:
{
Description: The number of samples to consider for load balancing decisions ,
Format: int32 ,
Required: False ,
}
integer ,
successfulSamplesRequired:
{
Description: The number of samples within the sample period that must succeed ,
Format: int32 ,
Required: False ,
}
integer ,
additionalLatencyInMilliseconds:
{
Description: The additional latency in milliseconds for probes to fall into the lowest latency bucket ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
sessionAffinityState:
{
Description: Whether to allow session affinity on this host. Valid options are 'Enabled' or 'Disabled' ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: AFDOrigin group comprising of origins is used for load balancing to origins when the content cannot be served from Azure Front Door. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_Delete (updated)
Description :  Deletes an existing origin group within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOriginGroups_ListResourceUsage (updated)
Description :  Checks the quota and actual usage of endpoints under the given Azure Front Door profile..
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOriginGroups_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/usages
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of resource usages. ,
Required: False ,
}
[
{
id:
{
Description: Resource identifier. ,
Required: False ,
}
string ,
unit:
{
Description: An enum describing the unit of measurement. ,
Enum:
{
Count: No description available. ,
}
,
Required: True ,
}
enum ,
currentValue:
{
Description: The current value of the usage. ,
Format: int64 ,
Required: True ,
}
integer ,
limit:
{
Description: The limit of usage. ,
Format: int64 ,
Required: True ,
}
integer ,
name:
{
Description: The name of the type of usage. ,
Required: True ,
}
{
value:
{
Description: A string describing the resource name. ,
Required: False ,
}
string ,
localizedValue:
{
Description: A localized string describing the resource name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOrigins_ListByOriginGroup (updated)
Description :  Lists all of the existing origins within an origin group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOrigins_ListByOriginGroup",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of Azure Front Door origins within an Azure Front Door endpoint ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of origin objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOrigins_Get (updated)
Description :  Gets an existing origin within an origin group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOrigins_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOrigins_Create (updated)
Description :  Creates a new origin within the specified origin group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOrigins_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin that is unique within the profile. ,
Required: True ,
}
string ,
origin:
{
Description: Origin properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Azure Front Door origin is the source of the content being delivered via Azure Front Door. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOrigins_Update (updated)
Description :  Updates an existing origin within an origin group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOrigins_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the profile. ,
Required: True ,
}
string ,
originUpdateProperties:
{
Description: Origin properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
originGroupName:
{
Description: The name of the origin group which contains this origin. ,
Required: False ,
}
string ,
azureOrigin:
{
Description: Resource reference to the Azure origin resource. ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
hostName:
{
Description: The address of the origin. Domain names, IPv4 addresses, and IPv6 addresses are supported.This should be unique across all origins in an endpoint. ,
Required: False ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: The host header value sent to the origin with each request. If you leave this blank, the request hostname determines this value. Azure Front Door origins, such as Web Apps, Blob Storage, and Cloud Services require this host header value to match the origin hostname by default. This overrides the host header defined at Endpoint ,
Required: False ,
}
string ,
priority:
{
Description: 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 ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
sharedPrivateLinkResource:
{
Description: The properties of the private link resource for private origin. ,
Required: False ,
}
{
privateLink:
{
Description: The resource id of the resource the shared private link resource is for. ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
privateLinkLocation:
{
Description: The location of the shared private link resource ,
Required: False ,
}
string ,
groupId:
{
Description: The group id from the provider of resource the shared private link resource is for. ,
Required: False ,
}
string ,
requestMessage:
{
Description: The request message for requesting approval of the shared private link resource. ,
Required: False ,
}
string ,
status:
{
Description: Status of the shared private link resource. Can be Pending, Approved, Rejected, Disconnected, or Timeout. ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
enabledState:
{
Description: Whether to enable health probes to be made against backends defined under backendPools. Health probes can only be disabled if there is a single enabled backend in single enabled backend pool. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
enforceCertificateNameCheck:
{
Description: Whether to enable certificate name check at origin level ,
Required: False ,
}
boolean ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Azure Front Door origin is the source of the content being delivered via Azure Front Door. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
AFDOrigins_Delete (updated)
Description :  Deletes an existing origin within an origin group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "AFDOrigins_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/originGroups/{originGroupName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the profile. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Routes_ListByEndpoint (updated)
Description :  Lists all of the existing origins within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Routes_ListByEndpoint",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor routes within a profile. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of route objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Routes_Get (updated)
Description :  Gets an existing route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Routes_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
routeName:
{
Description: Name of the routing rule. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Routes_Create (updated)
Description :  Creates a new route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Routes_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
routeName:
{
Description: Name of the routing rule. ,
Required: True ,
}
string ,
route:
{
Description: Route properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly Routes name mapping to the any Routes or secret related information. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Routes_Update (updated)
Description :  Updates an existing route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Routes_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
routeName:
{
Description: Name of the routing rule. ,
Required: True ,
}
string ,
routeUpdateProperties:
{
Description: Route update properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the domain to create. ,
Required: False ,
}
{
endpointName:
{
Description: The name of the endpoint which holds the route. ,
Required: False ,
}
string ,
customDomains:
{
Description: Domains referenced by this endpoint. ,
Required: False ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
isActive:
{
Description: Whether the resource is active or inactive ,
Required: False ,
}
boolean ,
}
,
]
,
originGroup:
{
Description: A reference to the origin group. ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
originPath:
{
Description: A directory path on the origin that AzureFrontDoor can use to retrieve content from, e.g. contoso.cloudapp.net/originpath. ,
Required: False ,
}
string ,
ruleSets:
{
Description: rule sets referenced by this endpoint. ,
Required: False ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
supportedProtocols:
{
Description: List of supported protocols for this route. ,
Required: False ,
}
[
string ,
]
,
patternsToMatch:
{
Description: The route patterns of the rule. ,
Required: False ,
}
[
string ,
]
,
cacheConfiguration:
{
Description: The caching configuration for this route. To disable caching, do not provide a cacheConfiguration object. ,
Required: False ,
}
{
queryStringCachingBehavior:
{
Description: 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. ,
Enum:
{
IgnoreQueryString: No description available. ,
UseQueryString: No description available. ,
IgnoreSpecifiedQueryStrings: No description available. ,
IncludeSpecifiedQueryStrings: No description available. ,
}
,
Required: False ,
}
enum ,
queryParameters:
{
Description: query parameters to include or exclude (comma separated). ,
Required: False ,
}
string ,
compressionSettings:
{
Description: compression settings. ,
Required: False ,
}
{
contentTypesToCompress:
{
Description: List of content types on which compression applies. The value should be a valid MIME type. ,
Required: False ,
}
[
string ,
]
,
isCompressionEnabled:
{
Description: Indicates whether content compression is enabled on AzureFrontDoor. 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 AzureFrontDoor when requested content is smaller than 1 byte or larger than 1 MB. ,
Required: False ,
}
boolean ,
}
,
}
,
forwardingProtocol:
{
Description: Protocol this rule will use when forwarding traffic to backends. ,
Enum:
{
HttpOnly: No description available. ,
HttpsOnly: No description available. ,
MatchRequest: No description available. ,
}
,
Required: False ,
}
enum ,
linkToDefaultDomain:
{
Description: whether this route will be linked to the default endpoint domain. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
httpsRedirect:
{
Description: Whether to automatically redirect HTTP traffic to HTTPS traffic. Note that this is a easy way to set up this rule and it will be the first rule that gets executed. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
enabledState:
{
Description: Whether to enable use of this rule. Permitted values are 'Enabled' or 'Disabled' ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly Routes name mapping to the any Routes or secret related information. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Routes to create. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Routes_Delete (updated)
Description :  Deletes an existing route with the specified route name under the specified subscription, resource group, profile, and AzureFrontDoor endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Routes_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}/routes/{routeName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
routeName:
{
Description: Name of the routing rule. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
RuleSets_ListByProfile (updated)
Description :  Lists existing AzureFrontDoor rule sets within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RuleSets_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor rule sets within a profile. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the Rule Set to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the rule set. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of rule set objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
RuleSets_Get (updated)
Description :  Gets an existing AzureFrontDoor rule set with the specified rule set name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RuleSets_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Rule Set to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the rule set. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
RuleSets_Create (updated)
Description :  Creates a new rule set within the specified profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RuleSets_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile which is unique globally ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Rule Set to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the rule set. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the Rule Set to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the rule set. ,
Required: False ,
}
string ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
RuleSets_Delete (updated)
Description :  Deletes an existing AzureFrontDoor rule set with the specified rule set name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "RuleSets_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
RuleSets_ListResourceUsage (updated)
Description :  Checks the quota and actual usage of endpoints under the given Azure Front Door profile..
Reference :  Link ¶

⚶ Changes

{
  "#id": "RuleSets_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/usages
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: The list of resource usages. ,
Required: False ,
}
[
{
id:
{
Description: Resource identifier. ,
Required: False ,
}
string ,
unit:
{
Description: An enum describing the unit of measurement. ,
Enum:
{
Count: No description available. ,
}
,
Required: True ,
}
enum ,
currentValue:
{
Description: The current value of the usage. ,
Format: int64 ,
Required: True ,
}
integer ,
limit:
{
Description: The limit of usage. ,
Format: int64 ,
Required: True ,
}
integer ,
name:
{
Description: The name of the type of usage. ,
Required: True ,
}
{
value:
{
Description: A string describing the resource name. ,
Required: False ,
}
string ,
localizedValue:
{
Description: A localized string describing the resource name. ,
Required: False ,
}
string ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of results. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Rules_ListByRuleSet (updated)
Description :  Lists all of the existing delivery rules within a rule set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Rules_ListByRuleSet",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor rules within a rule set. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of rule objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Rules_Get (updated)
Description :  Gets an existing delivery rule within a rule set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Rules_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile. ,
Required: True ,
}
string ,
ruleName:
{
Description: Name of the delivery rule which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Rules_Create (updated)
Description :  Creates a new delivery rule within the specified rule set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Rules_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile. ,
Required: True ,
}
string ,
ruleName:
{
Description: Name of the delivery rule which is unique within the endpoint. ,
Required: True ,
}
string ,
rule:
{
Description: The delivery rule properties. ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly Rules name mapping to the any Rules or secret related information. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Rules_Update (updated)
Description :  Updates an existing delivery rule within a rule set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Rules_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile. ,
Required: True ,
}
string ,
ruleName:
{
Description: Name of the delivery rule which is unique within the endpoint. ,
Required: True ,
}
string ,
ruleUpdateProperties:
{
Description: Delivery rule properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the rule to update. ,
Required: False ,
}
{
ruleSetName:
{
Description: The name of the rule set containing the rule. ,
Required: False ,
}
string ,
order:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
conditions:
{
Description: A list of conditions that must be matched for the actions to be executed ,
Required: False ,
}
[
{
name:
{
Description: The name of the condition for the delivery rule. ,
Enum:
{
RemoteAddress: No description available. ,
RequestMethod: No description available. ,
QueryString: No description available. ,
PostArgs: No description available. ,
RequestUri: No description available. ,
RequestHeader: No description available. ,
RequestBody: No description available. ,
RequestScheme: No description available. ,
UrlPath: No description available. ,
UrlFileExtension: No description available. ,
UrlFileName: No description available. ,
HttpVersion: No description available. ,
Cookies: No description available. ,
IsDevice: No description available. ,
SocketAddr: No description available. ,
ClientPort: No description available. ,
ServerPort: No description available. ,
HostName: No description available. ,
SslProtocol: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
actions:
{
Description: A list of actions that are executed when all the conditions of a rule are satisfied. ,
Required: False ,
}
[
{
name:
{
Description: The name of the action for the delivery rule. ,
Enum:
{
CacheExpiration: No description available. ,
CacheKeyQueryString: No description available. ,
ModifyRequestHeader: No description available. ,
ModifyResponseHeader: No description available. ,
UrlRedirect: No description available. ,
UrlRewrite: No description available. ,
UrlSigning: No description available. ,
OriginGroupOverride: No description available. ,
RouteConfigurationOverride: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
matchProcessingBehavior:
{
Description: If this rule is a match should the rules engine continue running the remaining rules or stop. If not present, defaults to Continue. ,
Enum:
{
Continue: No description available. ,
Stop: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly Rules name mapping to the any Rules or secret related information. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Rules to create. ,
Required: False ,
}
object ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Rules_Delete (updated)
Description :  Deletes an existing delivery rule within a rule set.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Rules_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
ruleSetName:
{
Description: Name of the rule set under the profile. ,
Required: True ,
}
string ,
ruleName:
{
Description: Name of the delivery rule which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SecurityPolicies_ListByProfile (updated)
Description :  Lists security policies associated with the profile
Reference :  Link ¶

⚶ Changes

{
  "#id": "SecurityPolicies_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/securityPolicies
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of Security policies within a profile ,
Required: False ,
}
[
{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of security policy objects if there is any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SecurityPolicies_Get (updated)
Description :  Gets an existing security policy within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SecurityPolicies_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/securityPolicies/{securityPolicyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
securityPolicyName:
{
Description: Name of the security policy under the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SecurityPolicies_Create (updated)
Description :  Creates a new security policy within the specified profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SecurityPolicies_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/securityPolicies/{securityPolicyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
securityPolicyName:
{
Description: Name of the security policy under the profile. ,
Required: True ,
}
string ,
securityPolicy:
{
Description: The security policy properties. ,
Required: True ,
}
{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: SecurityPolicy association for AzureFrontDoor profile ,
}
{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SecurityPolicies_Patch (updated)
Description :  Updates an existing security policy within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SecurityPolicies_Patch",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/securityPolicies/{securityPolicyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
securityPolicyName:
{
Description: Name of the security policy under the profile. ,
Required: True ,
}
string ,
securityPolicyUpdateProperties:
{
Description: Security policy update properties ,
Required: True ,
}
{
properties:
{
Description: The json object that contains properties required to update a security policy ,
Required: False ,
}
{
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: SecurityPolicy association for AzureFrontDoor profile ,
}
{
properties:
{
Description: The json object that contains properties required to create a security policy ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the security policy. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains security policy parameters ,
Required: False ,
}
{
type:
{
Description: The type of the Security policy to create. ,
Enum:
{
WebApplicationFirewall: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
SecurityPolicies_Delete (updated)
Description :  Deletes an existing security policy within profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "SecurityPolicies_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/securityPolicies/{securityPolicyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
securityPolicyName:
{
Description: Name of the security policy under the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Secrets_ListByProfile (updated)
Description :  Lists existing AzureFrontDoor secrets.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Secrets_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/secrets
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of AzureFrontDoor secrets within a profile. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of Secret objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Secrets_Get (updated)
Description :  Gets an existing Secret within a profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Secrets_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/secrets/{secretName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
secretName:
{
Description: Name of the Secret under the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Secrets_Create (updated)
Description :  Creates a new Secret within the specified profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Secrets_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/secrets/{secretName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
secretName:
{
Description: Name of the Secret under the profile. ,
Required: True ,
}
string ,
secret:
{
Description: The Secret properties. ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly Secret name mapping to the any Secret or secret related information. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the Secret to create. ,
Required: False ,
}
{
profileName:
{
Description: The name of the profile which holds the secret. ,
Required: False ,
}
string ,
parameters:
{
Description: object which contains secret parameters ,
Required: False ,
}
{
type:
{
Description: The type of the secret resource. ,
Enum:
{
UrlSigningKey: No description available. ,
CustomerCertificate: No description available. ,
ManagedCertificate: No description available. ,
AzureFirstPartyManagedCertificate: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Secrets_Delete (updated)
Description :  Deletes an existing Secret within profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Secrets_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/secrets/{secretName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium which is unique within the resource group. ,
Required: True ,
}
string ,
secretName:
{
Description: Name of the Secret under the profile. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetLogAnalyticsMetrics (updated)
Description :  Get log report for AFD profile
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetLogAnalyticsMetrics",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsMetrics
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
metrics:
{
Required: True ,
}
array ,
dateTimeBegin:
{
Format: date-time ,
Required: True ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: True ,
}
string ,
granularity:
{
Required: True ,
}
string ,
groupBy:
{
Required: False ,
}
array ,
continents:
{
Required: False ,
}
array ,
countryOrRegions:
{
Required: False ,
}
array ,
customDomains:
{
Required: True ,
}
array ,
protocols:
{
Required: True ,
}
array ,
}

⚐ Response (200)

{
dateTimeBegin:
{
Format: date-time ,
Required: False ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: False ,
}
string ,
granularity:
{
Enum:
{
PT5M: No description available. ,
PT1H: No description available. ,
P1D: No description available. ,
}
,
Required: False ,
}
enum ,
series:
{
Required: False ,
}
[
{
metric:
{
Required: False ,
}
string ,
unit:
{
Enum:
{
count: No description available. ,
bytes: No description available. ,
bitsPerSecond: No description available. ,
milliSeconds: No description available. ,
}
,
Required: False ,
}
enum ,
groups:
{
Required: False ,
}
[
{
name:
{
Required: False ,
}
string ,
value:
{
Required: False ,
}
string ,
}
,
]
,
data:
{
Required: False ,
}
[
{
dateTime:
{
Format: date-time ,
Required: False ,
}
string ,
value:
{
Required: False ,
}
number ,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetLogAnalyticsRankings (updated)
Description :  Get log analytics ranking report for AFD profile
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetLogAnalyticsRankings",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsRankings
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
rankings:
{
Required: True ,
}
array ,
metrics:
{
Required: True ,
}
array ,
maxRanking:
{
Format: int32 ,
Required: True ,
}
integer ,
dateTimeBegin:
{
Format: date-time ,
Required: True ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: True ,
}
string ,
customDomains:
{
Required: False ,
}
array ,
}

⚐ Response (200)

{
dateTimeBegin:
{
Format: date-time ,
Required: False ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: False ,
}
string ,
tables:
{
Required: False ,
}
[
{
ranking:
{
Required: False ,
}
string ,
data:
{
Required: False ,
}
[
{
name:
{
Required: False ,
}
string ,
metrics:
{
Required: False ,
}
[
{
metric:
{
Required: False ,
}
string ,
value:
{
Format: int64 ,
Required: False ,
}
integer ,
percentage:
{
Required: False ,
}
number ,
}
,
]
,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetLogAnalyticsLocations (updated)
Description :  Get all available location names for AFD log analytics report.
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetLogAnalyticsLocations",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsLocations
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
continents:
{
Required: False ,
}
[
{
id:
{
Required: False ,
}
string ,
}
,
]
,
countryOrRegions:
{
Required: False ,
}
[
{
id:
{
Required: False ,
}
string ,
continentId:
{
Required: False ,
}
string ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetLogAnalyticsResources (updated)
Description :  Get all endpoints and custom domains available for AFD log report
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetLogAnalyticsResources",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getLogAnalyticsResources
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
endpoints:
{
Required: False ,
}
[
{
id:
{
Required: False ,
}
string ,
name:
{
Required: False ,
}
string ,
history:
{
Required: False ,
}
boolean ,
customDomains:
{
Required: False ,
}
[
{
id:
{
Required: False ,
}
string ,
name:
{
Required: False ,
}
string ,
endpointId:
{
Required: False ,
}
string ,
history:
{
Required: False ,
}
boolean ,
}
,
]
,
}
,
]
,
customDomains:
{
Required: False ,
}
[
{
id:
{
Required: False ,
}
string ,
name:
{
Required: False ,
}
string ,
endpointId:
{
Required: False ,
}
string ,
history:
{
Required: False ,
}
boolean ,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetWafLogAnalyticsMetrics (updated)
Description :  Get Waf related log analytics report for AFD profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetWafLogAnalyticsMetrics",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getWafLogAnalyticsMetrics
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
metrics:
{
Required: True ,
}
array ,
dateTimeBegin:
{
Format: date-time ,
Required: True ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: True ,
}
string ,
granularity:
{
Required: True ,
}
string ,
actions:
{
Required: False ,
}
array ,
groupBy:
{
Required: False ,
}
array ,
ruleTypes:
{
Required: False ,
}
array ,
}

⚐ Response (200)

{
dateTimeBegin:
{
Format: date-time ,
Required: False ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: False ,
}
string ,
granularity:
{
Enum:
{
PT5M: No description available. ,
PT1H: No description available. ,
P1D: No description available. ,
}
,
Required: False ,
}
enum ,
series:
{
Required: False ,
}
[
{
metric:
{
Required: False ,
}
string ,
unit:
{
Enum:
{
count: No description available. ,
}
,
Required: False ,
}
enum ,
groups:
{
Required: False ,
}
[
{
name:
{
Required: False ,
}
string ,
value:
{
Required: False ,
}
string ,
}
,
]
,
data:
{
Required: False ,
}
[
{
dateTime:
{
Format: date-time ,
Required: False ,
}
string ,
value:
{
Required: False ,
}
number ,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
LogAnalytics_GetWafLogAnalyticsRankings (updated)
Description :  Get WAF log analytics charts for AFD profile
Reference :  Link ¶

⚶ Changes

{
  "#id": "LogAnalytics_GetWafLogAnalyticsRankings",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ]
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getWafLogAnalyticsRankings
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium profile which is unique within the resource group. which is unique within the resource group. ,
Required: True ,
}
string ,
metrics:
{
Required: True ,
}
array ,
dateTimeBegin:
{
Format: date-time ,
Required: True ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: True ,
}
string ,
maxRanking:
{
Format: int32 ,
Required: True ,
}
integer ,
rankings:
{
Required: True ,
}
array ,
actions:
{
Required: False ,
}
array ,
ruleTypes:
{
Required: False ,
}
array ,
}

⚐ Response (200)

{
dateTimeBegin:
{
Format: date-time ,
Required: False ,
}
string ,
dateTimeEnd:
{
Format: date-time ,
Required: False ,
}
string ,
groups:
{
Required: False ,
}
[
string ,
]
,
data:
{
Required: False ,
}
[
{
groupValues:
{
Required: False ,
}
[
string ,
]
,
metrics:
{
Required: False ,
}
[
{
metric:
{
Required: False ,
}
string ,
value:
{
Format: int64 ,
Required: False ,
}
integer ,
percentage:
{
Format: double ,
Required: False ,
}
number ,
}
,
]
,
}
,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_List (updated)
Description :  Lists all of the Azure Front Door Standard, Azure Front Door Premium, and CDN profiles within an Azure subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Cdn/profiles
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN profiles within a resource group. ,
Required: False ,
}
[
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of profile objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_ListByResourceGroup (updated)
Description :  Lists all of the Azure Front Door Standard, Azure Front Door Premium, and CDN profiles within a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_ListByResourceGroup",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN profiles within a resource group. ,
Required: False ,
}
[
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of profile objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_Get (updated)
Description :  Gets an Azure Front Door Standard or Azure Front Door Premium or CDN profile with the specified profile name under the specified subscription and resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_Create (updated)
Description :  Creates a new Azure Front Door Standard or Azure Front Door Premium or CDN profile with a profile name under the specified subscription and resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
profile:
{
Description: Profile properties needed to create a new profile. ,
Required: True ,
}
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}

⚐ Response (201)

{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: A profile is a logical grouping of endpoints that share the same settings. ,
}
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_Update (updated)
Description :  Updates an existing Azure Front Door Standard or Azure Front Door Premium or CDN profile with the specified profile name under the specified subscription and resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
profileUpdateParameters:
{
Description: Profile properties needed to update an existing profile. ,
Required: True ,
}
{
tags:
{
Description: Profile tags ,
Required: False ,
}
object ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object containing profile update parameters. ,
Required: False ,
}
{
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules to scrub sensitive fields in logs ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: A profile is a logical grouping of endpoints that share the same settings. ,
}
{
sku:
{
Description: The pricing tier (defines Azure Front Door Standard or Premium or a CDN provider, feature list and rate) of the profile. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
kind:
{
Description: Kind of the profile. Used by portal to differentiate traditional CDN profile and new AFD profile. ,
Required: False ,
}
string ,
identity:
{
Description: Managed service identity (system assigned and/or user assigned identities). ,
Required: False ,
}
{
principalId:
{
Description: The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
tenantId:
{
Description: The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity. ,
Format: uuid ,
Required: False ,
}
string ,
type:
{
Description: Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed). ,
Enum:
{
None: No description available. ,
SystemAssigned: No description available. ,
UserAssigned: No description available. ,
SystemAssigned, UserAssigned: No description available. ,
}
,
Required: True ,
}
enum ,
userAssignedIdentities:
{
Description: The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests. ,
Required: False ,
}
object ,
}
,
properties:
{
Description: The JSON object that contains the properties required to create a profile. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the profile. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
Disabled: No description available. ,
Migrating: No description available. ,
Migrated: No description available. ,
PendingMigrationCommit: No description available. ,
CommittingMigration: No description available. ,
AbortingMigration: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the profile. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
extendedProperties:
{
Description: Key-Value pair representing additional properties for profiles. ,
Required: False ,
}
object ,
frontDoorId:
{
Description: The Id of the frontdoor. ,
Required: False ,
}
string ,
originResponseTimeoutSeconds:
{
Description: Send and receive timeout on forwarding request to the origin. When timeout is reached, the request fails and returns. ,
Format: int32 ,
Required: False ,
}
integer ,
logScrubbing:
{
Description: Defines rules that scrub sensitive fields in the Azure Front Door profile logs. ,
Required: False ,
}
{
state:
{
Description: State of the log scrubbing config. Default value is Enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
scrubbingRules:
{
Description: List of log scrubbing rules applied to the Azure Front Door profile logs. ,
Required: False ,
}
[
{
matchVariable:
{
Description: The variable to be scrubbed from the logs. ,
Enum:
{
RequestIPAddress: No description available. ,
RequestUri: No description available. ,
QueryStringArgNames: No description available. ,
}
,
Required: True ,
}
enum ,
selectorMatchOperator:
{
Description: When matchVariable is a collection, operate on the selector to specify which elements in the collection this rule applies to. ,
Enum:
{
EqualsAny: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: When matchVariable is a collection, operator used to specify which elements in the collection this rule applies to. ,
Required: False ,
}
string ,
state:
{
Description: Defines the state of a log scrubbing rule. Default value is enabled. ,
Enum:
{
Enabled: No description available. ,
Disabled: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_Delete (updated)
Description :  Deletes an existing Azure Front Door Standard or Azure Front Door Premium or CDN profile with the specified parameters. Deleting a profile will result in the deletion of all of the sub-resources including endpoints, origins and custom domains.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_CanMigrate (updated)
Description :  Checks if CDN profile can be migrated to Azure Frontdoor(Standard/Premium) profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_CanMigrate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/canMigrate
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
canMigrateParameters:
{
Description: Properties needed to check if cdn profile or classic frontdoor can be migrated. ,
Required: True ,
}
{
classicResourceReference:
{
Description: Resource reference of the classic cdn profile or classic frontdoor that need to be migrated. ,
Required: True ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (200)

{
id:
{
Description: Resource ID. ,
Format: arm-id ,
Required: False ,
}
string ,
type:
{
Description: Resource type. ,
Required: False ,
}
string ,
properties:
{
Required: False ,
}
{
canMigrate:
{
Description: Flag that says if the profile can be migrated ,
Required: False ,
}
boolean ,
defaultSku:
{
Description: Recommended sku for the migration ,
Enum:
{
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
}
,
Required: False ,
}
enum ,
errors:
{
Required: False ,
}
[
{
code:
{
Description: Error code. ,
Required: False ,
}
string ,
resourceName:
{
Description: Resource which has the problem. ,
Required: False ,
}
string ,
errorMessage:
{
Description: Error message indicating why the operation failed. ,
Required: False ,
}
string ,
nextSteps:
{
Description: Describes what needs to be done to fix the problem ,
Required: False ,
}
string ,
}
,
]
,
}
,
}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_Migrate (updated)
Description :  Migrate the CDN profile to Azure Frontdoor(Standard/Premium) profile. The change need to be committed after this.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_Migrate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/migrate
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
migrationParameters:
{
Description: Properties needed to migrate the profile. ,
Required: True ,
}
{
sku:
{
Description: Sku for the migration ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
classicResourceReference:
{
Description: Resource reference of the classic cdn profile or classic frontdoor that need to be migrated. ,
Required: True ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
profileName:
{
Description: Name of the new profile that need to be created. ,
Required: True ,
}
string ,
migrationWebApplicationFirewallMappings:
{
Description: Waf mapping for the migrated profile ,
Required: False ,
}
[
{
migratedFrom:
{
Description: Migration From Waf policy ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
migratedTo:
{
Description: Migration to Waf policy ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
]
,
}
,
}

⚐ Response (200)

{
id:
{
Description: Resource ID. ,
Format: arm-id ,
Required: False ,
}
string ,
type:
{
Description: Resource type. ,
Required: False ,
}
string ,
properties:
{
Required: False ,
}
{
migratedProfileResourceId:
{
Description: Arm resource id of the migrated profile ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Result for migrate operation. ,
}
{
id:
{
Description: Resource ID. ,
Format: arm-id ,
Required: False ,
}
string ,
type:
{
Description: Resource type. ,
Required: False ,
}
string ,
properties:
{
Required: False ,
}
{
migratedProfileResourceId:
{
Description: Arm resource id of the migrated profile ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_MigrationCommit (updated)
Description :  Commit the migrated Azure Frontdoor(Standard/Premium) profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_MigrationCommit",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/migrationCommit
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_GenerateSsoUri (updated)
Description :  Generates a dynamic SSO URI used to sign in to the CDN supplemental portal. Supplemental portal is used to configure advanced feature capabilities that are not yet available in the Azure portal, such as core reports in a standard profile; rules engine, advanced HTTP reports, and real-time stats and alerts in a premium profile. The SSO URI changes approximately every 10 minutes.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_GenerateSsoUri",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/generateSsoUri
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
ssoUriValue:
{
Description: The URI used to login to the supplemental portal. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_ListSupportedOptimizationTypes (updated)
Description :  Gets the supported optimization types for the current profile. A user can create an endpoint with an optimization type from the listed values.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_ListSupportedOptimizationTypes",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/getSupportedOptimizationTypes
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
supportedOptimizationTypes:
{
Description: Supported optimization types for a profile. ,
Required: False ,
}
[
string ,
]
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Profiles_ListResourceUsage (updated)
Description :  Checks the quota and actual usage of endpoints under the given Azure Front Door Standard or Azure Front Door Premium or CDN profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Profiles_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkResourceUsage
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the Azure Front Door Standard or Azure Front Door Premium or CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of resource usages. ,
Required: False ,
}
[
{
resourceType:
{
Description: Resource type for which the usage is provided. ,
Required: False ,
}
string ,
unit:
{
Description: Unit of the usage. e.g. count. ,
Enum:
{
count: No description available. ,
}
,
Required: False ,
}
enum ,
currentValue:
{
Description: Actual value of usage on the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
limit:
{
Description: Quota of the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of custom domain objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_ListByProfile (updated)
Description :  Lists existing CDN endpoints.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_ListByProfile",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN endpoints within a profile ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of endpoint objects if there is any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Get (updated)
Description :  Gets an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Create (updated)
Description :  Creates a new CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
endpoint:
{
Description: Endpoint properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: 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. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Update (updated)
Description :  Updates an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile. Only tags can be updated after creating an endpoint. To update origins, use the Update Origin operation. To update origin groups, use the Update Origin group operation. To update custom domains, use the Update Custom Domain operation.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
endpointUpdateProperties:
{
Description: Endpoint update properties ,
Required: True ,
}
{
tags:
{
Description: Endpoint tags. ,
Required: False ,
}
object ,
properties:
{
Description: The JSON object containing endpoint update parameters. ,
Required: False ,
}
{
originPath:
{
Description: A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath. ,
Required: False ,
}
string ,
contentTypesToCompress:
{
Description: List of content types on which compression applies. The value should be a valid MIME type. ,
Required: False ,
}
[
string ,
]
,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
isCompressionEnabled:
{
Description: 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. ,
Required: False ,
}
boolean ,
isHttpAllowed:
{
Description: Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. ,
Required: False ,
}
boolean ,
isHttpsAllowed:
{
Description: Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. ,
Required: False ,
}
boolean ,
queryStringCachingBehavior:
{
Description: 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. ,
Enum:
{
IgnoreQueryString: No description available. ,
BypassCaching: No description available. ,
UseQueryString: No description available. ,
NotSet: No description available. ,
}
,
Required: False ,
}
enum ,
optimizationType:
{
Description: 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. ,
Enum:
{
GeneralWebDelivery: No description available. ,
GeneralMediaStreaming: No description available. ,
VideoOnDemandMediaStreaming: No description available. ,
LargeFileDownload: No description available. ,
DynamicSiteAcceleration: No description available. ,
}
,
Required: False ,
}
enum ,
probePath:
{
Description: 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. ,
Required: False ,
}
string ,
geoFilters:
{
Description: 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/ ,
Required: False ,
}
[
{
relativePath:
{
Description: Relative path applicable to geo filter. (e.g. '/mypictures', '/mypicture/kitty.jpg', and etc.) ,
Required: True ,
}
string ,
action:
{
Description: Action of the geo filter, i.e. allow or block access. ,
Enum:
{
Block: No description available. ,
Allow: No description available. ,
}
,
Required: True ,
}
enum ,
countryCodes:
{
Description: Two letter country or region codes defining user country or region access in a geo filter, e.g. AU, MX, US. ,
Required: True ,
}
[
string ,
]
,
}
,
]
,
defaultOriginGroup:
{
Description: A reference to the origin group. ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
urlSigningKeys:
{
Description: List of keys used to validate the signed URL hashes. ,
Required: False ,
}
[
{
keyId:
{
Description: Defines the customer defined key Id. This id will exist in the incoming request to indicate the key used to form the hash. ,
Required: True ,
}
string ,
keySourceParameters:
{
Description: Defines the parameters for using customer key vault for Url Signing Key. ,
Required: True ,
}
{
typeName:
{
Enum:
{
KeyVaultSigningKeyParameters: No description available. ,
}
,
Required: True ,
}
enum ,
subscriptionId:
{
Description: Subscription Id of the user's Key Vault containing the secret ,
Required: True ,
}
string ,
resourceGroupName:
{
Description: Resource group of the user's Key Vault containing the secret ,
Required: True ,
}
string ,
vaultName:
{
Description: The name of the user's Key Vault containing the secret ,
Required: True ,
}
string ,
secretName:
{
Description: The name of secret in Key Vault. ,
Required: True ,
}
string ,
secretVersion:
{
Description: The version(GUID) of secret in Key Vault. ,
Required: True ,
}
string ,
}
,
}
,
]
,
deliveryPolicy:
{
Description: A policy that specifies the delivery rules to be used for an endpoint. ,
Required: False ,
}
{
description:
{
Description: User-friendly description of the policy. ,
Required: False ,
}
string ,
rules:
{
Description: A list of the delivery rules. ,
Required: True ,
}
[
{
name:
{
Description: Name of the rule ,
Required: False ,
}
string ,
order:
{
Description: 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. ,
Format: int32 ,
Required: True ,
}
integer ,
conditions:
{
Description: A list of conditions that must be matched for the actions to be executed ,
Required: False ,
}
[
{
name:
{
Description: The name of the condition for the delivery rule. ,
Enum:
{
RemoteAddress: No description available. ,
RequestMethod: No description available. ,
QueryString: No description available. ,
PostArgs: No description available. ,
RequestUri: No description available. ,
RequestHeader: No description available. ,
RequestBody: No description available. ,
RequestScheme: No description available. ,
UrlPath: No description available. ,
UrlFileExtension: No description available. ,
UrlFileName: No description available. ,
HttpVersion: No description available. ,
Cookies: No description available. ,
IsDevice: No description available. ,
SocketAddr: No description available. ,
ClientPort: No description available. ,
ServerPort: No description available. ,
HostName: No description available. ,
SslProtocol: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
actions:
{
Description: A list of actions that are executed when all the conditions of a rule are satisfied. ,
Required: True ,
}
[
{
name:
{
Description: The name of the action for the delivery rule. ,
Enum:
{
CacheExpiration: No description available. ,
CacheKeyQueryString: No description available. ,
ModifyRequestHeader: No description available. ,
ModifyResponseHeader: No description available. ,
UrlRedirect: No description available. ,
UrlRewrite: No description available. ,
UrlSigning: No description available. ,
OriginGroupOverride: No description available. ,
RouteConfigurationOverride: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
webApplicationFirewallPolicyLink:
{
Description: Defines the Web Application Firewall policy for the endpoint (if applicable) ,
Required: False ,
}
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: 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. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Delete (updated)
Description :  Deletes an existing CDN endpoint with the specified endpoint name under the specified subscription, resource group and profile.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Start (updated)
Description :  Starts an existing CDN endpoint that is on a stopped state.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Start",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/start
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: 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. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_Stop (updated)
Description :  Stops an existing running CDN endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_Stop",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/stop
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: 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. ,
}
{
properties:
{
Description: The JSON object that contains the properties required to create an endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net ,
Required: False ,
}
string ,
origins:
{
Description: The source of the content being delivered via CDN. ,
Required: True ,
}
[
{
name:
{
Description: Origin name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: 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. ,
Required: True ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. ,
Required: False ,
}
string ,
priority:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not. By default, origin is always enabled. ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
originGroups:
{
Description: The origin groups comprising of origins that are used for load balancing the traffic based on availability. ,
Required: False ,
}
[
{
name:
{
Description: Origin group name which must be unique within the endpoint. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the origin group created on the CDN endpoint. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: True ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses.This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
]
,
customDomains:
{
Description: The custom domains under the endpoint. ,
Required: False ,
}
[
{
name:
{
Description: Custom domain name. ,
Required: True ,
}
string ,
properties:
{
Description: Properties of the custom domain created on the CDN endpoint. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
}
,
}
,
]
,
resourceState:
{
Description: Resource status of the endpoint. ,
Enum:
{
Creating: No description available. ,
Deleting: No description available. ,
Running: No description available. ,
Starting: No description available. ,
Stopped: No description available. ,
Stopping: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the endpoint. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_PurgeContent (updated)
Description :  Removes a content from CDN.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_PurgeContent",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/purge
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
contentFilePaths:
{
Description: The path to the content to be purged. Path can be a full URL, e.g. '/pictures/city.png' which removes a single file, or a directory with a wildcard, e.g. '/pictures/*' which removes all folders and files in the directory. ,
Required: True ,
}
{
contentPaths:
{
Description: The path to the content to be purged. Can describe a file path or a wild card directory. ,
Required: True ,
}
[
string ,
]
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_LoadContent (updated)
Description :  Pre-loads a content to CDN. Available for Verizon Profiles.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_LoadContent",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/load
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
contentFilePaths:
{
Description: The path to the content to be loaded. Path should be a full URL, e.g. ‘/pictures/city.png' which loads a single file ,
Required: True ,
}
{
contentPaths:
{
Description: The path to the content to be loaded. Path should be a relative file URL of the origin. ,
Required: True ,
}
[
string ,
]
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_ValidateCustomDomain (updated)
Description :  Validates the custom domain mapping to ensure it maps to the correct CDN endpoint in DNS.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_ValidateCustomDomain",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/validateCustomDomain
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainProperties:
{
Description: Custom domain to be validated. ,
Required: True ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
customDomainValidated:
{
Description: Indicates whether the custom domain is valid or not. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the custom domain is not valid. ,
Required: False ,
}
string ,
message:
{
Description: Error message describing why the custom domain is not valid. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Endpoints_ListResourceUsage (updated)
Description :  Checks the quota and usage of geo filters and custom domains under the given endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Endpoints_ListResourceUsage",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/checkResourceUsage
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of resource usages. ,
Required: False ,
}
[
{
resourceType:
{
Description: Resource type for which the usage is provided. ,
Required: False ,
}
string ,
unit:
{
Description: Unit of the usage. e.g. count. ,
Enum:
{
count: No description available. ,
}
,
Required: False ,
}
enum ,
currentValue:
{
Description: Actual value of usage on the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
limit:
{
Description: Quota of the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of custom domain objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Origins_ListByEndpoint (updated)
Description :  Lists all of the existing origins within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Origins_ListByEndpoint",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN origins within an endpoint ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of origin objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Origins_Get (updated)
Description :  Gets an existing origin within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Origins_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Origins_Create (updated)
Description :  Creates a new origin within the specified endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Origins_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin that is unique within the endpoint. ,
Required: True ,
}
string ,
origin:
{
Description: Origin properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: CDN origin is the source of the content being delivered via CDN. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Origins_Update (updated)
Description :  Updates an existing origin within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Origins_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the endpoint. ,
Required: True ,
}
string ,
originUpdateProperties:
{
Description: Origin properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
hostName:
{
Description: The address of the origin. Domain names, IPv4 addresses, and IPv6 addresses are supported.This should be unique across all origins in an endpoint. ,
Required: False ,
}
string ,
httpPort:
{
Description: The value of the HTTP port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
httpsPort:
{
Description: The value of the HTTPS port. Must be between 1 and 65535. ,
Format: int32 ,
Required: False ,
}
integer ,
originHostHeader:
{
Description: 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. This overrides the host header defined at Endpoint ,
Required: False ,
}
string ,
priority:
{
Description: 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 ,
Format: int32 ,
Required: False ,
}
integer ,
weight:
{
Description: Weight of the origin in given origin group for load balancing. Must be between 1 and 1000 ,
Format: int32 ,
Required: False ,
}
integer ,
enabled:
{
Description: Origin is enabled for load balancing or not ,
Required: False ,
}
boolean ,
privateLinkAlias:
{
Description: The Alias of the Private Link resource. Populating this optional field indicates that this origin is 'Private' ,
Required: False ,
}
string ,
privateLinkResourceId:
{
Description: The Resource Id of the Private Link resource. Populating this optional field indicates that this backend is 'Private' ,
Required: False ,
}
string ,
privateLinkLocation:
{
Description: The location of the Private Link resource. Required only if 'privateLinkResourceId' is populated ,
Required: False ,
}
string ,
privateLinkApprovalMessage:
{
Description: A custom message to be included in the approval request to connect to the Private Link. ,
Required: False ,
}
string ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: CDN origin is the source of the content being delivered via CDN. When the edge nodes represented by an endpoint do not have the requested content cached, they attempt to fetch it from one or more of the configured origins. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
privateEndpointStatus:
{
Description: The approval status for the connection to the Private Link ,
Enum:
{
Pending: No description available. ,
Approved: No description available. ,
Rejected: No description available. ,
Disconnected: No description available. ,
Timeout: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Origins_Delete (updated)
Description :  Deletes an existing origin within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Origins_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/origins/{originName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originName:
{
Description: Name of the origin which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
OriginGroups_ListByEndpoint (updated)
Description :  Lists all of the existing origin groups within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OriginGroups_ListByEndpoint",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN origin groups within an endpoint ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of origin objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
OriginGroups_Get (updated)
Description :  Gets an existing origin group within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OriginGroups_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
OriginGroups_Create (updated)
Description :  Creates a new origin group within the specified endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OriginGroups_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
originGroup:
{
Description: Origin group properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Origin group comprising of origins is used for load balancing to origins when the content cannot be served from CDN. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
OriginGroups_Update (updated)
Description :  Updates an existing origin group within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OriginGroups_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
originGroupUpdateProperties:
{
Description: Origin group properties ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
healthProbeSettings:
{
Description: Health probe settings to the origin that is used to determine the health of the origin. ,
Required: False ,
}
{
probePath:
{
Description: The path relative to the origin that is used to determine the health of the origin. ,
Required: False ,
}
string ,
probeRequestType:
{
Description: The type of health probe request that is made. ,
Enum:
{
NotSet: No description available. ,
GET: No description available. ,
HEAD: No description available. ,
}
,
Required: False ,
}
enum ,
probeProtocol:
{
Description: Protocol to use for health probe. ,
Enum:
{
NotSet: No description available. ,
Http: No description available. ,
Https: No description available. ,
}
,
Required: False ,
}
enum ,
probeIntervalInSeconds:
{
Description: The number of seconds between health probes.Default is 240sec. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
origins:
{
Description: The source of the content being delivered via CDN within given origin group. ,
Required: False ,
}
[
{
id:
{
Description: Resource ID. ,
Required: False ,
}
string ,
}
,
]
,
trafficRestorationTimeToHealedOrNewEndpointsInMinutes:
{
Description: 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. ,
Format: int32 ,
Required: False ,
}
integer ,
responseBasedOriginErrorDetectionSettings:
{
Description: The JSON object that contains the properties to determine origin health using real requests/responses. This property is currently not supported. ,
Required: False ,
}
{
responseBasedDetectedErrorTypes:
{
Description: Type of response errors for real user requests for which origin will be deemed unhealthy ,
Enum:
{
None: No description available. ,
TcpErrorsOnly: No description available. ,
TcpAndHttpErrors: No description available. ,
}
,
Required: False ,
}
enum ,
responseBasedFailoverThresholdPercentage:
{
Description: The percentage of failed requests in the sample where failover should trigger. ,
Format: int32 ,
Required: False ,
}
integer ,
httpErrorRanges:
{
Description: The list of Http status code ranges that are considered as server errors for origin and it is marked as unhealthy. ,
Required: False ,
}
[
{
begin:
{
Description: The inclusive start of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
end:
{
Description: The inclusive end of the http status code range. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Origin group comprising of origins is used for load balancing to origins when the content cannot be served from CDN. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the origin group. ,
Required: False ,
}
{
resourceState:
{
Description: Resource status of the origin group. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
provisioningState:
{
Description: Provisioning status of the origin group. ,
Enum:
{
Succeeded: No description available. ,
Failed: No description available. ,
Updating: No description available. ,
Deleting: No description available. ,
Creating: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
OriginGroups_Delete (updated)
Description :  Deletes an existing origin group within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "OriginGroups_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/originGroups/{originGroupName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
originGroupName:
{
Description: Name of the origin group which is unique within the endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
location: string ,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_ListByEndpoint (updated)
Description :  Lists all of the existing custom domains within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_ListByEndpoint",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN CustomDomains within an endpoint. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of custom domain objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_Get (updated)
Description :  Gets an existing custom domain within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the custom domain within an endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_Create (updated)
Description :  Creates a new custom domain within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_Create",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the custom domain within an endpoint. ,
Required: True ,
}
string ,
customDomainProperties:
{
Description: Properties required to create a new custom domain. ,
Required: True ,
}
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
}
,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_Delete (updated)
Description :  Deletes an existing custom domain within an endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the custom domain within an endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_DisableCustomHttps (updated)
Description :  Disable https delivery of the custom domain.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_DisableCustomHttps",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/disableCustomHttps
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the custom domain within an endpoint. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CustomDomains_EnableCustomHttps (updated)
Description :  Enable https delivery of the custom domain.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CustomDomains_EnableCustomHttps",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/endpoints/{endpointName}/customDomains/{customDomainName}/enableCustomHttps
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
profileName:
{
Description: Name of the CDN profile which is unique within the resource group. ,
Required: True ,
}
string ,
endpointName:
{
Description: Name of the endpoint under the profile which is unique globally. ,
Required: True ,
}
string ,
customDomainName:
{
Description: Name of the custom domain within an endpoint. ,
Required: True ,
}
string ,
customDomainHttpsParameters:
{
Description: The configuration specifying how to enable HTTPS for the custom domain - using CDN managed certificate or user's own certificate. If not specified, enabling ssl uses CDN managed certificate by default. ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Friendly domain name mapping to the endpoint hostname that the customer provides for branding purposes, e.g. www.contoso.com. ,
}
{
properties:
{
Description: The JSON object that contains the properties of the custom domain to create. ,
Required: False ,
}
{
hostName:
{
Description: The host name of the custom domain. Must be a domain name. ,
Required: True ,
}
string ,
resourceState:
{
Description: Resource status of the custom domain. ,
Enum:
{
Creating: No description available. ,
Active: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningState:
{
Description: Provisioning status of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsProvisioningSubstate:
{
Description: Provisioning substate shows the progress of custom HTTPS enabling/disabling process step by step. ,
Enum:
{
SubmittingDomainControlValidationRequest: No description available. ,
PendingDomainControlValidationREquestApproval: No description available. ,
DomainControlValidationRequestApproved: No description available. ,
DomainControlValidationRequestRejected: No description available. ,
DomainControlValidationRequestTimedOut: No description available. ,
IssuingCertificate: No description available. ,
DeployingCertificate: No description available. ,
CertificateDeployed: No description available. ,
DeletingCertificate: No description available. ,
CertificateDeleted: No description available. ,
}
,
Required: False ,
}
enum ,
customHttpsParameters:
{
Description: Certificate parameters for securing custom HTTPS ,
Required: False ,
}
{
certificateSource:
{
Description: Defines the source of the SSL certificate. ,
Enum:
{
AzureKeyVault: No description available. ,
Cdn: No description available. ,
}
,
Required: True ,
}
enum ,
protocolType:
{
Description: Defines the TLS extension protocol that is used for secure delivery. ,
Enum:
{
ServerNameIndication: No description available. ,
IPBased: No description available. ,
}
,
Required: True ,
}
enum ,
minimumTlsVersion:
{
Description: TLS protocol version that will be used for Https ,
Enum:
{
None: No description available. ,
TLS10: No description available. ,
TLS12: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
validationData:
{
Description: 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. ,
Required: False ,
}
string ,
provisioningState:
{
Description: Provisioning status of Custom Https of the custom domain. ,
Enum:
{
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CheckNameAvailability (updated)
Description :  Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckNameAvailability",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /providers/Microsoft.Cdn/checkNameAvailability
{
checkNameAvailabilityInput:
{
Description: Input to check. ,
Required: True ,
}
{
name:
{
Description: The resource name to validate. ,
Required: True ,
}
string ,
type:
{
Description: The type of the resource whose name is to be validated. ,
Enum:
{
Microsoft.Cdn/Profiles/Endpoints: No description available. ,
Microsoft.Cdn/Profiles/AfdEndpoints: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates whether the name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the name is not available. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the name is not available. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
CheckNameAvailabilityWithSubscription (updated)
Description :  Check the availability of a resource name. This is needed for resources where name is globally unique, such as a CDN endpoint.
Reference :  Link ¶

⚶ Changes

{
  "#id": "CheckNameAvailabilityWithSubscription",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkNameAvailability
{
checkNameAvailabilityInput:
{
Description: Input to check. ,
Required: True ,
}
{
name:
{
Description: The resource name to validate. ,
Required: True ,
}
string ,
type:
{
Description: The type of the resource whose name is to be validated. ,
Enum:
{
Microsoft.Cdn/Profiles/Endpoints: No description available. ,
Microsoft.Cdn/Profiles/AfdEndpoints: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
nameAvailable:
{
Description: Indicates whether the name is available. ,
Required: False ,
}
boolean ,
reason:
{
Description: The reason why the name is not available. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the name is not available. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
ValidateProbe (updated)
Description :  Check if the probe path is a valid path and the file can be accessed. Probe path is the path to a file hosted on the origin server to help accelerate the delivery of dynamic content via the CDN endpoint. This path is relative to the origin path specified in the endpoint configuration.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ValidateProbe",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Cdn/validateProbe
{
validateProbeInput:
{
Description: Input to check. ,
Required: True ,
}
{
probeURL:
{
Description: The probe URL to validate. ,
Required: True ,
}
string ,
}
,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
isValid:
{
Description: Indicates whether the probe URL is accepted or not. ,
Required: False ,
}
boolean ,
errorCode:
{
Description: Specifies the error code when the probe url is not accepted. ,
Required: False ,
}
string ,
message:
{
Description: The detailed error message describing why the probe URL is not accepted. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
ResourceUsage_List (updated)
Description :  Check the quota and actual usage of the CDN profiles under the given subscription.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ResourceUsage_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

POST:  /subscriptions/{subscriptionId}/providers/Microsoft.Cdn/checkResourceUsage
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of resource usages. ,
Required: False ,
}
[
{
resourceType:
{
Description: Resource type for which the usage is provided. ,
Required: False ,
}
string ,
unit:
{
Description: Unit of the usage. e.g. count. ,
Enum:
{
count: No description available. ,
}
,
Required: False ,
}
enum ,
currentValue:
{
Description: Actual value of usage on the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
limit:
{
Description: Quota of the specified resource type. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
nextLink:
{
Description: URL to get the next set of custom domain objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Operations_List (updated)
Description :  Lists all of the available CDN REST API operations.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Operations_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Cdn/operations
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of CDN operations supported by the CDN resource provider. ,
Required: False ,
}
[
{
name:
{
Description: Operation name: {provider}/{resource}/{operation} ,
Required: False ,
}
string ,
isDataAction:
{
Description: Indicates whether the operation is a data action ,
Required: False ,
}
boolean ,
display:
{
Description: The object that represents the operation. ,
Required: False ,
}
{
provider:
{
Description: Service provider: Microsoft.Cdn ,
Required: False ,
}
string ,
resource:
{
Description: Resource on which the operation is performed: Profile, endpoint, etc. ,
Required: False ,
}
string ,
operation:
{
Description: Operation type: Read, write, delete, etc. ,
Required: False ,
}
string ,
description:
{
Description: Description of operation. ,
Required: False ,
}
string ,
}
,
origin:
{
Description: The origin of operations. ,
Required: False ,
}
string ,
properties:
{
Description: Properties of operation, include metric specifications. ,
Required: False ,
}
{
serviceSpecification:
{
Description: One property of operation, include metric specifications. ,
Required: False ,
}
{
logSpecifications:
{
Description: Log specifications of operation. ,
Required: False ,
}
[
{
name:
{
Description: Name of log specification. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of log specification. ,
Required: False ,
}
string ,
blobDuration:
{
Description: Blob duration of specification. ,
Required: False ,
}
string ,
logFilterPattern:
{
Description: Pattern to filter based on name ,
Required: False ,
}
string ,
}
,
]
,
metricSpecifications:
{
Description: Metric specifications of operation. ,
Required: False ,
}
[
{
name:
{
Description: Name of metric specification. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of metric specification. ,
Required: False ,
}
string ,
displayDescription:
{
Description: Display description of metric specification. ,
Required: False ,
}
string ,
unit:
{
Description: The metric unit. Possible values include: 'Bytes', 'Count', 'Milliseconds'. ,
Required: False ,
}
string ,
aggregationType:
{
Description: The metric aggregation type. Possible values include: 'Average', 'Count', 'Total'. ,
Required: False ,
}
string ,
availabilities:
{
Description: Retention policies of a resource metric. ,
Required: False ,
}
[
{
timeGrain:
{
Required: False ,
}
string ,
blobDuration:
{
Required: False ,
}
string ,
}
,
]
,
supportedTimeGrainTypes:
{
Description: The supported time grain types for the metrics. ,
Required: False ,
}
[
string ,
]
,
dimensions:
{
Description: The dimensions of metric ,
Required: False ,
}
[
{
name:
{
Description: Name of dimension. ,
Required: False ,
}
string ,
displayName:
{
Description: Display name of dimension. ,
Required: False ,
}
string ,
internalName:
{
Description: Internal name of dimension. ,
Required: False ,
}
string ,
}
,
]
,
fillGapWithZero:
{
Description: Property to specify whether to fill gap with zero. ,
Required: False ,
}
boolean ,
metricFilterPattern:
{
Description: Pattern to filter based on name ,
Required: False ,
}
string ,
isInternal:
{
Description: Property to specify metric is internal or not. ,
Required: False ,
}
boolean ,
}
,
]
,
}
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of operation list results if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
EdgeNodes_List (updated)
Description :  Edgenodes are the global Point of Presence (POP) locations used to deliver CDN content to end users.
Reference :  Link ¶

⚶ Changes

{
  "#id": "EdgeNodes_List",
  "$parameters": [
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "$properties": {
        "error": [
          {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        ]
      }
    }
  }
}

⚼ Request

GET:  /providers/Microsoft.Cdn/edgenodes
{
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: Edge node of CDN service. ,
Required: False ,
}
[
{
properties:
{
Description: The JSON object that contains the properties required to create an edgenode. ,
Required: False ,
}
{
ipAddressGroups:
{
Description: List of ip address groups. ,
Required: True ,
}
[
{
deliveryRegion:
{
Description: The delivery region of the ip address group ,
Required: False ,
}
string ,
ipv4Addresses:
{
Description: The list of ip v4 addresses. ,
Required: False ,
}
[
{
baseIpAddress:
{
Description: Ip address itself. ,
Required: False ,
}
string ,
prefixLength:
{
Description: The length of the prefix of the ip address. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
ipv6Addresses:
{
Description: The list of ip v6 addresses. ,
Required: False ,
}
[
{
baseIpAddress:
{
Description: Ip address itself. ,
Required: False ,
}
string ,
prefixLength:
{
Description: The length of the prefix of the ip address. ,
Format: int32 ,
Required: False ,
}
integer ,
}
,
]
,
}
,
]
,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of edgenode list results if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error detail. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Policies_List (updated)
Description :  Lists all of the protection policies within a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Policies_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/cdnWebApplicationFirewallPolicies
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of Azure CDN WebApplicationFirewallPolicies within a resource group. ,
Required: False ,
}
[
{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to get the next set of WebApplicationFirewallPolicy objects if there are any. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Policies_Get (updated)
Description :  Retrieve protection policy with specified name within a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Policies_Get",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/cdnWebApplicationFirewallPolicies/{policyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
policyName:
{
Description: The name of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Policies_CreateOrUpdate (updated)
Description :  Create or update policy with specified rule set name within a resource group.
Reference :  Link ¶

⚶ Changes

{
  "#id": "Policies_CreateOrUpdate",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

PUT:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/cdnWebApplicationFirewallPolicies/{policyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
policyName:
{
Description: The name of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
cdnWebApplicationFirewallPolicy:
{
Description: Policy to be created. ,
Required: True ,
}
{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (201)

{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Defines web application firewall policy for Azure CDN. ,
}
{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Policies_Update (updated)
Description :  Update an existing CdnWebApplicationFirewallPolicy with the specified policy name under the specified subscription and resource group
Reference :  Link ¶

⚶ Changes

{
  "#id": "Policies_Update",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

PATCH:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/cdnWebApplicationFirewallPolicies/{policyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
policyName:
{
Description: The name of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
cdnWebApplicationFirewallPolicyPatchParameters:
{
Description: CdnWebApplicationFirewallPolicy parameters to be patched. ,
Required: True ,
}
{
tags:
{
Description: CdnWebApplicationFirewallPolicy tags ,
Required: False ,
}
object ,
}
,
}

⚐ Response (200)

{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}

⚐ Response (202)

{
$headers:
{
location: string ,
}
,
$schema:
{
Description: Defines web application firewall policy for Azure CDN. ,
}
{
properties:
{
Description: Properties of the web application firewall policy. ,
Required: False ,
}
{
policySettings:
{
Description: Describes policySettings for policy ,
Required: False ,
}
{
enabledState:
{
Description: describes if the policy is in enabled state or disabled state ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
mode:
{
Description: Describes if it is in detection mode or prevention mode at policy level. ,
Enum:
{
Prevention: No description available. ,
Detection: No description available. ,
}
,
Required: False ,
}
enum ,
defaultRedirectUrl:
{
Description: If action type is redirect, this field represents the default redirect URL for the client. ,
Required: False ,
}
string ,
defaultCustomBlockResponseStatusCode:
{
Description: If the action type is block, this field defines the default customer overridable http response status code. ,
Format: int32 ,
Required: False ,
}
integer ,
defaultCustomBlockResponseBody:
{
Description: If the action type is block, customer can override the response body. The body must be specified in base64 encoding. ,
Required: False ,
}
string ,
}
,
rateLimitRules:
{
Description: Describes rate limit rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
rateLimitThreshold:
{
Description: Defines rate limit threshold. ,
Format: int32 ,
Required: True ,
}
integer ,
rateLimitDurationInMinutes:
{
Description: Defines rate limit duration. Default is 1 minute. ,
Format: int32 ,
Required: True ,
}
integer ,
}
,
]
,
}
,
customRules:
{
Description: Describes custom rules inside the policy. ,
Required: False ,
}
{
rules:
{
Description: List of rules ,
Required: False ,
}
[
{
name:
{
Description: Defines the name of the custom rule ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the custom rule is in enabled or disabled state. Defaults to Enabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
priority:
{
Description: Defines in what order this rule be evaluated in the overall list of custom rules ,
Format: int32 ,
Required: True ,
}
integer ,
matchConditions:
{
Description: List of match conditions. ,
Required: True ,
}
[
{
matchVariable:
{
Description: Match variable to compare against. ,
Enum:
{
RemoteAddr: No description available. ,
SocketAddr: No description available. ,
RequestMethod: No description available. ,
RequestHeader: No description available. ,
RequestUri: No description available. ,
QueryString: No description available. ,
RequestBody: No description available. ,
Cookies: No description available. ,
PostArgs: No description available. ,
}
,
Required: True ,
}
enum ,
selector:
{
Description: Selector can used to match a specific key for QueryString, Cookies, RequestHeader or PostArgs. ,
Required: False ,
}
string ,
operator:
{
Description: Describes operator to be matched ,
Enum:
{
Any: No description available. ,
IPMatch: No description available. ,
GeoMatch: No description available. ,
Equal: No description available. ,
Contains: No description available. ,
LessThan: No description available. ,
GreaterThan: No description available. ,
LessThanOrEqual: No description available. ,
GreaterThanOrEqual: No description available. ,
BeginsWith: No description available. ,
EndsWith: No description available. ,
RegEx: No description available. ,
}
,
Required: True ,
}
enum ,
negateCondition:
{
Description: Describes if the result of this condition should be negated. ,
Required: False ,
}
boolean ,
matchValue:
{
Description: List of possible match values. ,
Required: True ,
}
[
string ,
]
,
transforms:
{
Description: List of transforms. ,
Required: False ,
}
[
string ,
]
,
}
,
]
,
action:
{
Description: Describes what action to be applied when rule matches ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: True ,
}
enum ,
}
,
]
,
}
,
managedRules:
{
Description: Describes managed rules inside the policy. ,
Required: False ,
}
{
managedRuleSets:
{
Description: List of rule sets. ,
Required: False ,
}
[
{
ruleSetType:
{
Description: Defines the rule set type to use. ,
Required: True ,
}
string ,
ruleSetVersion:
{
Description: Defines the version of the rule set to use. ,
Required: True ,
}
string ,
anomalyScore:
{
Description: Verizon only : If the rule set supports anomaly detection mode, this describes the threshold for blocking requests. ,
Format: int32 ,
Required: False ,
}
integer ,
ruleGroupOverrides:
{
Description: Defines the rule overrides to apply to the rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Describes the managed rule group within the rule set to override ,
Required: True ,
}
string ,
rules:
{
Description: List of rules that will be enabled. If none specified, all rules in the group will be disabled. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: True ,
}
string ,
enabledState:
{
Description: Describes if the managed rule is in enabled or disabled state. Defaults to Disabled if not specified. ,
Enum:
{
Disabled: No description available. ,
Enabled: No description available. ,
}
,
Required: False ,
}
enum ,
action:
{
Description: Describes the override action to be applied when rule matches. ,
Enum:
{
Allow: No description available. ,
Block: No description available. ,
Log: No description available. ,
Redirect: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
]
,
}
,
]
,
}
,
]
,
}
,
endpointLinks:
{
Description: Describes Azure CDN endpoints associated with this Web Application Firewall policy. ,
Required: False ,
}
[
{
id:
{
Description: ARM Resource ID string. ,
Required: False ,
}
string ,
}
,
]
,
extendedProperties:
{
Description: Key-Value pair representing additional properties for Web Application Firewall policy. ,
Required: False ,
}
object ,
provisioningState:
{
Description: Provisioning state of the WebApplicationFirewallPolicy. ,
Enum:
{
Creating: No description available. ,
Succeeded: No description available. ,
Failed: No description available. ,
}
,
Required: False ,
}
enum ,
resourceState:
{
Enum:
{
Creating: No description available. ,
Enabling: No description available. ,
Enabled: No description available. ,
Disabling: No description available. ,
Disabled: No description available. ,
Deleting: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
etag:
{
Description: Gets a unique read-only string that changes whenever the resource is updated. ,
Required: False ,
}
string ,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
Policies_Delete (updated)
Description :  Deletes Policy
Reference :  Link ¶

⚶ Changes

{
  "#id": "Policies_Delete",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

DELETE:  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/cdnWebApplicationFirewallPolicies/{policyName}
{
resourceGroupName:
{
Description: Name of the Resource group within the Azure subscription. ,
Required: True ,
}
string ,
policyName:
{
Description: The name of the CdnWebApplicationFirewallPolicy. ,
Required: True ,
}
string ,
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{}

⚐ Response (204)

{}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}
ManagedRuleSets_List (updated)
Description :  Lists all available managed rule sets.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ManagedRuleSets_List",
  "$parameters": [
    {
      "#name": "subscriptionId",
      "Description": {
        "new": "The ID of the target subscription. The value must be an UUID.",
        "old": "Azure Subscription ID."
      }
    },
    {
      "#name": "api-version",
      "Description": {
        "new": "The API version to use for this operation.",
        "old": "Version of the API to be used with the client request. Current version is 2025-04-15."
      }
    }
  ],
  "$responses": {
    "default": {
      "Description": {
        "new": "Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).",
        "old": "Error response indicates Azure Front Door Standard or Azure Front Door Premium or CDN service is not able to process the incoming request. The reason is provided in the error message."
      },
      "$properties": [
        {
          "#name": "error",
          "Description": {
            "new": "The error object.",
            "old": "The error detail."
          },
          "$properties": {
            "details": {
              "Type": {
                "new": "string",
                "old": "object"
              }
            }
          }
        }
      ]
    }
  }
}

⚼ Request

GET:  /subscriptions/{subscriptionId}/providers/Microsoft.Cdn/cdnWebApplicationFirewallManagedRuleSets
{
subscriptionId:
{
Description: The ID of the target subscription. The value must be an UUID. ,
Format: uuid ,
Required: True ,
}
string ,
api-version:
{
Description: The API version to use for this operation. ,
Required: True ,
}
string ,
}

⚐ Response (200)

{
value:
{
Description: List of managed rule set definitions. ,
Required: False ,
}
[
{
properties:
{
Description: Describes managed rule set definition properties. ,
Required: False ,
}
{
provisioningState:
{
Description: Provisioning state of the managed rule set. ,
Required: False ,
}
string ,
ruleSetType:
{
Description: Type of the managed rule set. ,
Required: False ,
}
string ,
ruleSetVersion:
{
Description: Version of the managed rule set type. ,
Required: False ,
}
string ,
ruleGroups:
{
Description: Rule groups of the managed rule set. ,
Required: False ,
}
[
{
ruleGroupName:
{
Description: Name of the managed rule group. ,
Required: False ,
}
string ,
description:
{
Description: Description of the managed rule group. ,
Required: False ,
}
string ,
rules:
{
Description: List of rules within the managed rule group. ,
Required: False ,
}
[
{
ruleId:
{
Description: Identifier for the managed rule. ,
Required: False ,
}
string ,
description:
{
Description: Describes the functionality of the managed rule. ,
Required: False ,
}
string ,
}
,
]
,
}
,
]
,
}
,
sku:
{
Description: The pricing tier (defines a CDN provider, feature list and rate) of the CdnWebApplicationFirewallPolicy. ,
Required: False ,
}
{
name:
{
Description: Name of the pricing tier. ,
Enum:
{
Standard_Verizon: No description available. ,
Premium_Verizon: No description available. ,
Custom_Verizon: No description available. ,
Standard_Akamai: No description available. ,
Standard_ChinaCdn: No description available. ,
Standard_Microsoft: No description available. ,
Standard_AzureFrontDoor: No description available. ,
Premium_AzureFrontDoor: No description available. ,
Standard_955BandWidth_ChinaCdn: No description available. ,
Standard_AvgBandWidth_ChinaCdn: No description available. ,
StandardPlus_ChinaCdn: No description available. ,
StandardPlus_955BandWidth_ChinaCdn: No description available. ,
StandardPlus_AvgBandWidth_ChinaCdn: No description available. ,
}
,
Required: False ,
}
enum ,
}
,
}
,
]
,
nextLink:
{
Description: URL to retrieve next set of managed rule set definitions. ,
Required: False ,
}
string ,
}

⚐ Response (default)

{
error:
{
Description: The error object. ,
Required: False ,
}
{
code:
{
Description: The error code. ,
Required: False ,
}
string ,
message:
{
Description: The error message. ,
Required: False ,
}
string ,
target:
{
Description: The error target. ,
Required: False ,
}
string ,
details:
{
Description: The error details. ,
Required: False ,
}
[
string ,
]
,
additionalInfo:
{
Description: The error additional info. ,
Required: False ,
}
[
{
type:
{
Description: The additional info type. ,
Required: False ,
}
string ,
info:
{
Description: The additional info. ,
Required: False ,
}
object ,
}
,
]
,
}
,
}