We recommend using Azure Native.
azure.appservice.EnvironmentV3
Explore with Pulumi AI
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.
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,
});
import pulumi
import pulumi_azure as azure
example = azure.core.ResourceGroup("example",
name="exampleRG1",
location="West Europe")
example_virtual_network = azure.network.VirtualNetwork("example",
name="example-vnet",
location=example.location,
resource_group_name=example.name,
address_spaces=["10.0.0.0/16"])
example_subnet = azure.network.Subnet("example",
name="example-subnet",
resource_group_name=example.name,
virtual_network_name=example_virtual_network.name,
address_prefixes=["10.0.2.0/24"],
delegations=[azure.network.SubnetDelegationArgs(
name="Microsoft.Web.hostingEnvironments",
service_delegation=azure.network.SubnetDelegationServiceDelegationArgs(
name="Microsoft.Web/hostingEnvironments",
actions=["Microsoft.Network/virtualNetworks/subnets/action"],
),
)])
example_environment_v3 = azure.appservice.EnvironmentV3("example",
name="example-asev3",
resource_group_name=example.name,
subnet_id=example_subnet.id,
internal_load_balancing_mode="Web, Publishing",
cluster_settings=[
azure.appservice.EnvironmentV3ClusterSettingArgs(
name="DisableTls1.0",
value="1",
),
azure.appservice.EnvironmentV3ClusterSettingArgs(
name="InternalEncryption",
value="true",
),
azure.appservice.EnvironmentV3ClusterSettingArgs(
name="FrontEndSSLCipherSuiteOrder",
value="TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
),
],
tags={
"env": "production",
"terraformed": "true",
})
example_service_plan = azure.appservice.ServicePlan("example",
name="example",
resource_group_name=example.name,
location=example.location,
os_type="Linux",
sku_name="I1v2",
app_service_environment_id=example_environment_v3.id)
package main
import (
"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/appservice"
"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/core"
"github.com/pulumi/pulumi-azure/sdk/v5/go/azure/network"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
example, err := core.NewResourceGroup(ctx, "example", &core.ResourceGroupArgs{
Name: pulumi.String("exampleRG1"),
Location: pulumi.String("West Europe"),
})
if err != nil {
return err
}
exampleVirtualNetwork, err := network.NewVirtualNetwork(ctx, "example", &network.VirtualNetworkArgs{
Name: pulumi.String("example-vnet"),
Location: example.Location,
ResourceGroupName: example.Name,
AddressSpaces: pulumi.StringArray{
pulumi.String("10.0.0.0/16"),
},
})
if err != nil {
return err
}
exampleSubnet, err := network.NewSubnet(ctx, "example", &network.SubnetArgs{
Name: pulumi.String("example-subnet"),
ResourceGroupName: example.Name,
VirtualNetworkName: exampleVirtualNetwork.Name,
AddressPrefixes: pulumi.StringArray{
pulumi.String("10.0.2.0/24"),
},
Delegations: network.SubnetDelegationArray{
&network.SubnetDelegationArgs{
Name: pulumi.String("Microsoft.Web.hostingEnvironments"),
ServiceDelegation: &network.SubnetDelegationServiceDelegationArgs{
Name: pulumi.String("Microsoft.Web/hostingEnvironments"),
Actions: pulumi.StringArray{
pulumi.String("Microsoft.Network/virtualNetworks/subnets/action"),
},
},
},
},
})
if err != nil {
return err
}
exampleEnvironmentV3, err := appservice.NewEnvironmentV3(ctx, "example", &appservice.EnvironmentV3Args{
Name: pulumi.String("example-asev3"),
ResourceGroupName: example.Name,
SubnetId: exampleSubnet.ID(),
InternalLoadBalancingMode: pulumi.String("Web, Publishing"),
ClusterSettings: appservice.EnvironmentV3ClusterSettingArray{
&appservice.EnvironmentV3ClusterSettingArgs{
Name: pulumi.String("DisableTls1.0"),
Value: pulumi.String("1"),
},
&appservice.EnvironmentV3ClusterSettingArgs{
Name: pulumi.String("InternalEncryption"),
Value: pulumi.String("true"),
},
&appservice.EnvironmentV3ClusterSettingArgs{
Name: pulumi.String("FrontEndSSLCipherSuiteOrder"),
Value: pulumi.String("TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"),
},
},
Tags: pulumi.StringMap{
"env": pulumi.String("production"),
"terraformed": pulumi.String("true"),
},
})
if err != nil {
return err
}
_, err = appservice.NewServicePlan(ctx, "example", &appservice.ServicePlanArgs{
Name: pulumi.String("example"),
ResourceGroupName: example.Name,
Location: example.Location,
OsType: pulumi.String("Linux"),
SkuName: pulumi.String("I1v2"),
AppServiceEnvironmentId: exampleEnvironmentV3.ID(),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Azure = Pulumi.Azure;
return await Deployment.RunAsync(() =>
{
var example = new Azure.Core.ResourceGroup("example", new()
{
Name = "exampleRG1",
Location = "West Europe",
});
var exampleVirtualNetwork = new Azure.Network.VirtualNetwork("example", new()
{
Name = "example-vnet",
Location = example.Location,
ResourceGroupName = example.Name,
AddressSpaces = new[]
{
"10.0.0.0/16",
},
});
var exampleSubnet = new Azure.Network.Subnet("example", new()
{
Name = "example-subnet",
ResourceGroupName = example.Name,
VirtualNetworkName = exampleVirtualNetwork.Name,
AddressPrefixes = new[]
{
"10.0.2.0/24",
},
Delegations = new[]
{
new Azure.Network.Inputs.SubnetDelegationArgs
{
Name = "Microsoft.Web.hostingEnvironments",
ServiceDelegation = new Azure.Network.Inputs.SubnetDelegationServiceDelegationArgs
{
Name = "Microsoft.Web/hostingEnvironments",
Actions = new[]
{
"Microsoft.Network/virtualNetworks/subnets/action",
},
},
},
},
});
var exampleEnvironmentV3 = new Azure.AppService.EnvironmentV3("example", new()
{
Name = "example-asev3",
ResourceGroupName = example.Name,
SubnetId = exampleSubnet.Id,
InternalLoadBalancingMode = "Web, Publishing",
ClusterSettings = new[]
{
new Azure.AppService.Inputs.EnvironmentV3ClusterSettingArgs
{
Name = "DisableTls1.0",
Value = "1",
},
new Azure.AppService.Inputs.EnvironmentV3ClusterSettingArgs
{
Name = "InternalEncryption",
Value = "true",
},
new Azure.AppService.Inputs.EnvironmentV3ClusterSettingArgs
{
Name = "FrontEndSSLCipherSuiteOrder",
Value = "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
},
},
Tags =
{
{ "env", "production" },
{ "terraformed", "true" },
},
});
var exampleServicePlan = new Azure.AppService.ServicePlan("example", new()
{
Name = "example",
ResourceGroupName = example.Name,
Location = example.Location,
OsType = "Linux",
SkuName = "I1v2",
AppServiceEnvironmentId = exampleEnvironmentV3.Id,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azure.core.ResourceGroup;
import com.pulumi.azure.core.ResourceGroupArgs;
import com.pulumi.azure.network.VirtualNetwork;
import com.pulumi.azure.network.VirtualNetworkArgs;
import com.pulumi.azure.network.Subnet;
import com.pulumi.azure.network.SubnetArgs;
import com.pulumi.azure.network.inputs.SubnetDelegationArgs;
import com.pulumi.azure.network.inputs.SubnetDelegationServiceDelegationArgs;
import com.pulumi.azure.appservice.EnvironmentV3;
import com.pulumi.azure.appservice.EnvironmentV3Args;
import com.pulumi.azure.appservice.inputs.EnvironmentV3ClusterSettingArgs;
import com.pulumi.azure.appservice.ServicePlan;
import com.pulumi.azure.appservice.ServicePlanArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var example = new ResourceGroup("example", ResourceGroupArgs.builder()
.name("exampleRG1")
.location("West Europe")
.build());
var exampleVirtualNetwork = new VirtualNetwork("exampleVirtualNetwork", VirtualNetworkArgs.builder()
.name("example-vnet")
.location(example.location())
.resourceGroupName(example.name())
.addressSpaces("10.0.0.0/16")
.build());
var exampleSubnet = new Subnet("exampleSubnet", SubnetArgs.builder()
.name("example-subnet")
.resourceGroupName(example.name())
.virtualNetworkName(exampleVirtualNetwork.name())
.addressPrefixes("10.0.2.0/24")
.delegations(SubnetDelegationArgs.builder()
.name("Microsoft.Web.hostingEnvironments")
.serviceDelegation(SubnetDelegationServiceDelegationArgs.builder()
.name("Microsoft.Web/hostingEnvironments")
.actions("Microsoft.Network/virtualNetworks/subnets/action")
.build())
.build())
.build());
var exampleEnvironmentV3 = new EnvironmentV3("exampleEnvironmentV3", EnvironmentV3Args.builder()
.name("example-asev3")
.resourceGroupName(example.name())
.subnetId(exampleSubnet.id())
.internalLoadBalancingMode("Web, Publishing")
.clusterSettings(
EnvironmentV3ClusterSettingArgs.builder()
.name("DisableTls1.0")
.value("1")
.build(),
EnvironmentV3ClusterSettingArgs.builder()
.name("InternalEncryption")
.value("true")
.build(),
EnvironmentV3ClusterSettingArgs.builder()
.name("FrontEndSSLCipherSuiteOrder")
.value("TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256")
.build())
.tags(Map.ofEntries(
Map.entry("env", "production"),
Map.entry("terraformed", "true")
))
.build());
var exampleServicePlan = new ServicePlan("exampleServicePlan", ServicePlanArgs.builder()
.name("example")
.resourceGroupName(example.name())
.location(example.location())
.osType("Linux")
.skuName("I1v2")
.appServiceEnvironmentId(exampleEnvironmentV3.id())
.build());
}
}
resources:
example:
type: azure:core:ResourceGroup
properties:
name: exampleRG1
location: West Europe
exampleVirtualNetwork:
type: azure:network:VirtualNetwork
name: example
properties:
name: example-vnet
location: ${example.location}
resourceGroupName: ${example.name}
addressSpaces:
- 10.0.0.0/16
exampleSubnet:
type: azure:network:Subnet
name: example
properties:
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
exampleEnvironmentV3:
type: azure:appservice:EnvironmentV3
name: example
properties:
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'
exampleServicePlan:
type: azure:appservice:ServicePlan
name: example
properties:
name: example
resourceGroupName: ${example.name}
location: ${example.location}
osType: Linux
skuName: I1v2
appServiceEnvironmentId: ${exampleEnvironmentV3.id}
Create EnvironmentV3 Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new EnvironmentV3(name: string, args: EnvironmentV3Args, opts?: CustomResourceOptions);
@overload
def EnvironmentV3(resource_name: str,
args: EnvironmentV3Args,
opts: Optional[ResourceOptions] = None)
@overload
def EnvironmentV3(resource_name: str,
opts: Optional[ResourceOptions] = None,
resource_group_name: Optional[str] = None,
subnet_id: Optional[str] = None,
allow_new_private_endpoint_connections: Optional[bool] = None,
cluster_settings: Optional[Sequence[EnvironmentV3ClusterSettingArgs]] = None,
dedicated_host_count: Optional[int] = None,
internal_load_balancing_mode: Optional[str] = None,
name: Optional[str] = None,
remote_debugging_enabled: Optional[bool] = None,
tags: Optional[Mapping[str, str]] = None,
zone_redundant: Optional[bool] = None)
func NewEnvironmentV3(ctx *Context, name string, args EnvironmentV3Args, opts ...ResourceOption) (*EnvironmentV3, error)
public EnvironmentV3(string name, EnvironmentV3Args args, CustomResourceOptions? opts = null)
public EnvironmentV3(String name, EnvironmentV3Args args)
public EnvironmentV3(String name, EnvironmentV3Args args, CustomResourceOptions options)
type: azure:appservice:EnvironmentV3
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args EnvironmentV3Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args EnvironmentV3Args
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args EnvironmentV3Args
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args EnvironmentV3Args
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args EnvironmentV3Args
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var environmentV3Resource = new Azure.AppService.EnvironmentV3("environmentV3Resource", new()
{
ResourceGroupName = "string",
SubnetId = "string",
AllowNewPrivateEndpointConnections = false,
ClusterSettings = new[]
{
new Azure.AppService.Inputs.EnvironmentV3ClusterSettingArgs
{
Name = "string",
Value = "string",
},
},
DedicatedHostCount = 0,
InternalLoadBalancingMode = "string",
Name = "string",
RemoteDebuggingEnabled = false,
Tags =
{
{ "string", "string" },
},
ZoneRedundant = false,
});
example, err := appservice.NewEnvironmentV3(ctx, "environmentV3Resource", &appservice.EnvironmentV3Args{
ResourceGroupName: pulumi.String("string"),
SubnetId: pulumi.String("string"),
AllowNewPrivateEndpointConnections: pulumi.Bool(false),
ClusterSettings: appservice.EnvironmentV3ClusterSettingArray{
&appservice.EnvironmentV3ClusterSettingArgs{
Name: pulumi.String("string"),
Value: pulumi.String("string"),
},
},
DedicatedHostCount: pulumi.Int(0),
InternalLoadBalancingMode: pulumi.String("string"),
Name: pulumi.String("string"),
RemoteDebuggingEnabled: pulumi.Bool(false),
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
ZoneRedundant: pulumi.Bool(false),
})
var environmentV3Resource = new EnvironmentV3("environmentV3Resource", EnvironmentV3Args.builder()
.resourceGroupName("string")
.subnetId("string")
.allowNewPrivateEndpointConnections(false)
.clusterSettings(EnvironmentV3ClusterSettingArgs.builder()
.name("string")
.value("string")
.build())
.dedicatedHostCount(0)
.internalLoadBalancingMode("string")
.name("string")
.remoteDebuggingEnabled(false)
.tags(Map.of("string", "string"))
.zoneRedundant(false)
.build());
environment_v3_resource = azure.appservice.EnvironmentV3("environmentV3Resource",
resource_group_name="string",
subnet_id="string",
allow_new_private_endpoint_connections=False,
cluster_settings=[azure.appservice.EnvironmentV3ClusterSettingArgs(
name="string",
value="string",
)],
dedicated_host_count=0,
internal_load_balancing_mode="string",
name="string",
remote_debugging_enabled=False,
tags={
"string": "string",
},
zone_redundant=False)
const environmentV3Resource = new azure.appservice.EnvironmentV3("environmentV3Resource", {
resourceGroupName: "string",
subnetId: "string",
allowNewPrivateEndpointConnections: false,
clusterSettings: [{
name: "string",
value: "string",
}],
dedicatedHostCount: 0,
internalLoadBalancingMode: "string",
name: "string",
remoteDebuggingEnabled: false,
tags: {
string: "string",
},
zoneRedundant: false,
});
type: azure:appservice:EnvironmentV3
properties:
allowNewPrivateEndpointConnections: false
clusterSettings:
- name: string
value: string
dedicatedHostCount: 0
internalLoadBalancingMode: string
name: string
remoteDebuggingEnabled: false
resourceGroupName: string
subnetId: string
tags:
string: string
zoneRedundant: false
EnvironmentV3 Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The EnvironmentV3 resource accepts the following input properties:
- Resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - Subnet
Id string 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.- Allow
New boolPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - Cluster
Settings List<EnvironmentV3Cluster Setting> - Zero or more
cluster_setting
blocks as defined below. - Dedicated
Host intCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - Internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - Name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- Remote
Debugging boolEnabled - Whether to enable remote debug. Defaults to
false
. - Dictionary<string, string>
- Zone
Redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- Resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - Subnet
Id string 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.- Allow
New boolPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - Cluster
Settings []EnvironmentV3Cluster Setting Args - Zero or more
cluster_setting
blocks as defined below. - Dedicated
Host intCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - Internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - Name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- Remote
Debugging boolEnabled - Whether to enable remote debug. Defaults to
false
. - map[string]string
- Zone
Redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- resource
Group StringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id String 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.- allow
New BooleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings List<EnvironmentV3Cluster Setting> - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host IntegerCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - internal
Load StringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - name String
- The name of the App Service Environment. Changing this forces a new resource to be created.
- remote
Debugging BooleanEnabled - Whether to enable remote debug. Defaults to
false
. - Map<String,String>
- zone
Redundant Boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id string 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.- allow
New booleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings EnvironmentV3Cluster Setting[] - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host numberCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- remote
Debugging booleanEnabled - Whether to enable remote debug. Defaults to
false
. - {[key: string]: string}
- zone
Redundant boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- resource_
group_ strname - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet_
id str 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.- allow_
new_ boolprivate_ endpoint_ connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster_
settings Sequence[EnvironmentV3Cluster Setting Args] - Zero or more
cluster_setting
blocks as defined below. - dedicated_
host_ intcount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - internal_
load_ strbalancing_ mode - 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 toNone
. Changing this forces a new resource to be created. - name str
- The name of the App Service Environment. Changing this forces a new resource to be created.
- remote_
debugging_ boolenabled - Whether to enable remote debug. Defaults to
false
. - Mapping[str, str]
- zone_
redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- resource
Group StringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id String 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.- allow
New BooleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings List<Property Map> - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host NumberCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - internal
Load StringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - name String
- The name of the App Service Environment. Changing this forces a new resource to be created.
- remote
Debugging BooleanEnabled - Whether to enable remote debug. Defaults to
false
. - Map<String>
- zone
Redundant Boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
Outputs
All input properties are implicitly available as output properties. Additionally, the EnvironmentV3 resource produces the following output properties:
- Dns
Suffix string - the DNS suffix for this App Service Environment V3.
- External
Inbound List<string>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- Id string
- The provider-assigned unique ID for this managed resource.
- Inbound
Network List<EnvironmentDependencies V3Inbound Network Dependency> - An
inbound_network_dependencies
block as defined below. - Internal
Inbound List<string>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- Ip
Ssl intAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- Linux
Outbound List<string>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- Location string
- The location where the App Service Environment exists.
- Pricing
Tier string - Pricing tier for the front end instances.
- Windows
Outbound List<string>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- Dns
Suffix string - the DNS suffix for this App Service Environment V3.
- External
Inbound []stringIp Addresses - The external inbound IP addresses of the App Service Environment V3.
- Id string
- The provider-assigned unique ID for this managed resource.
- Inbound
Network []EnvironmentDependencies V3Inbound Network Dependency - An
inbound_network_dependencies
block as defined below. - Internal
Inbound []stringIp Addresses - The internal inbound IP addresses of the App Service Environment V3.
- Ip
Ssl intAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- Linux
Outbound []stringIp Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- Location string
- The location where the App Service Environment exists.
- Pricing
Tier string - Pricing tier for the front end instances.
- Windows
Outbound []stringIp Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- dns
Suffix String - the DNS suffix for this App Service Environment V3.
- external
Inbound List<String>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- id String
- The provider-assigned unique ID for this managed resource.
- inbound
Network List<EnvironmentDependencies V3Inbound Network Dependency> - An
inbound_network_dependencies
block as defined below. - internal
Inbound List<String>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- ip
Ssl IntegerAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound List<String>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location String
- The location where the App Service Environment exists.
- pricing
Tier String - Pricing tier for the front end instances.
- windows
Outbound List<String>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- dns
Suffix string - the DNS suffix for this App Service Environment V3.
- external
Inbound string[]Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- id string
- The provider-assigned unique ID for this managed resource.
- inbound
Network EnvironmentDependencies V3Inbound Network Dependency[] - An
inbound_network_dependencies
block as defined below. - internal
Inbound string[]Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- ip
Ssl numberAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound string[]Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location string
- The location where the App Service Environment exists.
- pricing
Tier string - Pricing tier for the front end instances.
- windows
Outbound string[]Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- dns_
suffix str - the DNS suffix for this App Service Environment V3.
- external_
inbound_ Sequence[str]ip_ addresses - The external inbound IP addresses of the App Service Environment V3.
- id str
- The provider-assigned unique ID for this managed resource.
- inbound_
network_ Sequence[Environmentdependencies V3Inbound Network Dependency] - An
inbound_network_dependencies
block as defined below. - internal_
inbound_ Sequence[str]ip_ addresses - The internal inbound IP addresses of the App Service Environment V3.
- ip_
ssl_ intaddress_ count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux_
outbound_ Sequence[str]ip_ addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location str
- The location where the App Service Environment exists.
- pricing_
tier str - Pricing tier for the front end instances.
- windows_
outbound_ Sequence[str]ip_ addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- dns
Suffix String - the DNS suffix for this App Service Environment V3.
- external
Inbound List<String>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- id String
- The provider-assigned unique ID for this managed resource.
- inbound
Network List<Property Map>Dependencies - An
inbound_network_dependencies
block as defined below. - internal
Inbound List<String>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- ip
Ssl NumberAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound List<String>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location String
- The location where the App Service Environment exists.
- pricing
Tier String - Pricing tier for the front end instances.
- windows
Outbound List<String>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
Look up Existing EnvironmentV3 Resource
Get an existing EnvironmentV3 resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: EnvironmentV3State, opts?: CustomResourceOptions): EnvironmentV3
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
allow_new_private_endpoint_connections: Optional[bool] = None,
cluster_settings: Optional[Sequence[EnvironmentV3ClusterSettingArgs]] = None,
dedicated_host_count: Optional[int] = None,
dns_suffix: Optional[str] = None,
external_inbound_ip_addresses: Optional[Sequence[str]] = None,
inbound_network_dependencies: Optional[Sequence[EnvironmentV3InboundNetworkDependencyArgs]] = None,
internal_inbound_ip_addresses: Optional[Sequence[str]] = None,
internal_load_balancing_mode: Optional[str] = None,
ip_ssl_address_count: Optional[int] = None,
linux_outbound_ip_addresses: Optional[Sequence[str]] = None,
location: Optional[str] = None,
name: Optional[str] = None,
pricing_tier: Optional[str] = None,
remote_debugging_enabled: Optional[bool] = None,
resource_group_name: Optional[str] = None,
subnet_id: Optional[str] = None,
tags: Optional[Mapping[str, str]] = None,
windows_outbound_ip_addresses: Optional[Sequence[str]] = None,
zone_redundant: Optional[bool] = None) -> EnvironmentV3
func GetEnvironmentV3(ctx *Context, name string, id IDInput, state *EnvironmentV3State, opts ...ResourceOption) (*EnvironmentV3, error)
public static EnvironmentV3 Get(string name, Input<string> id, EnvironmentV3State? state, CustomResourceOptions? opts = null)
public static EnvironmentV3 get(String name, Output<String> id, EnvironmentV3State state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Allow
New boolPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - Cluster
Settings List<EnvironmentV3Cluster Setting> - Zero or more
cluster_setting
blocks as defined below. - Dedicated
Host intCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - Dns
Suffix string - the DNS suffix for this App Service Environment V3.
- External
Inbound List<string>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- Inbound
Network List<EnvironmentDependencies V3Inbound Network Dependency> - An
inbound_network_dependencies
block as defined below. - Internal
Inbound List<string>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- Internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - Ip
Ssl intAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- Linux
Outbound List<string>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- Location string
- The location where the App Service Environment exists.
- Name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- Pricing
Tier string - Pricing tier for the front end instances.
- Remote
Debugging boolEnabled - Whether to enable remote debug. Defaults to
false
. - Resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - Subnet
Id string 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.- Dictionary<string, string>
- Windows
Outbound List<string>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- Zone
Redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- Allow
New boolPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - Cluster
Settings []EnvironmentV3Cluster Setting Args - Zero or more
cluster_setting
blocks as defined below. - Dedicated
Host intCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - Dns
Suffix string - the DNS suffix for this App Service Environment V3.
- External
Inbound []stringIp Addresses - The external inbound IP addresses of the App Service Environment V3.
- Inbound
Network []EnvironmentDependencies V3Inbound Network Dependency Args - An
inbound_network_dependencies
block as defined below. - Internal
Inbound []stringIp Addresses - The internal inbound IP addresses of the App Service Environment V3.
- Internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - Ip
Ssl intAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- Linux
Outbound []stringIp Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- Location string
- The location where the App Service Environment exists.
- Name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- Pricing
Tier string - Pricing tier for the front end instances.
- Remote
Debugging boolEnabled - Whether to enable remote debug. Defaults to
false
. - Resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - Subnet
Id string 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.- map[string]string
- Windows
Outbound []stringIp Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- Zone
Redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- allow
New BooleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings List<EnvironmentV3Cluster Setting> - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host IntegerCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - dns
Suffix String - the DNS suffix for this App Service Environment V3.
- external
Inbound List<String>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- inbound
Network List<EnvironmentDependencies V3Inbound Network Dependency> - An
inbound_network_dependencies
block as defined below. - internal
Inbound List<String>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- internal
Load StringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - ip
Ssl IntegerAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound List<String>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location String
- The location where the App Service Environment exists.
- name String
- The name of the App Service Environment. Changing this forces a new resource to be created.
- pricing
Tier String - Pricing tier for the front end instances.
- remote
Debugging BooleanEnabled - Whether to enable remote debug. Defaults to
false
. - resource
Group StringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id String 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.- Map<String,String>
- windows
Outbound List<String>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- zone
Redundant Boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- allow
New booleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings EnvironmentV3Cluster Setting[] - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host numberCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - dns
Suffix string - the DNS suffix for this App Service Environment V3.
- external
Inbound string[]Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- inbound
Network EnvironmentDependencies V3Inbound Network Dependency[] - An
inbound_network_dependencies
block as defined below. - internal
Inbound string[]Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- internal
Load stringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - ip
Ssl numberAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound string[]Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location string
- The location where the App Service Environment exists.
- name string
- The name of the App Service Environment. Changing this forces a new resource to be created.
- pricing
Tier string - Pricing tier for the front end instances.
- remote
Debugging booleanEnabled - Whether to enable remote debug. Defaults to
false
. - resource
Group stringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id string 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.- {[key: string]: string}
- windows
Outbound string[]Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- zone
Redundant boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- allow_
new_ boolprivate_ endpoint_ connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster_
settings Sequence[EnvironmentV3Cluster Setting Args] - Zero or more
cluster_setting
blocks as defined below. - dedicated_
host_ intcount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - dns_
suffix str - the DNS suffix for this App Service Environment V3.
- external_
inbound_ Sequence[str]ip_ addresses - The external inbound IP addresses of the App Service Environment V3.
- inbound_
network_ Sequence[Environmentdependencies V3Inbound Network Dependency Args] - An
inbound_network_dependencies
block as defined below. - internal_
inbound_ Sequence[str]ip_ addresses - The internal inbound IP addresses of the App Service Environment V3.
- internal_
load_ strbalancing_ mode - 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 toNone
. Changing this forces a new resource to be created. - ip_
ssl_ intaddress_ count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux_
outbound_ Sequence[str]ip_ addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location str
- The location where the App Service Environment exists.
- name str
- The name of the App Service Environment. Changing this forces a new resource to be created.
- pricing_
tier str - Pricing tier for the front end instances.
- remote_
debugging_ boolenabled - Whether to enable remote debug. Defaults to
false
. - resource_
group_ strname - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet_
id str 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.- Mapping[str, str]
- windows_
outbound_ Sequence[str]ip_ addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- zone_
redundant bool 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. You can only set eitherdedicated_host_count
orzone_redundant
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
- allow
New BooleanPrivate Endpoint Connections - Should new Private Endpoint Connections be allowed. Defaults to
true
. - cluster
Settings List<Property Map> - Zero or more
cluster_setting
blocks as defined below. - dedicated
Host NumberCount - This ASEv3 should use dedicated Hosts. Possible values are
2
. Changing this forces a new resource to be created. - dns
Suffix String - the DNS suffix for this App Service Environment V3.
- external
Inbound List<String>Ip Addresses - The external inbound IP addresses of the App Service Environment V3.
- inbound
Network List<Property Map>Dependencies - An
inbound_network_dependencies
block as defined below. - internal
Inbound List<String>Ip Addresses - The internal inbound IP addresses of the App Service Environment V3.
- internal
Load StringBalancing Mode - 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 toNone
. Changing this forces a new resource to be created. - ip
Ssl NumberAddress Count - The number of IP SSL addresses reserved for the App Service Environment V3.
- linux
Outbound List<String>Ip Addresses - Outbound addresses of Linux based Apps in this App Service Environment V3
- location String
- The location where the App Service Environment exists.
- name String
- The name of the App Service Environment. Changing this forces a new resource to be created.
- pricing
Tier String - Pricing tier for the front end instances.
- remote
Debugging BooleanEnabled - Whether to enable remote debug. Defaults to
false
. - resource
Group StringName - The name of the Resource Group where the App Service Environment exists. Defaults to the Resource Group of the Subnet (specified by
subnet_id
). Changing this forces a new resource to be created. - subnet
Id String 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.- Map<String>
- windows
Outbound List<String>Ip Addresses - Outbound addresses of Windows based Apps in this App Service Environment V3.
- zone
Redundant Boolean 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. You can only set eitherdedicated_host_count
orzone_redundant
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
Supporting Types
EnvironmentV3ClusterSetting, EnvironmentV3ClusterSettingArgs
EnvironmentV3InboundNetworkDependency, EnvironmentV3InboundNetworkDependencyArgs
- Description string
- A short description of the purpose of the network traffic.
- Ip
Addresses List<string> - A list of IP addresses that network traffic will originate from in CIDR notation.
- Ports List<string>
- The ports that network traffic will arrive to the App Service Environment V3 on.
- Description string
- A short description of the purpose of the network traffic.
- Ip
Addresses []string - A list of IP addresses that network traffic will originate from in CIDR notation.
- Ports []string
- The ports that network traffic will arrive to the App Service Environment V3 on.
- description String
- A short description of the purpose of the network traffic.
- ip
Addresses List<String> - A list of IP addresses that network traffic will originate from in CIDR notation.
- ports List<String>
- The ports that network traffic will arrive to the App Service Environment V3 on.
- description string
- A short description of the purpose of the network traffic.
- ip
Addresses string[] - A list of IP addresses that network traffic will originate from in CIDR notation.
- ports string[]
- The ports that network traffic will arrive to the App Service Environment V3 on.
- description str
- A short description of the purpose of the network traffic.
- ip_
addresses Sequence[str] - A list of IP addresses that network traffic will originate from in CIDR notation.
- ports Sequence[str]
- The ports that network traffic will arrive to the App Service Environment V3 on.
- description String
- A short description of the purpose of the network traffic.
- ip
Addresses List<String> - A list of IP addresses that network traffic will originate from in CIDR notation.
- ports List<String>
- The ports that network traffic will arrive to the App Service Environment V3 on.
Import
A 3rd Generation (v3) App Service Environment can be imported using the resource id
, e.g.
$ pulumi import azure:appservice/environmentV3:EnvironmentV3 myAppServiceEnv /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Web/hostingEnvironments/myAppServiceEnv
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- Azure Classic pulumi/pulumi-azure
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
azurerm
Terraform Provider.