Microsoft.Web/hostingEnvironments 2023-12-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@2023-12-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    clusterSettings: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    customDnsSuffixConfiguration: {
      kind: 'string'
      properties: {
        certificateUrl: 'string'
        dnsSuffix: 'string'
        keyVaultReferenceIdentity: 'string'
      }
    }
    dedicatedHostCount: int
    dnsSuffix: 'string'
    frontEndScaleFactor: int
    internalLoadBalancingMode: 'string'
    ipsslAddressCount: int
    multiSize: 'string'
    networkingConfiguration: {
      kind: 'string'
      properties: {
        allowNewPrivateEndpointConnections: bool
        ftpEnabled: bool
        inboundIpAddressOverride: 'string'
        remoteDebugEnabled: bool
      }
    }
    upgradePreference: 'string'
    userWhitelistedIpRanges: [
      'string'
    ]
    virtualNetwork: {
      id: 'string'
      subnet: 'string'
    }
    zoneRedundant: bool
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
customDnsSuffixConfiguration	Vista completa de la configuración del sufijo de dominio personalizado para ASEv3.	CustomDnsSuffixConfiguration
dedicatedHostCount	Recuento de hosts dedicados	Int
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
frontEndScaleFactor	Factor de escala para front-end.	Int
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, Publicación"
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
networkingConfiguration	Vista completa de la configuración de red de un ASE.	AseV3NetworkingConfiguration
upgradePreference	Preferencias de actualización	"Temprano" 'Tarde' 'Manual' 'Ninguno'
userWhitelistedIpRanges	El usuario agregó intervalos IP a la lista blanca en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
zoneRedundant	Si esta instancia de App Service Environment tiene redundancia de zona o no.	Bool

AseV3NetworkingConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso AseV3NetworkingConfiguration	AseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nombre	Descripción	Valor
allowNewPrivateEndpointConnections	Propiedad para habilitar y deshabilitar la creación de una nueva conexión de punto de conexión privado en ASE	Bool
ftpEnabled	Propiedad para habilitar y deshabilitar FTP en ASEV3	Bool
inboundIpAddressOverride	Dirección IP de entrada proporcionada por el cliente. Solo se puede establecer en Ase create.	cuerda
remoteDebugEnabled	Propiedad para habilitar y deshabilitar la depuración remota en ASEV3	Bool

CustomDnsSuffixConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso CustomDnsSuffixConfiguration	customDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nombre	Descripción	Valor
certificateUrl	Dirección URL que hace referencia al secreto de certificado de Azure Key Vault que se debe usar como certificado SSL/TLS predeterminado para sitios con el sufijo de dominio personalizado.	cuerda
dnsSuffix	Sufijo de dominio personalizado predeterminado que se usará para todos los sitios implementados en el ASE.	cuerda
keyVaultReferenceIdentity	Identidad asignada por el usuario que se va a usar para resolver la referencia de certificado del almacén de claves. Si no se especifica, se usará la identidad de ASE asignada por el sistema si está disponible.	cuerda

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

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

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

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": "2023-12-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "clusterSettings": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "customDnsSuffixConfiguration": {
      "kind": "string",
      "properties": {
        "certificateUrl": "string",
        "dnsSuffix": "string",
        "keyVaultReferenceIdentity": "string"
      }
    },
    "dedicatedHostCount": "int",
    "dnsSuffix": "string",
    "frontEndScaleFactor": "int",
    "internalLoadBalancingMode": "string",
    "ipsslAddressCount": "int",
    "multiSize": "string",
    "networkingConfiguration": {
      "kind": "string",
      "properties": {
        "allowNewPrivateEndpointConnections": "bool",
        "ftpEnabled": "bool",
        "inboundIpAddressOverride": "string",
        "remoteDebugEnabled": "bool"
      }
    },
    "upgradePreference": "string",
    "userWhitelistedIpRanges": [ "string" ],
    "virtualNetwork": {
      "id": "string",
      "subnet": "string"
    },
    "zoneRedundant": "bool"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
customDnsSuffixConfiguration	Vista completa de la configuración del sufijo de dominio personalizado para ASEv3.	CustomDnsSuffixConfiguration
dedicatedHostCount	Recuento de hosts dedicados	Int
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
frontEndScaleFactor	Factor de escala para front-end.	Int
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, Publicación"
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
networkingConfiguration	Vista completa de la configuración de red de un ASE.	AseV3NetworkingConfiguration
upgradePreference	Preferencias de actualización	"Temprano" 'Tarde' 'Manual' 'Ninguno'
userWhitelistedIpRanges	El usuario agregó intervalos IP a la lista blanca en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
zoneRedundant	Si esta instancia de App Service Environment tiene redundancia de zona o no.	Bool

AseV3NetworkingConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso AseV3NetworkingConfiguration	AseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nombre	Descripción	Valor
allowNewPrivateEndpointConnections	Propiedad para habilitar y deshabilitar la creación de una nueva conexión de punto de conexión privado en ASE	Bool
ftpEnabled	Propiedad para habilitar y deshabilitar FTP en ASEV3	Bool
inboundIpAddressOverride	Dirección IP de entrada proporcionada por el cliente. Solo se puede establecer en Ase create.	cuerda
remoteDebugEnabled	Propiedad para habilitar y deshabilitar la depuración remota en ASEV3	Bool

CustomDnsSuffixConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso CustomDnsSuffixConfiguration	customDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nombre	Descripción	Valor
certificateUrl	Dirección URL que hace referencia al secreto de certificado de Azure Key Vault que se debe usar como certificado SSL/TLS predeterminado para sitios con el sufijo de dominio personalizado.	cuerda
dnsSuffix	Sufijo de dominio personalizado predeterminado que se usará para todos los sitios implementados en el ASE.	cuerda
keyVaultReferenceIdentity	Identidad asignada por el usuario que se va a usar para resolver la referencia de certificado del almacén de claves. Si no se especifica, se usará la identidad de ASE asignada por el sistema si está disponible.	cuerda

Microsoft.Web/hostingEnvironments

Nombre	Descripción	Valor
apiVersion	La versión de api	'2023-12-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

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

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

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@2023-12-01"
  name = "string"
  kind = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      clusterSettings = [
        {
          name = "string"
          value = "string"
        }
      ]
      customDnsSuffixConfiguration = {
        kind = "string"
        properties = {
          certificateUrl = "string"
          dnsSuffix = "string"
          keyVaultReferenceIdentity = "string"
        }
      }
      dedicatedHostCount = int
      dnsSuffix = "string"
      frontEndScaleFactor = int
      internalLoadBalancingMode = "string"
      ipsslAddressCount = int
      multiSize = "string"
      networkingConfiguration = {
        kind = "string"
        properties = {
          allowNewPrivateEndpointConnections = bool
          ftpEnabled = bool
          inboundIpAddressOverride = "string"
          remoteDebugEnabled = bool
        }
      }
      upgradePreference = "string"
      userWhitelistedIpRanges = [
        "string"
      ]
      virtualNetwork = {
        id = "string"
        subnet = "string"
      }
      zoneRedundant = bool
    }
  })
}

Valores de propiedad

AppServiceEnvironment

Nombre	Descripción	Valor
clusterSettings	Configuración personalizada para cambiar el comportamiento de App Service Environment.	NameValuePair[]
customDnsSuffixConfiguration	Vista completa de la configuración del sufijo de dominio personalizado para ASEv3.	CustomDnsSuffixConfiguration
dedicatedHostCount	Recuento de hosts dedicados	Int
dnsSuffix	Sufijo DNS de App Service Environment.	cuerda
frontEndScaleFactor	Factor de escala para front-end.	Int
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, Publicación"
ipsslAddressCount	Número de direcciones SSL IP reservadas para App Service Environment.	Int
multiSize	Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande".	cuerda
networkingConfiguration	Vista completa de la configuración de red de un ASE.	AseV3NetworkingConfiguration
upgradePreference	Preferencias de actualización	"Temprano" 'Tarde' 'Manual' 'Ninguno'
userWhitelistedIpRanges	El usuario agregó intervalos IP a la lista blanca en la base de datos de ASE	string[]
virtualNetwork	Descripción de la red virtual.	VirtualNetworkProfile (obligatorio)
zoneRedundant	Si esta instancia de App Service Environment tiene redundancia de zona o no.	Bool

AseV3NetworkingConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso AseV3NetworkingConfiguration	AseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nombre	Descripción	Valor
allowNewPrivateEndpointConnections	Propiedad para habilitar y deshabilitar la creación de una nueva conexión de punto de conexión privado en ASE	Bool
ftpEnabled	Propiedad para habilitar y deshabilitar FTP en ASEV3	Bool
inboundIpAddressOverride	Dirección IP de entrada proporcionada por el cliente. Solo se puede establecer en Ase create.	cuerda
remoteDebugEnabled	Propiedad para habilitar y deshabilitar la depuración remota en ASEV3	Bool

CustomDnsSuffixConfiguration

Nombre	Descripción	Valor
amable	Tipo de recurso.	cuerda
Propiedades	Propiedades específicas del recurso CustomDnsSuffixConfiguration	customDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nombre	Descripción	Valor
certificateUrl	Dirección URL que hace referencia al secreto de certificado de Azure Key Vault que se debe usar como certificado SSL/TLS predeterminado para sitios con el sufijo de dominio personalizado.	cuerda
dnsSuffix	Sufijo de dominio personalizado predeterminado que se usará para todos los sitios implementados en el ASE.	cuerda
keyVaultReferenceIdentity	Identidad asignada por el usuario que se va a usar para resolver la referencia de certificado del almacén de claves. Si no se especifica, se usará la identidad de ASE asignada por el sistema si está disponible.	cuerda

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@2023-12-01"

NameValuePair

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

ResourceTags

Nombre	Descripción	Valor

VirtualNetworkProfile

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

Compartir a través de

Microsoft.Web hostingEnvironments 2023-12-01

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

AppServiceEnvironment

AseV3NetworkingConfiguration

AseV3NetworkingConfigurationProperties

CustomDnsSuffixConfiguration

CustomDnsSuffixConfigurationProperties

Microsoft.Web/hostingEnvironments

NameValuePair

ResourceTags

VirtualNetworkProfile

Ejemplos de inicio rápido

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

AppServiceEnvironment

AseV3NetworkingConfiguration

AseV3NetworkingConfigurationProperties

CustomDnsSuffixConfiguration

CustomDnsSuffixConfigurationProperties

Microsoft.Web/hostingEnvironments

NameValuePair

ResourceTags

VirtualNetworkProfile

Plantillas de inicio rápido

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

AppServiceEnvironment

AseV3NetworkingConfiguration

AseV3NetworkingConfigurationProperties

CustomDnsSuffixConfiguration

CustomDnsSuffixConfigurationProperties

Microsoft.Web/hostingEnvironments

NameValuePair

ResourceTags

VirtualNetworkProfile

Comentarios

Recursos adicionales