import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * !> **IMPORTANT** This deploys an Azure Front Door (classic) resource which has been deprecated and will receive security updates only. Please migrate your existing Azure Front Door (classic) deployments to the new Azure Front Door (standard/premium) resources. For your convenience, the service team has exposed a `Front Door Classic` to `Front Door Standard/Premium` [migration tool](https://learn.microsoft.com/azure/frontdoor/tier-migration) to allow you to migrate your existing `Front Door Classic` instances to the new `Front Door Standard/Premium` product tiers. * * Manages an Azure Front Door (classic) instance. * * Azure Front Door Service is Microsoft's highly available and scalable web application acceleration platform and global HTTP(S) load balancer. It provides built-in DDoS protection and application layer security and caching. Front Door enables you to build applications that maximize and automate high-availability and performance for your end-users. Use Front Door with Azure services including Web/Mobile Apps, Cloud Services and Virtual Machines – or combine it with on-premises services for hybrid deployments and smooth cloud migration. * * Below are some of the key scenarios that Azure Front Door Service addresses: * * * Use Front Door to improve application scale and availability with instant multi-region failover * * Use Front Door to improve application performance with SSL offload and routing requests to the fastest available application backend. * * Use Front Door for application layer security and DDoS protection for your application. * * !> **Note:** The `customHttpsProvisioningEnabled` field and the `customHttpsConfiguration` block have been removed from the `azure.frontdoor.Frontdoor` resource in the `v2.58.0` provider due to changes made by the service team. If you wish to enable the custom HTTPS configuration functionality within your `azure.frontdoor.Frontdoor` resource moving forward you will need to define a separate `azure.frontdoor.CustomHttpsConfiguration` block in your configuration file. * * !> **Note:** With the release of the `v2.58.0` provider, if you run the `apply` command against an existing Front Door resource it **will not** apply the detected changes. Instead it will persist the `explicitResourceOrder` mapping structure to the state file. Once this operation has completed the resource will resume functioning normally.This change in behavior in Terraform is due to an issue where the underlying service teams API is now returning the response JSON out of order from the way it was sent to the resource via Terraform causing unexpected discrepancies in the `plan` after the resource has been provisioned. If your pre-existing Front Door instance contains `customHttpsConfiguration` blocks there are additional steps that will need to be completed to successfully migrate your Front Door onto the `v2.58.0` provider which can be found in this guide. * * !> **Note:** The creation of new Azure Front Door (classic) resources is no longer supported following its deprecation on `April 1, 2025`. However, modifications to existing Azure Front Door (classic) resources will continue to be supported until the API reaches full retirement on `March 31, 2027`. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "FrontDoorExampleResourceGroup", * location: "West Europe", * }); * const exampleFrontdoor = new azure.frontdoor.Frontdoor("example", { * name: "example-FrontDoor", * resourceGroupName: example.name, * routingRules: [{ * name: "exampleRoutingRule1", * acceptedProtocols: [ * "Http", * "Https", * ], * patternsToMatches: ["/*"], * frontendEndpoints: ["exampleFrontendEndpoint1"], * forwardingConfiguration: { * forwardingProtocol: "MatchRequest", * backendPoolName: "exampleBackendBing", * }, * }], * backendPoolLoadBalancings: [{ * name: "exampleLoadBalancingSettings1", * }], * backendPoolHealthProbes: [{ * name: "exampleHealthProbeSetting1", * }], * backendPools: [{ * name: "exampleBackendBing", * backends: [{ * hostHeader: "www.bing.com", * address: "www.bing.com", * httpPort: 80, * httpsPort: 443, * }], * loadBalancingName: "exampleLoadBalancingSettings1", * healthProbeName: "exampleHealthProbeSetting1", * }], * frontendEndpoints: [{ * name: "exampleFrontendEndpoint1", * hostName: "example-FrontDoor.azurefd.net", * }], * }); * ``` * * ## Import * * Front Doors can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:frontdoor/frontdoor:Frontdoor example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/frontDoors/frontdoor1 * ``` */ export declare class Frontdoor extends pulumi.CustomResource { /** * Get an existing Frontdoor 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?: FrontdoorState, opts?: pulumi.CustomResourceOptions): Frontdoor; /** * Returns true if the given object is an instance of Frontdoor. 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 Frontdoor; /** * A `backendPoolHealthProbe` block as defined below. */ readonly backendPoolHealthProbes: pulumi.Output; /** * A map/dictionary of Backend Pool Health Probe Names (key) to the Backend Pool Health Probe ID (value) */ readonly backendPoolHealthProbesMap: pulumi.Output<{ [key: string]: string; }>; /** * A map/dictionary of Backend Pool Load Balancing Setting Names (key) to the Backend Pool Load Balancing Setting ID (value) */ readonly backendPoolLoadBalancingSettingsMap: pulumi.Output<{ [key: string]: string; }>; /** * A `backendPoolLoadBalancing` block as defined below. */ readonly backendPoolLoadBalancings: pulumi.Output; /** * A `backendPoolSettings` block as defined below. */ readonly backendPoolSettings: pulumi.Output; /** * A `backendPool` block as defined below. * * > Azure by default allows specifying up to 50 Backend Pools - but this quota can be increased via Microsoft Support. */ readonly backendPools: pulumi.Output; /** * A map/dictionary of Backend Pool Names (key) to the Backend Pool ID (value) */ readonly backendPoolsMap: pulumi.Output<{ [key: string]: string; }>; /** * The host that each frontendEndpoint must CNAME to. */ readonly cname: pulumi.Output; readonly explicitResourceOrders: pulumi.Output; /** * A friendly name for the Front Door service. */ readonly friendlyName: pulumi.Output; /** * A `frontendEndpoint` block as defined below. */ readonly frontendEndpoints: pulumi.Output; /** * A map/dictionary of Frontend Endpoint Names (key) to the Frontend Endpoint ID (value) */ readonly frontendEndpointsMap: pulumi.Output<{ [key: string]: string; }>; /** * The unique ID of the Front Door which is embedded into the incoming headers `X-Azure-FDID` attribute and maybe used to filter traffic sent by the Front Door to your backend. */ readonly headerFrontdoorId: pulumi.Output; /** * Should the Front Door Load Balancer be Enabled? Defaults to `true`. */ readonly loadBalancerEnabled: pulumi.Output; /** * Specifies the name of the Front Door service. Must be globally unique. Changing this forces a new resource to be created. */ readonly name: pulumi.Output; /** * Specifies the name of the Resource Group in which the Front Door service should exist. Changing this forces a new resource to be created. */ readonly resourceGroupName: pulumi.Output; /** * A `routingRule` block as defined below. */ readonly routingRules: pulumi.Output; /** * A map/dictionary of Routing Rule Names (key) to the Routing Rule ID (value) */ readonly routingRulesMap: pulumi.Output<{ [key: string]: string; }>; /** * A mapping of tags to assign to the resource. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Create a Frontdoor 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: FrontdoorArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering Frontdoor resources. */ export interface FrontdoorState { /** * A `backendPoolHealthProbe` block as defined below. */ backendPoolHealthProbes?: pulumi.Input[]>; /** * A map/dictionary of Backend Pool Health Probe Names (key) to the Backend Pool Health Probe ID (value) */ backendPoolHealthProbesMap?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * A map/dictionary of Backend Pool Load Balancing Setting Names (key) to the Backend Pool Load Balancing Setting ID (value) */ backendPoolLoadBalancingSettingsMap?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * A `backendPoolLoadBalancing` block as defined below. */ backendPoolLoadBalancings?: pulumi.Input[]>; /** * A `backendPoolSettings` block as defined below. */ backendPoolSettings?: pulumi.Input[]>; /** * A `backendPool` block as defined below. * * > Azure by default allows specifying up to 50 Backend Pools - but this quota can be increased via Microsoft Support. */ backendPools?: pulumi.Input[]>; /** * A map/dictionary of Backend Pool Names (key) to the Backend Pool ID (value) */ backendPoolsMap?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * The host that each frontendEndpoint must CNAME to. */ cname?: pulumi.Input; explicitResourceOrders?: pulumi.Input[]>; /** * A friendly name for the Front Door service. */ friendlyName?: pulumi.Input; /** * A `frontendEndpoint` block as defined below. */ frontendEndpoints?: pulumi.Input[]>; /** * A map/dictionary of Frontend Endpoint Names (key) to the Frontend Endpoint ID (value) */ frontendEndpointsMap?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * The unique ID of the Front Door which is embedded into the incoming headers `X-Azure-FDID` attribute and maybe used to filter traffic sent by the Front Door to your backend. */ headerFrontdoorId?: pulumi.Input; /** * Should the Front Door Load Balancer be Enabled? Defaults to `true`. */ loadBalancerEnabled?: pulumi.Input; /** * Specifies the name of the Front Door service. Must be globally unique. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Specifies the name of the Resource Group in which the Front Door service should exist. Changing this forces a new resource to be created. */ resourceGroupName?: pulumi.Input; /** * A `routingRule` block as defined below. */ routingRules?: pulumi.Input[]>; /** * A map/dictionary of Routing Rule Names (key) to the Routing Rule ID (value) */ routingRulesMap?: pulumi.Input<{ [key: string]: 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 Frontdoor resource. */ export interface FrontdoorArgs { /** * A `backendPoolHealthProbe` block as defined below. */ backendPoolHealthProbes: pulumi.Input[]>; /** * A `backendPoolLoadBalancing` block as defined below. */ backendPoolLoadBalancings: pulumi.Input[]>; /** * A `backendPoolSettings` block as defined below. */ backendPoolSettings?: pulumi.Input[]>; /** * A `backendPool` block as defined below. * * > Azure by default allows specifying up to 50 Backend Pools - but this quota can be increased via Microsoft Support. */ backendPools: pulumi.Input[]>; /** * A friendly name for the Front Door service. */ friendlyName?: pulumi.Input; /** * A `frontendEndpoint` block as defined below. */ frontendEndpoints: pulumi.Input[]>; /** * Should the Front Door Load Balancer be Enabled? Defaults to `true`. */ loadBalancerEnabled?: pulumi.Input; /** * Specifies the name of the Front Door service. Must be globally unique. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Specifies the name of the Resource Group in which the Front Door service should exist. Changing this forces a new resource to be created. */ resourceGroupName: pulumi.Input; /** * A `routingRule` block as defined below. */ routingRules: pulumi.Input[]>; /** * A mapping of tags to assign to the resource. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; }