import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * A CDN (classic) Endpoint is the entity within a CDN Profile containing configuration information regarding caching behaviours and origins. The CDN Endpoint is exposed using the URL format `.azureedge.net`. * * !> **Note:** Azure rolled out a breaking change on Friday 9th April 2021 which may cause issues with the CDN/FrontDoor resources. More information is available in this GitHub issue - unfortunately this may necessitate a breaking change to the CDN (classic) and FrontDoor (classic) resources, more information will be posted in the GitHub issue as the necessary changes are identified. * * !> **Note:** Support for the CDN (classic) `sku` `Standard_Akamai` was deprecated from Azure on `October 31, 2023` and is no longer available. * * !> **Note:** Support for the CDN (classic) `sku` `Standard_Verizon` and `Premium_Verizon` was deprecated from Azure on `January 15, 2025` and is no longer available. * * !> **Note:** Support for the CDN (classic) `sku` `Standard_Microsoft` and `Standard_ChinaCdn` will be deprecated from Azure on `October 1, 2025` and will no longer be available, however modifications to existing CDN (classic) resources will continue to be supported until the API reaches full retirement on `September 30, 2027`. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "example-resources", * location: "West Europe", * }); * const exampleProfile = new azure.cdn.Profile("example", { * name: "example-cdn", * location: example.location, * resourceGroupName: example.name, * sku: "Standard_Microsoft", * }); * const exampleEndpoint = new azure.cdn.Endpoint("example", { * name: "example", * profileName: exampleProfile.name, * location: example.location, * resourceGroupName: example.name, * origins: [{ * name: "example", * hostName: "www.contoso.com", * }], * }); * ``` * * ## Import * * CDN Endpoints can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:cdn/endpoint:Endpoint example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Cdn/profiles/myprofile1/endpoints/myendpoint1 * ``` */ export declare class Endpoint extends pulumi.CustomResource { /** * Get an existing Endpoint resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: EndpointState, opts?: pulumi.CustomResourceOptions): Endpoint; /** * Returns true if the given object is an instance of Endpoint. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is Endpoint; /** * An array of strings that indicates a content types on which compression will be applied. The value for the elements should be MIME types. */ readonly contentTypesToCompresses: pulumi.Output; /** * Rules for the rules engine. An endpoint can contain up until 4 of those rules that consist of conditions and actions. A `deliveryRule` blocks as defined below. */ readonly deliveryRules: pulumi.Output; /** * The Fully Qualified Domain Name of the CDN Endpoint. */ readonly fqdn: pulumi.Output; /** * A set of Geo Filters for this CDN Endpoint. Each `geoFilter` block supports fields documented below. */ readonly geoFilters: pulumi.Output; /** * Actions that are valid for all resources regardless of any conditions. A `globalDeliveryRule` block as defined below. */ readonly globalDeliveryRule: pulumi.Output; /** * Indicates whether compression is to be enabled. */ readonly isCompressionEnabled: pulumi.Output; /** * Specifies if http allowed. Defaults to `true`. */ readonly isHttpAllowed: pulumi.Output; /** * Specifies if https allowed. Defaults to `true`. */ readonly isHttpsAllowed: pulumi.Output; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ readonly location: pulumi.Output; /** * Specifies the name of the CDN Endpoint. Changing this forces a new resource to be created. */ readonly name: pulumi.Output; /** * What types of optimization should this CDN Endpoint optimize for? Possible values include `DynamicSiteAcceleration`, `GeneralMediaStreaming`, `GeneralWebDelivery`, `LargeFileDownload` and `VideoOnDemandMediaStreaming`. */ readonly optimizationType: pulumi.Output; /** * The host header CDN provider will send along with content requests to origins. */ readonly originHostHeader: pulumi.Output; /** * The path used at for origin requests. */ readonly originPath: pulumi.Output; /** * The set of origins of the CDN endpoint. When multiple origins exist, the first origin will be used as primary and rest will be used as failover options. Each `origin` block supports fields documented below. Changing this forces a new resource to be created. */ readonly origins: pulumi.Output; /** * the 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 `originPath`. * * > **Note:** `globalDeliveryRule` and `deliveryRule` are currently only available for `Microsoft_Standard` CDN profiles. */ readonly probePath: pulumi.Output; /** * The CDN Profile to which to attach the CDN Endpoint. Changing this forces a new resource to be created. */ readonly profileName: pulumi.Output; /** * Sets query string caching behavior. Allowed values are `IgnoreQueryString`, `BypassCaching` and `UseQueryString`. `NotSet` value can be used for `Premium Verizon` CDN profile. Defaults to `IgnoreQueryString`. */ readonly querystringCachingBehaviour: pulumi.Output; /** * The name of the resource group in which to create the CDN Endpoint. Changing this forces a new resource to be created. */ readonly resourceGroupName: pulumi.Output; /** * A mapping of tags to assign to the resource. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Create a Endpoint resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: EndpointArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Endpoint resources. */ export interface EndpointState { /** * An array of strings that indicates a content types on which compression will be applied. The value for the elements should be MIME types. */ contentTypesToCompresses?: pulumi.Input[]>; /** * Rules for the rules engine. An endpoint can contain up until 4 of those rules that consist of conditions and actions. A `deliveryRule` blocks as defined below. */ deliveryRules?: pulumi.Input[]>; /** * The Fully Qualified Domain Name of the CDN Endpoint. */ fqdn?: pulumi.Input; /** * A set of Geo Filters for this CDN Endpoint. Each `geoFilter` block supports fields documented below. */ geoFilters?: pulumi.Input[]>; /** * Actions that are valid for all resources regardless of any conditions. A `globalDeliveryRule` block as defined below. */ globalDeliveryRule?: pulumi.Input; /** * Indicates whether compression is to be enabled. */ isCompressionEnabled?: pulumi.Input; /** * Specifies if http allowed. Defaults to `true`. */ isHttpAllowed?: pulumi.Input; /** * Specifies if https allowed. Defaults to `true`. */ isHttpsAllowed?: pulumi.Input; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ location?: pulumi.Input; /** * Specifies the name of the CDN Endpoint. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * What types of optimization should this CDN Endpoint optimize for? Possible values include `DynamicSiteAcceleration`, `GeneralMediaStreaming`, `GeneralWebDelivery`, `LargeFileDownload` and `VideoOnDemandMediaStreaming`. */ optimizationType?: pulumi.Input; /** * The host header CDN provider will send along with content requests to origins. */ originHostHeader?: pulumi.Input; /** * The path used at for origin requests. */ originPath?: pulumi.Input; /** * The set of origins of the CDN endpoint. When multiple origins exist, the first origin will be used as primary and rest will be used as failover options. Each `origin` block supports fields documented below. Changing this forces a new resource to be created. */ origins?: pulumi.Input[]>; /** * the 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 `originPath`. * * > **Note:** `globalDeliveryRule` and `deliveryRule` are currently only available for `Microsoft_Standard` CDN profiles. */ probePath?: pulumi.Input; /** * The CDN Profile to which to attach the CDN Endpoint. Changing this forces a new resource to be created. */ profileName?: pulumi.Input; /** * Sets query string caching behavior. Allowed values are `IgnoreQueryString`, `BypassCaching` and `UseQueryString`. `NotSet` value can be used for `Premium Verizon` CDN profile. Defaults to `IgnoreQueryString`. */ querystringCachingBehaviour?: pulumi.Input; /** * The name of the resource group in which to create the CDN Endpoint. Changing this forces a new resource to be created. */ resourceGroupName?: pulumi.Input; /** * A mapping of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; } /** * The set of arguments for constructing a Endpoint resource. */ export interface EndpointArgs { /** * An array of strings that indicates a content types on which compression will be applied. The value for the elements should be MIME types. */ contentTypesToCompresses?: pulumi.Input[]>; /** * Rules for the rules engine. An endpoint can contain up until 4 of those rules that consist of conditions and actions. A `deliveryRule` blocks as defined below. */ deliveryRules?: pulumi.Input[]>; /** * A set of Geo Filters for this CDN Endpoint. Each `geoFilter` block supports fields documented below. */ geoFilters?: pulumi.Input[]>; /** * Actions that are valid for all resources regardless of any conditions. A `globalDeliveryRule` block as defined below. */ globalDeliveryRule?: pulumi.Input; /** * Indicates whether compression is to be enabled. */ isCompressionEnabled?: pulumi.Input; /** * Specifies if http allowed. Defaults to `true`. */ isHttpAllowed?: pulumi.Input; /** * Specifies if https allowed. Defaults to `true`. */ isHttpsAllowed?: pulumi.Input; /** * Specifies the supported Azure location where the resource exists. Changing this forces a new resource to be created. */ location?: pulumi.Input; /** * Specifies the name of the CDN Endpoint. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * What types of optimization should this CDN Endpoint optimize for? Possible values include `DynamicSiteAcceleration`, `GeneralMediaStreaming`, `GeneralWebDelivery`, `LargeFileDownload` and `VideoOnDemandMediaStreaming`. */ optimizationType?: pulumi.Input; /** * The host header CDN provider will send along with content requests to origins. */ originHostHeader?: pulumi.Input; /** * The path used at for origin requests. */ originPath?: pulumi.Input; /** * The set of origins of the CDN endpoint. When multiple origins exist, the first origin will be used as primary and rest will be used as failover options. Each `origin` block supports fields documented below. Changing this forces a new resource to be created. */ origins: pulumi.Input[]>; /** * the 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 `originPath`. * * > **Note:** `globalDeliveryRule` and `deliveryRule` are currently only available for `Microsoft_Standard` CDN profiles. */ probePath?: pulumi.Input; /** * The CDN Profile to which to attach the CDN Endpoint. Changing this forces a new resource to be created. */ profileName: pulumi.Input; /** * Sets query string caching behavior. Allowed values are `IgnoreQueryString`, `BypassCaching` and `UseQueryString`. `NotSet` value can be used for `Premium Verizon` CDN profile. Defaults to `IgnoreQueryString`. */ querystringCachingBehaviour?: pulumi.Input; /** * The name of the resource group in which to create the CDN Endpoint. Changing this forces a new resource to be created. */ resourceGroupName: pulumi.Input; /** * A mapping of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; }