Microsoft.Web hostingEnvironments 2022-03-01
Definición de recursos de Bicep
El tipo de recurso hostingEnvironments se puede implementar con operaciones que tienen como destino:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/hostingEnvironments, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Web/hostingEnvironments@2022-03-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: '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
}
}
Valores de propiedad
hostingEnvironments
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Tipo de recurso. | string |
| properties | Propiedades de recursos principales | AppServiceEnvironment |
AppServiceEnvironment
| Nombre | Descripción | Value |
|---|---|---|
| clusterSettings | Configuración personalizada para cambiar el comportamiento del 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 del App Service Environment. | string |
| frontEndScaleFactor | Factor de escala para front-end. | int |
| internalLoadBalancingMode | Especifica los puntos de conexión que se van a servir internamente en el Virtual Network para el App Service Environment. | 'Ninguno' 'Publicación' 'Web' 'Web, Publishing' |
| ipsslAddressCount | Número de direcciones SSL IP reservadas para el App Service Environment. | int |
| multiSize | Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande". | string |
| networkingConfiguration | Vista completa de la configuración de red de un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Preferencias de actualización | "Early" "Tarde" 'Manual' 'Ninguno' |
| userWhitelistedIpRanges | Lista agregada por el usuario de intervalos IP permitidos en la base de datos de ASE | string[] |
| virtualNetwork | Descripción del Virtual Network. | VirtualNetworkProfile (obligatorio) |
| zoneRedundant | Si este App Service Environment es con redundancia de zona o no. | bool |
NameValuePair
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del par. | string |
| value | Valor del par. | string |
CustomDnsSuffixConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso CustomDnsSuffixConfiguration | CustomDnsSuffixConfigurationProperties |
CustomDnsSuffixConfigurationProperties
| Nombre | Descripción | Value |
|---|---|---|
| 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. | string |
| dnsSuffix | Sufijo de dominio personalizado predeterminado que se va a usar para todos los sitios implementados en el ASE. | string |
| 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, la identidad de ASE asignada por el sistema se usará si está disponible. | string |
AseV3NetworkingConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nombre | Descripción | Valor |
|---|---|---|
| allowNewPrivateEndpointConnections | Propiedad para habilitar y deshabilitar la creación de nuevas conexiones 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. | string |
| remoteDebugEnabled | Propiedad para habilitar y deshabilitar la depuración remota en ASEV3 | bool |
VirtualNetworkProfile
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso del Virtual Network. | string (obligatorio) |
| subred | Subred dentro del Virtual Network. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
App Service Environment de ILB con Azure Firewall |
Resource Manager plantillas y parámetros que muestran cómo implementar App Service entorno con Azure Firewall integración |
| App Service Environment con back-end de Azure SQL |
Esta plantilla crea un 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 plan de hospedaje y Azure WebApp |
Crea un App Service Environment v2 con una dirección ILB en una red virtual existente que estará disponible de forma privada. El App Service Environment contendrá un plan de hospedaje y una aplicación web de Azure |
| Creación de Azure App Service entorno con una aplicación web agregada |
Crea un entorno de Azure App Service dentro de una subred de Virtual Network. Esta plantilla también agrega una aplicación web de Azure dentro del App Service Environment. Plantilla originalmente creadas por Callum Brankin de PixelPin |
| Creación de un App Service Environment |
Crea un App Service Environment en la red virtual |
| Certificado SSL para un ASE de ILB o un ASE de ILB v2 |
Configuración del certificado SSL predeterminado para un entorno ASE con ILB o un entorno ASE v2 con ILB |
| Creación de App Service Environment con una dirección ILB |
Crea una App Service Environment en la red virtual con una dirección privada del equilibrador de carga interno. |
| Creación de un App Service Environment v2 |
Crea un App Service Environment v2 en la red virtual |
| Creación de un entorno de App Service Environment v2 con una dirección ILB |
Crea una App Service Environment v2 en la red virtual con una dirección de equilibrador de carga interno privada. |
| Crear un AppServicePlan y una aplicación en un ASEv3 |
Crear 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 los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/hostingEnvironments, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.Web/hostingEnvironments",
"apiVersion": "2022-03-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "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"
}
}
Valores de propiedad
hostingEnvironments
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Web/hostingEnvironments" |
| apiVersion | La versión de la API de recursos | '2022-03-01' |
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Tipo de recurso. | string |
| properties | Propiedades de recursos principales | AppServiceEnvironment |
AppServiceEnvironment
| Nombre | Descripción | Value |
|---|---|---|
| clusterSettings | Configuración personalizada para cambiar el comportamiento del 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 del App Service Environment. | string |
| frontEndScaleFactor | Factor de escala para front-end. | int |
| internalLoadBalancingMode | Especifica los puntos de conexión que se van a servir internamente en el Virtual Network para el App Service Environment. | 'Ninguno' 'Publicación' 'Web' 'Web, Publishing' |
| ipsslAddressCount | Número de direcciones SSL IP reservadas para el App Service Environment. | int |
| multiSize | Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande". | string |
| networkingConfiguration | Vista completa de la configuración de red de un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Preferencias de actualización | "Early" "Tarde" 'Manual' 'Ninguno' |
| userWhitelistedIpRanges | Lista agregada por el usuario de intervalos IP permitidos en la base de datos de ASE | string[] |
| virtualNetwork | Descripción del Virtual Network. | VirtualNetworkProfile (obligatorio) |
| zoneRedundant | Si este App Service Environment es con redundancia de zona o no. | bool |
NameValuePair
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del par. | string |
| value | Valor del par. | string |
CustomDnsSuffixConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | 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. | string |
| dnsSuffix | Sufijo de dominio personalizado predeterminado que se va a usar para todos los sitios implementados en el ASE. | string |
| 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, la identidad de ASE asignada por el sistema se usará si está disponible. | string |
AseV3NetworkingConfiguration
| Nombre | Descripción | Value |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nombre | Descripción | Value |
|---|---|---|
| allowNewPrivateEndpointConnections | Propiedad para habilitar y deshabilitar la creación de nuevas conexiones 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. | string |
| remoteDebugEnabled | Propiedad para habilitar y deshabilitar la depuración remota en ASEV3 | bool |
VirtualNetworkProfile
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso del Virtual Network. | string (obligatorio) |
| subred | Subred dentro del Virtual Network. | string |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| App Service Environment de ILB con Azure Firewall |
Resource Manager plantillas y parámetros que muestran cómo implementar App Service entorno con Azure Firewall integración |
| App Service Environment con back-end de Azure SQL |
Esta plantilla crea un 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 plan de hospedaje y Azure WebApp |
Crea un App Service Environment v2 con una dirección ILB en una red virtual existente que estará disponible de forma privada. El App Service Environment contendrá un plan de hospedaje y una aplicación web de Azure |
| Creación de Azure App Service entorno con una aplicación web agregada |
Crea un entorno de Azure App Service dentro de una subred de Virtual Network. Esta plantilla también agrega una aplicación web de Azure dentro del App Service Environment. Plantilla originalmente creadas por Callum Brankin de PixelPin |
| Creación de un App Service Environment |
Crea un App Service Environment en la red virtual |
| Certificado SSL para un ASE de ILB o un ASE de ILB v2 |
Configuración del certificado SSL predeterminado para un entorno ASE con ILB o un entorno ASE v2 con ILB |
| Creación de App Service Environment con una dirección ILB |
Crea una App Service Environment en la red virtual con una dirección privada del equilibrador de carga interno. |
| Creación de un App Service Environment v2 |
Crea un App Service Environment v2 en la red virtual |
| Creación de un entorno de App Service Environment v2 con una dirección ILB |
Crea una App Service Environment v2 en la red virtual con una dirección de equilibrador de carga interno privada. |
| Crear un AppServicePlan y una aplicación en un ASEv3 |
Crear un AppServicePlan y una aplicación en un ASEv3 |
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
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Web/hostingEnvironments, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Web/hostingEnvironments@2022-03-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
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
}
kind = "string"
})
}
Valores de propiedad
hostingEnvironments
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Web/hostingEnvironments@2022-03-01" |
| name | El nombre del recurso | string (obligatorio) |
| ubicación | Ubicación del recurso. | string (obligatorio) |
| parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. |
| kind | Tipo de recurso. | string |
| properties | Propiedades de recursos principales | AppServiceEnvironment |
AppServiceEnvironment
| Nombre | Descripción | Value |
|---|---|---|
| clusterSettings | Configuración personalizada para cambiar el comportamiento del 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 del App Service Environment. | string |
| frontEndScaleFactor | Factor de escala para front-end. | int |
| internalLoadBalancingMode | Especifica los puntos de conexión que se van a servir internamente en el Virtual Network para el App Service Environment. | "None" "Publicación" "Web" "Web, Publishing" |
| ipsslAddressCount | Número de direcciones SSL IP reservadas para el App Service Environment. | int |
| multiSize | Tamaño de máquina virtual de front-end, por ejemplo, "Mediano", "Grande". | string |
| networkingConfiguration | Vista completa de la configuración de red de un ASE. | AseV3NetworkingConfiguration |
| upgradePreference | Preferencias de actualización | "Temprano" "Tarde" "Manual" "None" |
| userWhitelistedIpRanges | El usuario agregó una lista de intervalos IP permitidos en la base de datos de ASE. | string[] |
| virtualNetwork | Descripción del Virtual Network. | VirtualNetworkProfile (obligatorio) |
| zoneRedundant | Si este App Service Environment es con redundancia de zona o no. | bool |
NameValuePair
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre del par. | string |
| value | Valor del par. | string |
CustomDnsSuffixConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | 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. | string |
| dnsSuffix | Sufijo de dominio personalizado predeterminado que se va a usar para todos los sitios implementados en el ASE. | string |
| 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, la identidad de ASE asignada por el sistema se usará si está disponible. | string |
AseV3NetworkingConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| kind | Tipo de recurso. | string |
| properties | Propiedades específicas del recurso AseV3NetworkingConfiguration | AseV3NetworkingConfigurationProperties |
AseV3NetworkingConfigurationProperties
| Nombre | Descripción | Value |
|---|---|---|
| allowNewPrivateEndpointConnections | Propiedad para habilitar y deshabilitar la creación de nuevas conexiones 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. | string |
| remoteDebugEnabled | Propiedad para habilitar y deshabilitar la depuración remota en ASEV3 | bool |
VirtualNetworkProfile
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso del Virtual Network. | string (obligatorio) |
| subred | Subred dentro del Virtual Network. | string |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de