Microsoft.Web hostingEnvironments 2021-02-01

Bicep resource definition

The hostingEnvironments resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Web/hostingEnvironments resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Web/hostingEnvironments@2021-02-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    clusterSettings: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    dedicatedHostCount: int
    dnsSuffix: 'string'
    frontEndScaleFactor: int
    internalLoadBalancingMode: 'string'
    ipsslAddressCount: int
    multiSize: 'string'
    userWhitelistedIpRanges: [
      'string'
    ]
    virtualNetwork: {
      id: 'string'
      subnet: 'string'
    }
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

AppServiceEnvironment

Name Description Value
clusterSettings Custom settings for changing the behavior of the App Service Environment. NameValuePair[]
dedicatedHostCount Dedicated Host Count int
dnsSuffix DNS suffix of the App Service Environment. string
frontEndScaleFactor Scale factor for front-ends. int
internalLoadBalancingMode Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. 'None'
'Publishing'
'Web'
'Web, Publishing'
ipsslAddressCount Number of IP SSL addresses reserved for the App Service Environment. int
multiSize Front-end VM size, e.g. "Medium", "Large". string
userWhitelistedIpRanges User added list of IP Ranges allowed on ASE db string[]
virtualNetwork Description of the Virtual Network. VirtualNetworkProfile (required)
zoneRedundant Whether or not this App Service Environment is zone-redundant. bool

Microsoft.Web/hostingEnvironments

Name Description Value
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties AppServiceEnvironment
tags Resource tags Dictionary of tag names and values. See Tags in templates

NameValuePair

Name Description Value
name Pair name. string
value Pair value. string

ResourceTags

Name Description Value

VirtualNetworkProfile

Name Description Value
id Resource id of the Virtual Network. string (required)
subnet Subnet within the Virtual Network. string

Quickstart samples

The following quickstart samples deploy this resource type.

Bicep File Description
App Service Environment with Hosting Plan and Azure WebApp Creates an App Service Environment v2 with an ILB Address in a existing virtual network that will be privately availible. The App Service Environment will contain a Hosting Plan and a Azure Web App
Create an App Service Environment v2 Creates an App Service Environment v2 in your virtual network
Create an AppServicePlan and App in an ASEv3 Create an AppServicePlan and App in an ASEv3

ARM template resource definition

The hostingEnvironments resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Web/hostingEnvironments resource, add the following JSON to your template.

{
  "type": "Microsoft.Web/hostingEnvironments",
  "apiVersion": "2021-02-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "clusterSettings": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "dedicatedHostCount": "int",
    "dnsSuffix": "string",
    "frontEndScaleFactor": "int",
    "internalLoadBalancingMode": "string",
    "ipsslAddressCount": "int",
    "multiSize": "string",
    "userWhitelistedIpRanges": [ "string" ],
    "virtualNetwork": {
      "id": "string",
      "subnet": "string"
    },
    "zoneRedundant": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

AppServiceEnvironment

Name Description Value
clusterSettings Custom settings for changing the behavior of the App Service Environment. NameValuePair[]
dedicatedHostCount Dedicated Host Count int
dnsSuffix DNS suffix of the App Service Environment. string
frontEndScaleFactor Scale factor for front-ends. int
internalLoadBalancingMode Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. 'None'
'Publishing'
'Web'
'Web, Publishing'
ipsslAddressCount Number of IP SSL addresses reserved for the App Service Environment. int
multiSize Front-end VM size, e.g. "Medium", "Large". string
userWhitelistedIpRanges User added list of IP Ranges allowed on ASE db string[]
virtualNetwork Description of the Virtual Network. VirtualNetworkProfile (required)
zoneRedundant Whether or not this App Service Environment is zone-redundant. bool

Microsoft.Web/hostingEnvironments

Name Description Value
apiVersion The api version '2021-02-01'
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties AppServiceEnvironment
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Web/hostingEnvironments'

NameValuePair

Name Description Value
name Pair name. string
value Pair value. string

ResourceTags

Name Description Value

VirtualNetworkProfile

Name Description Value
id Resource id of the Virtual Network. string (required)
subnet Subnet within the Virtual Network. string

Quickstart templates

The following quickstart templates deploy this resource type.

Template Description
App Service Environment with Azure SQL backend

Deploy to Azure
This template creates an App Service Environment with an Azure SQL backend along with private endpoints along with associated resources typically used in an private/isolated environment.
App Service Environment with Hosting Plan and Azure WebApp

Deploy to Azure
Creates an App Service Environment v2 with an ILB Address in a existing virtual network that will be privately availible. The App Service Environment will contain a Hosting Plan and a Azure Web App
Create an App Service Environment

Deploy to Azure
Creates an App Service Environment in your virtual network
Create an App Service Environment v2

Deploy to Azure
Creates an App Service Environment v2 in your virtual network
Create an AppServicePlan and App in an ASEv3

Deploy to Azure
Create an AppServicePlan and App in an ASEv3
Create App Service Environment v2 with an ILB Address

Deploy to Azure
Creates an App Service Environment v2 in your virtual network with a private internal load balancer address
Create App Service Environment with an ILB Address

Deploy to Azure
Creates an App Service Environment in your virtual network with a private internal load balancer address
Create Azure App Service Environment With An Web App Added

Deploy to Azure
Creates an Azure App Service Environment inside A Virtual Network Subnet. This template also adds a Azure Web App inside the App Service Environment. Template originally authored by Callum Brankin of PixelPin
ILB App Service Environment with Azure Firewall

Deploy to Azure
Resource Manager templates and parameters demonstrating how to deploy App Service environment with Azure Firewall integration
SSL certificate for an ILB ASE or an ILB ASE v2

Deploy to Azure
Configures the default SSL certificate for an ILB ASE or an ILB ASE v2

Terraform (AzAPI provider) resource definition

The hostingEnvironments resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Web/hostingEnvironments resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/hostingEnvironments@2021-02-01"
  name = "string"
  kind = "string"
  location = "string"
  body = jsonencode({
    properties = {
      clusterSettings = [
        {
          name = "string"
          value = "string"
        }
      ]
      dedicatedHostCount = int
      dnsSuffix = "string"
      frontEndScaleFactor = int
      internalLoadBalancingMode = "string"
      ipsslAddressCount = int
      multiSize = "string"
      userWhitelistedIpRanges = [
        "string"
      ]
      virtualNetwork = {
        id = "string"
        subnet = "string"
      }
      zoneRedundant = bool
    }
  })
  tags = {
    {customized property} = "string"
  }
}

Property values

AppServiceEnvironment

Name Description Value
clusterSettings Custom settings for changing the behavior of the App Service Environment. NameValuePair[]
dedicatedHostCount Dedicated Host Count int
dnsSuffix DNS suffix of the App Service Environment. string
frontEndScaleFactor Scale factor for front-ends. int
internalLoadBalancingMode Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. 'None'
'Publishing'
'Web'
'Web, Publishing'
ipsslAddressCount Number of IP SSL addresses reserved for the App Service Environment. int
multiSize Front-end VM size, e.g. "Medium", "Large". string
userWhitelistedIpRanges User added list of IP Ranges allowed on ASE db string[]
virtualNetwork Description of the Virtual Network. VirtualNetworkProfile (required)
zoneRedundant Whether or not this App Service Environment is zone-redundant. bool

Microsoft.Web/hostingEnvironments

Name Description Value
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties AppServiceEnvironment
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Web/hostingEnvironments@2021-02-01"

NameValuePair

Name Description Value
name Pair name. string
value Pair value. string

ResourceTags

Name Description Value

VirtualNetworkProfile

Name Description Value
id Resource id of the Virtual Network. string (required)
subnet Subnet within the Virtual Network. string