pulumi-azure-kotlin/com.pulumi.azure.appservice.kotlin/EnvironmentV3Args

EnvironmentV3Args

data class EnvironmentV3Args(val allowNewPrivateEndpointConnections: Output<Boolean>? = null, val clusterSettings: Output<List<EnvironmentV3ClusterSettingArgs>>? = null, val dedicatedHostCount: Output<Int>? = null, val internalLoadBalancingMode: Output<String>? = null, val name: Output<String>? = null, val remoteDebuggingEnabled: Output<Boolean>? = null, val resourceGroupName: Output<String>? = null, val subnetId: Output<String>? = null, val tags: Output<Map<String, String>>? = null, val zoneRedundant: Output<Boolean>? = null) : ConvertibleToJava<EnvironmentV3Args>

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&#46;0&#46;0&#46;0/16"],
});
const exampleSubnet = new azure.network.Subnet("example", {
    name: "example-subnet",
    resourceGroupName: example.name,
    virtualNetworkName: exampleVirtualNetwork.name,
    addressPrefixes: ["10&#46;0&#46;2&#46;0/24"],
    delegations: [{
        name: "Microsoft.Web.hostingEnvironments",
        serviceDelegation: {
            name: "Microsoft.Web/hostingEnvironments",
            actions: ["Microsoft&#46;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,
});
Content copied to clipboard
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&#46;0&#46;0&#46;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&#46;0&#46;2&#46;0/24"],
    delegations=[{
        "name": "Microsoft.Web.hostingEnvironments",
        "service_delegation": {
            "name": "Microsoft.Web/hostingEnvironments",
            "actions": ["Microsoft&#46;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=[
        {
            "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",
    })
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)
Content copied to clipboard
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,
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/appservice"
	"github.com/pulumi/pulumi-azure/sdk/v6/go/azure/core"
	"github.com/pulumi/pulumi-azure/sdk/v6/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
	})
}
Content copied to clipboard
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());
    }
}
Content copied to clipboard
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}
Content copied to clipboard

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
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(allowNewPrivateEndpointConnections: Output<Boolean>? = null, clusterSettings: Output<List<EnvironmentV3ClusterSettingArgs>>? = null, dedicatedHostCount: Output<Int>? = null, internalLoadBalancingMode: Output<String>? = null, name: Output<String>? = null, remoteDebuggingEnabled: Output<Boolean>? = null, resourceGroupName: Output<String>? = null, subnetId: Output<String>? = null, tags: Output<Map<String, String>>? = null, zoneRedundant: Output<Boolean>? = null)

Properties

Link copied to clipboard
val allowNewPrivateEndpointConnections: Output<Boolean>? = null

Should new Private Endpoint Connections be allowed. Defaults to true.

Link copied to clipboard
val clusterSettings: Output<List<EnvironmentV3ClusterSettingArgs>>? = null

Zero or more cluster_setting blocks as defined below.

Link copied to clipboard
val dedicatedHostCount: Output<Int>? = null

This ASEv3 should use dedicated Hosts. Possible values are 2. Changing this forces a new resource to be created.

Link copied to clipboard
val internalLoadBalancingMode: Output<String>? = null

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.

Link copied to clipboard
val name: Output<String>? = null

The name of the App Service Environment. Changing this forces a new resource to be created.

Link copied to clipboard
val remoteDebuggingEnabled: Output<Boolean>? = null

Whether to enable remote debug. Defaults to false.

Link copied to clipboard
val resourceGroupName: Output<String>? = null

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.

Link copied to clipboard
val subnetId: Output<String>? = null

The ID of the Subnet which the App Service Environment should be connected to. Changing this forces a new resource to be created.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null
Link copied to clipboard
val zoneRedundant: Output<Boolean>? = null

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 either dedicated_host_count or zone_redundant but not both. Changing this forces a new resource to be created.

Functions

Link copied to clipboard
open override fun toJava(): EnvironmentV3Args