Endpoint interface
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.
- Extends
Properties
content |
List of content types on which compression applies. The value should be a valid MIME type. |
custom |
The custom domains under the endpoint. NOTE: This property will not be serialized. It can only be populated by the server. |
default |
A reference to the origin group. |
delivery |
A policy that specifies the delivery rules to be used for an endpoint. |
geo |
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/ |
host |
The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net NOTE: This property will not be serialized. It can only be populated by the server. |
is |
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. |
is |
Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
is |
Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed. |
optimization |
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. |
origin |
The origin groups comprising of origins that are used for load balancing the traffic based on availability. |
origin |
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. |
origin |
A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath. |
origins | The source of the content being delivered via CDN. |
probe |
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. |
provisioning |
Provisioning status of the endpoint. NOTE: This property will not be serialized. It can only be populated by the server. |
query |
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL. |
resource |
Resource status of the endpoint. NOTE: This property will not be serialized. It can only be populated by the server. |
url |
List of keys used to validate the signed URL hashes. |
web |
Defines the Web Application Firewall policy for the endpoint (if applicable) |
Inherited Properties
id | Resource ID. NOTE: This property will not be serialized. It can only be populated by the server. |
location | Resource location. |
name | Resource name. NOTE: This property will not be serialized. It can only be populated by the server. |
system |
Read only system data NOTE: This property will not be serialized. It can only be populated by the server. |
tags | Resource tags. |
type | Resource type. NOTE: This property will not be serialized. It can only be populated by the server. |
Property Details
contentTypesToCompress
List of content types on which compression applies. The value should be a valid MIME type.
contentTypesToCompress?: string[]
Property Value
string[]
customDomains
The custom domains under the endpoint. NOTE: This property will not be serialized. It can only be populated by the server.
customDomains?: DeepCreatedCustomDomain[]
Property Value
defaultOriginGroup
A reference to the origin group.
defaultOriginGroup?: ResourceReference
Property Value
deliveryPolicy
A policy that specifies the delivery rules to be used for an endpoint.
deliveryPolicy?: EndpointPropertiesUpdateParametersDeliveryPolicy
Property Value
geoFilters
List of rules defining the user's geo access within a CDN endpoint. Each geo filter defines an access rule to a specified path or content, e.g. block APAC for path /pictures/
geoFilters?: GeoFilter[]
Property Value
hostName
The host name of the endpoint structured as {endpointName}.{DNSZone}, e.g. contoso.azureedge.net NOTE: This property will not be serialized. It can only be populated by the server.
hostName?: string
Property Value
string
isCompressionEnabled
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.
isCompressionEnabled?: boolean
Property Value
boolean
isHttpAllowed
Indicates whether HTTP traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.
isHttpAllowed?: boolean
Property Value
boolean
isHttpsAllowed
Indicates whether HTTPS traffic is allowed on the endpoint. Default value is true. At least one protocol (HTTP or HTTPS) must be allowed.
isHttpsAllowed?: boolean
Property Value
boolean
optimizationType
Specifies what scenario the customer wants this CDN endpoint to optimize for, e.g. Download, Media services. With this information, CDN can apply scenario driven optimization.
optimizationType?: string
Property Value
string
originGroups
The origin groups comprising of origins that are used for load balancing the traffic based on availability.
originGroups?: DeepCreatedOriginGroup[]
Property Value
originHostHeader
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.
originHostHeader?: string
Property Value
string
originPath
A directory path on the origin that CDN can use to retrieve content from, e.g. contoso.cloudapp.net/originpath.
originPath?: string
Property Value
string
origins
The source of the content being delivered via CDN.
origins?: DeepCreatedOrigin[]
Property Value
probePath
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.
probePath?: string
Property Value
string
provisioningState
Provisioning status of the endpoint. NOTE: This property will not be serialized. It can only be populated by the server.
provisioningState?: string
Property Value
string
queryStringCachingBehavior
Defines how CDN caches requests that include query strings. You can ignore any query strings when caching, bypass caching to prevent requests that contain query strings from being cached, or cache every request with a unique URL.
queryStringCachingBehavior?: QueryStringCachingBehavior
Property Value
resourceState
Resource status of the endpoint. NOTE: This property will not be serialized. It can only be populated by the server.
resourceState?: string
Property Value
string
urlSigningKeys
List of keys used to validate the signed URL hashes.
urlSigningKeys?: UrlSigningKey[]
Property Value
webApplicationFirewallPolicyLink
Defines the Web Application Firewall policy for the endpoint (if applicable)
webApplicationFirewallPolicyLink?: EndpointPropertiesUpdateParametersWebApplicationFirewallPolicyLink
Property Value
Inherited Property Details
id
Resource ID. NOTE: This property will not be serialized. It can only be populated by the server.
id?: string
Property Value
string
Inherited From TrackedResource.id
location
name
Resource name. NOTE: This property will not be serialized. It can only be populated by the server.
name?: string
Property Value
string
Inherited From TrackedResource.name
systemData
Read only system data NOTE: This property will not be serialized. It can only be populated by the server.
systemData?: SystemData
Property Value
Inherited From TrackedResource.systemData
tags
Resource tags.
tags?: {[propertyName: string]: string}
Property Value
{[propertyName: string]: string}
Inherited From TrackedResource.tags
type
Resource type. NOTE: This property will not be serialized. It can only be populated by the server.
type?: string
Property Value
string
Inherited From TrackedResource.type