Microsoft.Web/hostingEnvironments 2020-10-01 - Bicep, ARM template & Terraform AzAPI reference

Definición de recursos de Bicep

El tipo de recurso hostingEnvironments se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/hostingEnvironments, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.Web/hostingEnvironments@2020-10-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'
  }
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
apiManagementAccountId	Cuenta de API Management asociada a App Service Environment.	cuerda
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
dynamicCacheEnabled	True/false que indica si app Service Environment está suspendido. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
frontEndScaleFactor	Factor de escala para front-end.	Int
hasLinuxWorkers	Marca que muestra si un ASE tiene trabajos de Linux o no	Bool
internalLoadBalancingMode	Especifica los puntos de conexión que se van a servir internamente en la red virtual para App Service Environment.	'Ninguno' 'Publicación' 'Web' 'Web,Publishing'
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
ubicación	Ubicación de App Service Environment, por ejemplo, "Oeste de EE. UU.".	string (obligatorio)
multiRoleCount	Número de instancias de front-end.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
nombre	Nombre de App Service Environment.	string (obligatorio)
networkAccessControlList	Lista de control de acceso para controlar el tráfico a App Service Environment.	networkAccessControlEntry[]
sslCertKeyVaultId	Identificador de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
sslCertKeyVaultSecretName	Nombre secreto de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
suspendido	<código>true</code> si app Service Environment está suspendido; De lo contrario, <código>false</code>. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
userWhitelistedIpRanges	Lista agregada por el usuario de intervalos IP permitidos en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
vnetName	Nombre de la red virtual para App Service Environment.	cuerda
vnetResourceGroupName	Grupo de recursos de la red virtual.	cuerda
vnetSubnetName	Subred de la red virtual.	cuerda
workerPools	Descripción de los grupos de trabajo con identificadores de tamaño de trabajo, tamaños de máquina virtual y número de trabajos de cada grupo.	WorkerPool[] (obligatorio)

Microsoft.Web/hostingEnvironments

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos principales	AppServiceEnvironment
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NameValuePair

Nombre	Descripción	Valor
nombre	Nombre del par.	cuerda
valor	Valor del par.	cuerda

NetworkAccessControlEntry

Nombre	Descripción	Valor
acción	Objeto action.	'Denegar' 'Permitir'
descripción	Descripción de la entrada de control de acceso de red.	cuerda
orden	Orden de prioridad.	Int
remoteSubnet	Subred remota.	cuerda

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de recurso de la red virtual.	cuerda
subred	Subred dentro de la red virtual.	cuerda

WorkerPool

Nombre	Descripción	Valor
computeMode	Hospedaje de aplicaciones compartidas o dedicadas.	'Dedicado' "Dinámico" 'Compartido'
workerCount	Número de instancias del grupo de trabajo.	Int
workerSize	Tamaño de máquina virtual de las instancias del grupo de trabajo.	cuerda
workerSizeId	Identificador de tamaño de trabajo para hacer referencia a este grupo de trabajo.	Int

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep	Descripción
App Service Environment con el plan de hospedaje y azure WebApp	Crea una instancia de App Service Environment v2 con una dirección ILB en una red virtual existente que estará disponible de forma privada. App Service Environment contendrá un plan de hospedaje y una aplicación web de Azure
Crear una de App Service Environment v2	Crea una instancia de App Service Environment v2 en la red virtual
Crear una appServicePlan y una aplicación en un ASEv3	Creación de un AppServicePlan y una aplicación en un ASEv3

Definición de recursos de plantilla de ARM

El tipo de recurso hostingEnvironments se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/hostingEnvironments, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Web/hostingEnvironments",
  "apiVersion": "2020-10-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"
  }
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
apiManagementAccountId	Cuenta de API Management asociada a App Service Environment.	cuerda
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
dynamicCacheEnabled	True/false que indica si app Service Environment está suspendido. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
frontEndScaleFactor	Factor de escala para front-end.	Int
hasLinuxWorkers	Marca que muestra si un ASE tiene trabajos de Linux o no	Bool
internalLoadBalancingMode	Especifica los puntos de conexión que se van a servir internamente en la red virtual para App Service Environment.	'Ninguno' 'Publicación' 'Web' 'Web,Publishing'
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
ubicación	Ubicación de App Service Environment, por ejemplo, "Oeste de EE. UU.".	string (obligatorio)
multiRoleCount	Número de instancias de front-end.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
nombre	Nombre de App Service Environment.	string (obligatorio)
networkAccessControlList	Lista de control de acceso para controlar el tráfico a App Service Environment.	networkAccessControlEntry[]
sslCertKeyVaultId	Identificador de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
sslCertKeyVaultSecretName	Nombre secreto de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
suspendido	<código>true</code> si app Service Environment está suspendido; De lo contrario, <código>false</code>. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
userWhitelistedIpRanges	Lista agregada por el usuario de intervalos IP permitidos en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
vnetName	Nombre de la red virtual para App Service Environment.	cuerda
vnetResourceGroupName	Grupo de recursos de la red virtual.	cuerda
vnetSubnetName	Subred de la red virtual.	cuerda
workerPools	Descripción de los grupos de trabajo con identificadores de tamaño de trabajo, tamaños de máquina virtual y número de trabajos de cada grupo.	WorkerPool[] (obligatorio)

Microsoft.Web/hostingEnvironments

Nombre	Descripción	Valor
apiVersion	La versión de api	'2020-10-01'
amable	Tipo de recurso.	cuerda
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos principales	AppServiceEnvironment
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.Web/hostingEnvironments'

NameValuePair

Nombre	Descripción	Valor
nombre	Nombre del par.	cuerda
valor	Valor del par.	cuerda

NetworkAccessControlEntry

Nombre	Descripción	Valor
acción	Objeto action.	'Denegar' 'Permitir'
descripción	Descripción de la entrada de control de acceso de red.	cuerda
orden	Orden de prioridad.	Int
remoteSubnet	Subred remota.	cuerda

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de recurso de la red virtual.	cuerda
subred	Subred dentro de la red virtual.	cuerda

WorkerPool

Nombre	Descripción	Valor
computeMode	Hospedaje de aplicaciones compartidas o dedicadas.	'Dedicado' "Dinámico" 'Compartido'
workerCount	Número de instancias del grupo de trabajo.	Int
workerSize	Tamaño de máquina virtual de las instancias del grupo de trabajo.	cuerda
workerSizeId	Identificador de tamaño de trabajo para hacer referencia a este grupo de trabajo.	Int

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla	Descripción
App Service Environment con back-end de Azure SQL	Esta plantilla crea una instancia de App Service Environment con un back-end de Azure SQL junto con puntos de conexión privados junto con los recursos asociados que se suelen usar en un entorno privado o aislado.
App Service Environment con el plan de hospedaje y azure WebApp	Crea una instancia de App Service Environment v2 con una dirección ILB en una red virtual existente que estará disponible de forma privada. App Service Environment contendrá un plan de hospedaje y una aplicación web de Azure
Crear una de App Service Environment	Crea una instancia de App Service Environment en la red virtual
Crear una de App Service Environment v2	Crea una instancia de App Service Environment v2 en la red virtual
Crear una appServicePlan y una aplicación en un ASEv3	Creación de un AppServicePlan y una aplicación en un ASEv3
Crear App Service Environment v2 con una dirección ILB	Crea una instancia de App Service Environment v2 en la red virtual con una dirección privada del equilibrador de carga interno
Crear app Service Environment con una dirección ILB	Crea una instancia de App Service Environment en la red virtual con una dirección privada del equilibrador de carga interno.
crear azure App Service Environment con una aplicación web agregada	Crea un entorno de Azure App Service dentro de una subred de red virtual. Esta plantilla también agrega una aplicación web de Azure dentro de App Service Environment. Plantilla originalmente creadas por Callum Brankin de PixelPin
Entorno de App Service de ILB con Azure Firewall	Plantillas y parámetros de Resource Manager que muestran cómo implementar el entorno de App Service con la integración de Azure Firewall
certificado SSL para un ASE de ILB o un de ASE v2 de ILB	Configura el certificado SSL predeterminado para un ASE de ILB o un ASE de ILB v2

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso hostingEnvironments se puede implementar con operaciones que tienen como destino:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Web/hostingEnvironments, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/hostingEnvironments@2020-10-01"
  name = "string"
  kind = "string"
  location = "string"
  tags = {
    {customized property} = "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
        }
      ]
    }
  })
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
apiManagementAccountId	Cuenta de API Management asociada a App Service Environment.	cuerda
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
dynamicCacheEnabled	True/false que indica si app Service Environment está suspendido. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
frontEndScaleFactor	Factor de escala para front-end.	Int
hasLinuxWorkers	Marca que muestra si un ASE tiene trabajos de Linux o no	Bool
internalLoadBalancingMode	Especifica los puntos de conexión que se van a servir internamente en la red virtual para App Service Environment.	'Ninguno' 'Publicación' 'Web' 'Web,Publishing'
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
ubicación	Ubicación de App Service Environment, por ejemplo, "Oeste de EE. UU.".	string (obligatorio)
multiRoleCount	Número de instancias de front-end.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
nombre	Nombre de App Service Environment.	string (obligatorio)
networkAccessControlList	Lista de control de acceso para controlar el tráfico a App Service Environment.	networkAccessControlEntry[]
sslCertKeyVaultId	Identificador de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
sslCertKeyVaultSecretName	Nombre secreto de Key Vault para el certificado SSL predeterminado de App Service Environment de ILB	cuerda
suspendido	<código>true</code> si app Service Environment está suspendido; De lo contrario, <código>false</code>. El entorno se puede suspender, por ejemplo, cuando el punto de conexión de administración ya no está disponible. (lo más probable es que el grupo de seguridad de red bloquee el tráfico entrante).	Bool
userWhitelistedIpRanges	Lista agregada por el usuario de intervalos IP permitidos en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
vnetName	Nombre de la red virtual para App Service Environment.	cuerda
vnetResourceGroupName	Grupo de recursos de la red virtual.	cuerda
vnetSubnetName	Subred de la red virtual.	cuerda
workerPools	Descripción de los grupos de trabajo con identificadores de tamaño de trabajo, tamaños de máquina virtual y número de trabajos de cada grupo.	WorkerPool[] (obligatorio)

Microsoft.Web/hostingEnvironments

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades de recursos principales	AppServiceEnvironment
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.Web/hostingEnvironments@2020-10-01"

NameValuePair

Nombre	Descripción	Valor
nombre	Nombre del par.	cuerda
valor	Valor del par.	cuerda

NetworkAccessControlEntry

Nombre	Descripción	Valor
acción	Objeto action.	'Denegar' 'Permitir'
descripción	Descripción de la entrada de control de acceso de red.	cuerda
orden	Orden de prioridad.	Int
remoteSubnet	Subred remota.	cuerda

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

Nombre	Descripción	Valor
identificación	Identificador de recurso de la red virtual.	cuerda
subred	Subred dentro de la red virtual.	cuerda

WorkerPool

Nombre	Descripción	Valor
computeMode	Hospedaje de aplicaciones compartidas o dedicadas.	'Dedicado' "Dinámico" 'Compartido'
workerCount	Número de instancias del grupo de trabajo.	Int
workerSize	Tamaño de máquina virtual de las instancias del grupo de trabajo.	cuerda
workerSizeId	Identificador de tamaño de trabajo para hacer referencia a este grupo de trabajo.	Int

Compartir a través de

Microsoft.Web hostingEnvironments 2020-10-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

AppServiceEnvironment

Microsoft.Web/hostingEnvironments

NameValuePair

NetworkAccessControlEntry

ResourceTags

VirtualNetworkProfile

WorkerPool

Ejemplos de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

AppServiceEnvironment

Microsoft.Web/hostingEnvironments

NameValuePair

NetworkAccessControlEntry

ResourceTags

VirtualNetworkProfile

WorkerPool

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

AppServiceEnvironment

Microsoft.Web/hostingEnvironments

NameValuePair

NetworkAccessControlEntry

ResourceTags

VirtualNetworkProfile

WorkerPool

Comentarios

Recursos adicionales