Microsoft.Web hostingEnvironments 2018-02-01
Bicep resource definition
The hostingEnvironments resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
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@2018-02-01' = {
kind: 'string'
location: 'string'
name: 'string'
properties: {
apiManagementAccountId: 'string'
clusterSettings: [
{
name: 'string'
value: 'string'
}
]
dnsSuffix: 'string'
dynamicCacheEnabled: bool
frontEndScaleFactor: int
hasLinuxWorkers: bool
internalLoadBalancingMode: 'string'
ipsslAddressCount: int
location: 'string'
multiRoleCount: int
multiSize: 'string'
name: 'string'
networkAccessControlList: [
{
action: 'string'
description: 'string'
order: int
remoteSubnet: 'string'
}
]
sslCertKeyVaultId: 'string'
sslCertKeyVaultSecretName: 'string'
suspended: bool
userWhitelistedIpRanges: [
'string'
]
virtualNetwork: {
id: 'string'
subnet: 'string'
}
vnetName: 'string'
vnetResourceGroupName: 'string'
vnetSubnetName: 'string'
workerPools: [
{
computeMode: 'string'
workerCount: int
workerSize: 'string'
workerSizeId: int
}
]
}
tags: {
{customized property}: 'string'
}
}
Property values
AppServiceEnvironment
Name | Description | Value |
---|---|---|
apiManagementAccountId | API Management Account associated with the App Service Environment. | string |
clusterSettings | Custom settings for changing the behavior of the App Service Environment. | NameValuePair[] |
dnsSuffix | DNS suffix of the App Service Environment. | string |
dynamicCacheEnabled | True/false indicating whether the App Service Environment is suspended. The environment can be suspended e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
frontEndScaleFactor | Scale factor for front-ends. | int |
hasLinuxWorkers | Flag that displays whether an ASE has linux workers or not | bool |
internalLoadBalancingMode | Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. | 'None' 'Publishing' 'Web' |
ipsslAddressCount | Number of IP SSL addresses reserved for the App Service Environment. | int |
location | Location of the App Service Environment, e.g. "West US". | string (required) |
multiRoleCount | Number of front-end instances. | int |
multiSize | Front-end VM size, e.g. "Medium", "Large". | string |
name | Name of the App Service Environment. | string (required) |
networkAccessControlList | Access control list for controlling traffic to the App Service Environment. | NetworkAccessControlEntry[] |
sslCertKeyVaultId | Key Vault ID for ILB App Service Environment default SSL certificate | string |
sslCertKeyVaultSecretName | Key Vault Secret Name for ILB App Service Environment default SSL certificate | string |
suspended | <code>true</code> if the App Service Environment is suspended; otherwise, <code>false</code>. The environment can be suspended, e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
userWhitelistedIpRanges | User added list of IP Ranges allowed on ASE db | string[] |
virtualNetwork | Description of the Virtual Network. | VirtualNetworkProfile (required) |
vnetName | Name of the Virtual Network for the App Service Environment. | string |
vnetResourceGroupName | Resource group of the Virtual Network. | string |
vnetSubnetName | Subnet of the Virtual Network. | string |
workerPools | Description of worker pools with worker size IDs, VM sizes, and number of workers in each pool. | WorkerPool[] (required) |
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 |
NetworkAccessControlEntry
Name | Description | Value |
---|---|---|
action | Action object. | 'Deny' 'Permit' |
description | Description of network access control entry. | string |
order | Order of precedence. | int |
remoteSubnet | Remote subnet. | string |
ResourceTags
Name | Description | Value |
---|
VirtualNetworkProfile
Name | Description | Value |
---|---|---|
id | Resource id of the Virtual Network. | string |
subnet | Subnet within the Virtual Network. | string |
WorkerPool
Name | Description | Value |
---|---|---|
computeMode | Shared or dedicated app hosting. | 'Dedicated' 'Dynamic' 'Shared' |
workerCount | Number of instances in the worker pool. | int |
workerSize | VM size of the worker pool instances. | string |
workerSizeId | Worker size ID for referencing this worker pool. | int |
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:
- Resource groups - See resource group deployment commands
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": "2018-02-01",
"name": "string",
"kind": "string",
"location": "string",
"properties": {
"apiManagementAccountId": "string",
"clusterSettings": [
{
"name": "string",
"value": "string"
}
],
"dnsSuffix": "string",
"dynamicCacheEnabled": "bool",
"frontEndScaleFactor": "int",
"hasLinuxWorkers": "bool",
"internalLoadBalancingMode": "string",
"ipsslAddressCount": "int",
"location": "string",
"multiRoleCount": "int",
"multiSize": "string",
"name": "string",
"networkAccessControlList": [
{
"action": "string",
"description": "string",
"order": "int",
"remoteSubnet": "string"
}
],
"sslCertKeyVaultId": "string",
"sslCertKeyVaultSecretName": "string",
"suspended": "bool",
"userWhitelistedIpRanges": [ "string" ],
"virtualNetwork": {
"id": "string",
"subnet": "string"
},
"vnetName": "string",
"vnetResourceGroupName": "string",
"vnetSubnetName": "string",
"workerPools": [
{
"computeMode": "string",
"workerCount": "int",
"workerSize": "string",
"workerSizeId": "int"
}
]
},
"tags": {
"{customized property}": "string"
}
}
Property values
AppServiceEnvironment
Name | Description | Value |
---|---|---|
apiManagementAccountId | API Management Account associated with the App Service Environment. | string |
clusterSettings | Custom settings for changing the behavior of the App Service Environment. | NameValuePair[] |
dnsSuffix | DNS suffix of the App Service Environment. | string |
dynamicCacheEnabled | True/false indicating whether the App Service Environment is suspended. The environment can be suspended e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
frontEndScaleFactor | Scale factor for front-ends. | int |
hasLinuxWorkers | Flag that displays whether an ASE has linux workers or not | bool |
internalLoadBalancingMode | Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. | 'None' 'Publishing' 'Web' |
ipsslAddressCount | Number of IP SSL addresses reserved for the App Service Environment. | int |
location | Location of the App Service Environment, e.g. "West US". | string (required) |
multiRoleCount | Number of front-end instances. | int |
multiSize | Front-end VM size, e.g. "Medium", "Large". | string |
name | Name of the App Service Environment. | string (required) |
networkAccessControlList | Access control list for controlling traffic to the App Service Environment. | NetworkAccessControlEntry[] |
sslCertKeyVaultId | Key Vault ID for ILB App Service Environment default SSL certificate | string |
sslCertKeyVaultSecretName | Key Vault Secret Name for ILB App Service Environment default SSL certificate | string |
suspended | <code>true</code> if the App Service Environment is suspended; otherwise, <code>false</code>. The environment can be suspended, e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
userWhitelistedIpRanges | User added list of IP Ranges allowed on ASE db | string[] |
virtualNetwork | Description of the Virtual Network. | VirtualNetworkProfile (required) |
vnetName | Name of the Virtual Network for the App Service Environment. | string |
vnetResourceGroupName | Resource group of the Virtual Network. | string |
vnetSubnetName | Subnet of the Virtual Network. | string |
workerPools | Description of worker pools with worker size IDs, VM sizes, and number of workers in each pool. | WorkerPool[] (required) |
Microsoft.Web/hostingEnvironments
Name | Description | Value |
---|---|---|
apiVersion | The api version | '2018-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 |
NetworkAccessControlEntry
Name | Description | Value |
---|---|---|
action | Action object. | 'Deny' 'Permit' |
description | Description of network access control entry. | string |
order | Order of precedence. | int |
remoteSubnet | Remote subnet. | string |
ResourceTags
Name | Description | Value |
---|
VirtualNetworkProfile
Name | Description | Value |
---|---|---|
id | Resource id of the Virtual Network. | string |
subnet | Subnet within the Virtual Network. | string |
WorkerPool
Name | Description | Value |
---|---|---|
computeMode | Shared or dedicated app hosting. | 'Dedicated' 'Dynamic' 'Shared' |
workerCount | Number of instances in the worker pool. | int |
workerSize | VM size of the worker pool instances. | string |
workerSizeId | Worker size ID for referencing this worker pool. | int |
Quickstart templates
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
App Service Environment with Azure SQL backend |
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 |
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 |
Creates an App Service Environment in your virtual network |
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 |
Create App Service Environment v2 with an ILB Address |
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 |
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 |
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 |
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 |
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@2018-02-01"
name = "string"
kind = "string"
location = "string"
body = jsonencode({
properties = {
apiManagementAccountId = "string"
clusterSettings = [
{
name = "string"
value = "string"
}
]
dnsSuffix = "string"
dynamicCacheEnabled = bool
frontEndScaleFactor = int
hasLinuxWorkers = bool
internalLoadBalancingMode = "string"
ipsslAddressCount = int
location = "string"
multiRoleCount = int
multiSize = "string"
name = "string"
networkAccessControlList = [
{
action = "string"
description = "string"
order = int
remoteSubnet = "string"
}
]
sslCertKeyVaultId = "string"
sslCertKeyVaultSecretName = "string"
suspended = bool
userWhitelistedIpRanges = [
"string"
]
virtualNetwork = {
id = "string"
subnet = "string"
}
vnetName = "string"
vnetResourceGroupName = "string"
vnetSubnetName = "string"
workerPools = [
{
computeMode = "string"
workerCount = int
workerSize = "string"
workerSizeId = int
}
]
}
})
tags = {
{customized property} = "string"
}
}
Property values
AppServiceEnvironment
Name | Description | Value |
---|---|---|
apiManagementAccountId | API Management Account associated with the App Service Environment. | string |
clusterSettings | Custom settings for changing the behavior of the App Service Environment. | NameValuePair[] |
dnsSuffix | DNS suffix of the App Service Environment. | string |
dynamicCacheEnabled | True/false indicating whether the App Service Environment is suspended. The environment can be suspended e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
frontEndScaleFactor | Scale factor for front-ends. | int |
hasLinuxWorkers | Flag that displays whether an ASE has linux workers or not | bool |
internalLoadBalancingMode | Specifies which endpoints to serve internally in the Virtual Network for the App Service Environment. | 'None' 'Publishing' 'Web' |
ipsslAddressCount | Number of IP SSL addresses reserved for the App Service Environment. | int |
location | Location of the App Service Environment, e.g. "West US". | string (required) |
multiRoleCount | Number of front-end instances. | int |
multiSize | Front-end VM size, e.g. "Medium", "Large". | string |
name | Name of the App Service Environment. | string (required) |
networkAccessControlList | Access control list for controlling traffic to the App Service Environment. | NetworkAccessControlEntry[] |
sslCertKeyVaultId | Key Vault ID for ILB App Service Environment default SSL certificate | string |
sslCertKeyVaultSecretName | Key Vault Secret Name for ILB App Service Environment default SSL certificate | string |
suspended | <code>true</code> if the App Service Environment is suspended; otherwise, <code>false</code>. The environment can be suspended, e.g. when the management endpoint is no longer available (most likely because NSG blocked the incoming traffic). |
bool |
userWhitelistedIpRanges | User added list of IP Ranges allowed on ASE db | string[] |
virtualNetwork | Description of the Virtual Network. | VirtualNetworkProfile (required) |
vnetName | Name of the Virtual Network for the App Service Environment. | string |
vnetResourceGroupName | Resource group of the Virtual Network. | string |
vnetSubnetName | Subnet of the Virtual Network. | string |
workerPools | Description of worker pools with worker size IDs, VM sizes, and number of workers in each pool. | WorkerPool[] (required) |
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@2018-02-01" |
NameValuePair
Name | Description | Value |
---|---|---|
name | Pair name. | string |
value | Pair value. | string |
NetworkAccessControlEntry
Name | Description | Value |
---|---|---|
action | Action object. | 'Deny' 'Permit' |
description | Description of network access control entry. | string |
order | Order of precedence. | int |
remoteSubnet | Remote subnet. | string |
ResourceTags
Name | Description | Value |
---|
VirtualNetworkProfile
Name | Description | Value |
---|---|---|
id | Resource id of the Virtual Network. | string |
subnet | Subnet within the Virtual Network. | string |
WorkerPool
Name | Description | Value |
---|---|---|
computeMode | Shared or dedicated app hosting. | 'Dedicated' 'Dynamic' 'Shared' |
workerCount | Number of instances in the worker pool. | int |
workerSize | VM size of the worker pool instances. | string |
workerSizeId | Worker size ID for referencing this worker pool. | int |