import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Manages a 3rd Generation (v3) App Service Environment. * * ## Example Usage * * This example provisions an App Service Environment V3. Additional examples of how to use the `azure.appservice.EnvironmentV3` resource can be found in the `./examples/app-service-environment-v3` directory within the GitHub Repository. * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as azure from "@pulumi/azure"; * * const example = new azure.core.ResourceGroup("example", { * name: "exampleRG1", * location: "West Europe", * }); * const exampleVirtualNetwork = new azure.network.VirtualNetwork("example", { * name: "example-vnet", * location: example.location, * resourceGroupName: example.name, * addressSpaces: ["10.0.0.0/16"], * }); * const exampleSubnet = new azure.network.Subnet("example", { * name: "example-subnet", * resourceGroupName: example.name, * virtualNetworkName: exampleVirtualNetwork.name, * addressPrefixes: ["10.0.2.0/24"], * delegations: [{ * name: "Microsoft.Web.hostingEnvironments", * serviceDelegation: { * name: "Microsoft.Web/hostingEnvironments", * actions: ["Microsoft.Network/virtualNetworks/subnets/action"], * }, * }], * }); * const exampleEnvironmentV3 = new azure.appservice.EnvironmentV3("example", { * name: "example-asev3", * resourceGroupName: example.name, * subnetId: exampleSubnet.id, * internalLoadBalancingMode: "Web, Publishing", * clusterSettings: [ * { * name: "DisableTls1.0", * value: "1", * }, * { * name: "InternalEncryption", * value: "true", * }, * { * name: "FrontEndSSLCipherSuiteOrder", * value: "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", * }, * ], * tags: { * env: "production", * terraformed: "true", * }, * }); * const exampleServicePlan = new azure.appservice.ServicePlan("example", { * name: "example", * resourceGroupName: example.name, * location: example.location, * osType: "Linux", * skuName: "I1v2", * appServiceEnvironmentId: exampleEnvironmentV3.id, * }); * ``` * * ## API Providers * * * This resource uses the following Azure API Providers: * * * `Microsoft.Network` - 2025-01-01 * * * `Microsoft.Web` - 2023-01-01 * * ## Import * * A 3rd Generation (v3) App Service Environment can be imported using the `resource id`, e.g. * * ```sh * $ pulumi import azure:appservice/environmentV3:EnvironmentV3 myAppServiceEnv /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Web/hostingEnvironments/myAppServiceEnv * ``` */ export declare class EnvironmentV3 extends pulumi.CustomResource { /** * Get an existing EnvironmentV3 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?: EnvironmentV3State, opts?: pulumi.CustomResourceOptions): EnvironmentV3; /** * Returns true if the given object is an instance of EnvironmentV3. 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 EnvironmentV3; /** * Should new Private Endpoint Connections be allowed. Defaults to `true`. */ readonly allowNewPrivateEndpointConnections: pulumi.Output; /** * Zero or more `clusterSetting` blocks as defined below. */ readonly clusterSettings: pulumi.Output; /** * This ASEv3 should use dedicated Hosts. Possible values are `2`. Changing this forces a new resource to be created. */ readonly dedicatedHostCount: pulumi.Output; /** * the DNS suffix for this App Service Environment V3. */ readonly dnsSuffix: pulumi.Output; /** * The external inbound IP addresses of the App Service Environment V3. */ readonly externalInboundIpAddresses: pulumi.Output; /** * An `inboundNetworkDependencies` block as defined below. */ readonly inboundNetworkDependencies: pulumi.Output; /** * The internal inbound IP addresses of the App Service Environment V3. */ readonly internalInboundIpAddresses: pulumi.Output; /** * Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. Possible values are `None` (for an External VIP Type), and `"Web, Publishing"` (for an Internal VIP Type). Defaults to `None`. Changing this forces a new resource to be created. */ readonly internalLoadBalancingMode: pulumi.Output; /** * The number of IP SSL addresses reserved for the App Service Environment V3. */ readonly ipSslAddressCount: pulumi.Output; /** * Outbound addresses of Linux based Apps in this App Service Environment V3 */ readonly linuxOutboundIpAddresses: pulumi.Output; /** * The location where the App Service Environment exists. */ readonly location: pulumi.Output; /** * The name of the App Service Environment. Changing this forces a new resource to be created. */ readonly name: pulumi.Output; /** * Pricing tier for the front end instances. */ readonly pricingTier: pulumi.Output; /** * Whether to enable remote debug. Defaults to `false`. */ readonly remoteDebuggingEnabled: pulumi.Output; /** * The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by `subnetId`). Changing this forces a new resource to be created. */ readonly resourceGroupName: pulumi.Output; /** * The ID of the Subnet which the App Service Environment should be connected to. Changing this forces a new resource to be created. * * > **Note:** a /24 or larger CIDR is required. Once associated with an ASE, this size cannot be changed. * * > **Note:** This Subnet requires a delegation to `Microsoft.Web/hostingEnvironments` as detailed in the example above. */ readonly subnetId: pulumi.Output; /** * A mapping of tags to assign to the resource. * * > **Note:** The underlying API does not currently support changing Tags on this resource. Making changes in the portal for tags will cause Terraform to detect a change that will force a recreation of the ASEV3 unless `ignoreChanges` lifecycle meta-argument is used. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * Outbound addresses of Windows based Apps in this App Service Environment V3. */ readonly windowsOutboundIpAddresses: pulumi.Output; /** * Set to `true` to deploy the ASEv3 with availability zones supported. Zonal ASEs can be deployed in some regions, you can refer to [Availability Zone support for App Service Environments](https://docs.microsoft.com/azure/app-service/environment/zone-redundancy). You can only set either `dedicatedHostCount` or `zoneRedundant` but not both. Changing this forces a new resource to be created. * * > **Note:** Setting this value will provision 2 Physical Hosts for your App Service Environment V3, this is done at additional cost, please be aware of the pricing commitment in the [General Availability Notes](https://techcommunity.microsoft.com/t5/apps-on-azure/announcing-app-service-environment-v3-ga/ba-p/2517990) */ readonly zoneRedundant: pulumi.Output; /** * Create a EnvironmentV3 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: EnvironmentV3Args, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering EnvironmentV3 resources. */ export interface EnvironmentV3State { /** * Should new Private Endpoint Connections be allowed. Defaults to `true`. */ allowNewPrivateEndpointConnections?: pulumi.Input; /** * Zero or more `clusterSetting` blocks as defined below. */ clusterSettings?: pulumi.Input[]>; /** * This ASEv3 should use dedicated Hosts. Possible values are `2`. Changing this forces a new resource to be created. */ dedicatedHostCount?: pulumi.Input; /** * the DNS suffix for this App Service Environment V3. */ dnsSuffix?: pulumi.Input; /** * The external inbound IP addresses of the App Service Environment V3. */ externalInboundIpAddresses?: pulumi.Input[]>; /** * An `inboundNetworkDependencies` block as defined below. */ inboundNetworkDependencies?: pulumi.Input[]>; /** * The internal inbound IP addresses of the App Service Environment V3. */ internalInboundIpAddresses?: pulumi.Input[]>; /** * Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. Possible values are `None` (for an External VIP Type), and `"Web, Publishing"` (for an Internal VIP Type). Defaults to `None`. Changing this forces a new resource to be created. */ internalLoadBalancingMode?: pulumi.Input; /** * The number of IP SSL addresses reserved for the App Service Environment V3. */ ipSslAddressCount?: pulumi.Input; /** * Outbound addresses of Linux based Apps in this App Service Environment V3 */ linuxOutboundIpAddresses?: pulumi.Input[]>; /** * The location where the App Service Environment exists. */ location?: pulumi.Input; /** * The name of the App Service Environment. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Pricing tier for the front end instances. */ pricingTier?: pulumi.Input; /** * Whether to enable remote debug. Defaults to `false`. */ remoteDebuggingEnabled?: pulumi.Input; /** * The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by `subnetId`). Changing this forces a new resource to be created. */ resourceGroupName?: pulumi.Input; /** * The ID of the Subnet which the App Service Environment should be connected to. Changing this forces a new resource to be created. * * > **Note:** a /24 or larger CIDR is required. Once associated with an ASE, this size cannot be changed. * * > **Note:** This Subnet requires a delegation to `Microsoft.Web/hostingEnvironments` as detailed in the example above. */ subnetId?: pulumi.Input; /** * A mapping of tags to assign to the resource. * * > **Note:** The underlying API does not currently support changing Tags on this resource. Making changes in the portal for tags will cause Terraform to detect a change that will force a recreation of the ASEV3 unless `ignoreChanges` lifecycle meta-argument is used. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Outbound addresses of Windows based Apps in this App Service Environment V3. */ windowsOutboundIpAddresses?: pulumi.Input[]>; /** * Set to `true` to deploy the ASEv3 with availability zones supported. Zonal ASEs can be deployed in some regions, you can refer to [Availability Zone support for App Service Environments](https://docs.microsoft.com/azure/app-service/environment/zone-redundancy). You can only set either `dedicatedHostCount` or `zoneRedundant` but not both. Changing this forces a new resource to be created. * * > **Note:** Setting this value will provision 2 Physical Hosts for your App Service Environment V3, this is done at additional cost, please be aware of the pricing commitment in the [General Availability Notes](https://techcommunity.microsoft.com/t5/apps-on-azure/announcing-app-service-environment-v3-ga/ba-p/2517990) */ zoneRedundant?: pulumi.Input; } /** * The set of arguments for constructing a EnvironmentV3 resource. */ export interface EnvironmentV3Args { /** * Should new Private Endpoint Connections be allowed. Defaults to `true`. */ allowNewPrivateEndpointConnections?: pulumi.Input; /** * Zero or more `clusterSetting` blocks as defined below. */ clusterSettings?: pulumi.Input[]>; /** * This ASEv3 should use dedicated Hosts. Possible values are `2`. Changing this forces a new resource to be created. */ dedicatedHostCount?: pulumi.Input; /** * Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. Possible values are `None` (for an External VIP Type), and `"Web, Publishing"` (for an Internal VIP Type). Defaults to `None`. Changing this forces a new resource to be created. */ internalLoadBalancingMode?: pulumi.Input; /** * The name of the App Service Environment. Changing this forces a new resource to be created. */ name?: pulumi.Input; /** * Whether to enable remote debug. Defaults to `false`. */ remoteDebuggingEnabled?: pulumi.Input; /** * The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by `subnetId`). Changing this forces a new resource to be created. */ resourceGroupName: pulumi.Input; /** * The ID of the Subnet which the App Service Environment should be connected to. Changing this forces a new resource to be created. * * > **Note:** a /24 or larger CIDR is required. Once associated with an ASE, this size cannot be changed. * * > **Note:** This Subnet requires a delegation to `Microsoft.Web/hostingEnvironments` as detailed in the example above. */ subnetId: pulumi.Input; /** * A mapping of tags to assign to the resource. * * > **Note:** The underlying API does not currently support changing Tags on this resource. Making changes in the portal for tags will cause Terraform to detect a change that will force a recreation of the ASEV3 unless `ignoreChanges` lifecycle meta-argument is used. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; }>; /** * Set to `true` to deploy the ASEv3 with availability zones supported. Zonal ASEs can be deployed in some regions, you can refer to [Availability Zone support for App Service Environments](https://docs.microsoft.com/azure/app-service/environment/zone-redundancy). You can only set either `dedicatedHostCount` or `zoneRedundant` but not both. Changing this forces a new resource to be created. * * > **Note:** Setting this value will provision 2 Physical Hosts for your App Service Environment V3, this is done at additional cost, please be aware of the pricing commitment in the [General Availability Notes](https://techcommunity.microsoft.com/t5/apps-on-azure/announcing-app-service-environment-v3-ga/ba-p/2517990) */ zoneRedundant?: pulumi.Input; }