AppServiceEnvironment

class AppServiceEnvironment : KotlinCustomResource

App Service Environment ARM resource. Uses Azure REST API version 2024-04-01. In version 2.x of the Azure Native provider, it used API version 2022-09-01. Other available API versions: 2016-09-01, 2018-02-01, 2019-08-01, 2020-06-01, 2020-09-01, 2020-10-01, 2020-12-01, 2021-01-01, 2021-01-15, 2021-02-01, 2021-03-01, 2022-03-01, 2022-09-01, 2023-01-01, 2023-12-01. These can be accessed by generating a local SDK package using the CLI command pulumi package add azure-native web [ApiVersion]. See the ../../../version-guide/#accessing-any-api-version-via-local-packages for details.

Example Usage

Create or update an App Service Environment.

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AzureNative = Pulumi.AzureNative;
return await Deployment.RunAsync(() =>
{
var appServiceEnvironment = new AzureNative.Web.AppServiceEnvironment("appServiceEnvironment", new()
{
Kind = "Asev3",
Location = "South Central US",
Name = "test-ase",
ResourceGroupName = "test-rg",
VirtualNetwork = new AzureNative.Web.Inputs.VirtualNetworkProfileArgs
{
Id = "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/delegated",
},
});
});
package main
import (
web "github.com/pulumi/pulumi-azure-native-sdk/web/v2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := web.NewAppServiceEnvironment(ctx, "appServiceEnvironment", &web.AppServiceEnvironmentArgs{
Kind: pulumi.String("Asev3"),
Location: pulumi.String("South Central US"),
Name: pulumi.String("test-ase"),
ResourceGroupName: pulumi.String("test-rg"),
VirtualNetwork: &web.VirtualNetworkProfileArgs{
Id: pulumi.String("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/delegated"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.azurenative.web.AppServiceEnvironment;
import com.pulumi.azurenative.web.AppServiceEnvironmentArgs;
import com.pulumi.azurenative.web.inputs.VirtualNetworkProfileArgs;
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 appServiceEnvironment = new AppServiceEnvironment("appServiceEnvironment", AppServiceEnvironmentArgs.builder()
.kind("Asev3")
.location("South Central US")
.name("test-ase")
.resourceGroupName("test-rg")
.virtualNetwork(VirtualNetworkProfileArgs.builder()
.id("/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-rg/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/delegated")
.build())
.build());
}
}

Import

An existing resource can be imported using its type token, name, and identifier, e.g.

$ pulumi import azure-native:web:AppServiceEnvironment test-ase /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/hostingEnvironments/{name}

Properties

Link copied to clipboard
val azureApiVersion: Output<String>

The Azure API version of the resource.

Link copied to clipboard

Custom settings for changing the behavior of the App Service Environment.

Link copied to clipboard

Full view of the custom domain suffix configuration for ASEv3.

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

Dedicated Host Count

Link copied to clipboard
val dnsSuffix: Output<String>?

DNS suffix of the App Service Environment.

Link copied to clipboard
val frontEndScaleFactor: Output<Int>?

Scale factor for front-ends.

Link copied to clipboard

Flag that displays whether an ASE has linux workers or not

Link copied to clipboard
val id: Output<String>
Link copied to clipboard

Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment.

Link copied to clipboard
val ipsslAddressCount: Output<Int>?

Number of IP SSL addresses reserved for the App Service Environment.

Link copied to clipboard
val kind: Output<String>?

Kind of resource. If the resource is an app, you can refer to https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference for details supported values for kind.

Link copied to clipboard
val location: Output<String>

Resource Location.

Link copied to clipboard

Maximum number of VMs in the App Service Environment.

Link copied to clipboard
val multiRoleCount: Output<Int>

Number of front-end instances.

Link copied to clipboard
val multiSize: Output<String>?

Front-end VM size, e.g. "Medium", "Large".

Link copied to clipboard
val name: Output<String>

Resource Name.

Link copied to clipboard

Full view of networking configuration for an ASE.

Link copied to clipboard

Provisioning state of the App Service Environment.

Link copied to clipboard
val pulumiChildResources: Set<KotlinResource>
Link copied to clipboard
Link copied to clipboard
Link copied to clipboard
val status: Output<String>

Current status of the App Service Environment.

Link copied to clipboard
val suspended: Output<Boolean>

true if the App Service Environment is suspended; otherwise, false. The environment can be suspended, e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic).

Link copied to clipboard
val tags: Output<Map<String, String>>?

Resource tags.

Link copied to clipboard
val type: Output<String>

Resource type.

Link copied to clipboard

Whether an upgrade is available for this App Service Environment.

Link copied to clipboard

Upgrade Preference

Link copied to clipboard
val urn: Output<String>
Link copied to clipboard

User added ip ranges to whitelist on ASE db

Link copied to clipboard

Description of the Virtual Network.

Link copied to clipboard
val zoneRedundant: Output<Boolean>?

Whether or not this App Service Environment is zone-redundant.