Compartilhar via

Microsoft.Web hostingEnvironments 2024-04-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso hostingEnvironments pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Web/hostingEnvironments, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Web/hostingEnvironments@2024-04-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
customDnsSuffixConfiguration Exibição completa da configuração de sufixo de domínio personalizado para ASEv3. CustomDnsSuffixConfiguration
dedicatedHostCount Contagem de host dedicada int
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
frontEndScaleFactor Fator de escala para front-ends. int
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente na Rede Virtual para o Ambiente do Serviço de Aplicativo. 'None'
'Publicando'
'Web'
'Web, Publicando'
ipsslAddressCount Número de endereços SSL de IP reservados para o Ambiente do Serviço de Aplicativo. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de Atualização 'Early'
'Tarde'
'Manual'
'None'
userWhitelistedIpRanges O usuário adicionou intervalos de ip à lista de permissões no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo tem ou não redundância de zona. Bool

AseV3NetworkingConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso AseV3NetworkingConfiguration aseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nome Descrição Valor
allowNewPrivateEndpointConnections Propriedade para habilitar e desabilitar a criação de nova conexão de ponto de extremidade privado no ASE Bool
ftpEnabled Propriedade para habilitar e desabilitar o FTP no ASEV3 Bool
inboundIpAddressOverride Endereço IP de entrada fornecido pelo cliente. Só é possível definir na criação do Ase. corda
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 Bool

CustomDnsSuffixConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado do Azure Key Vault que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. corda
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. corda
keyVaultReferenceIdentity A identidade atribuída pelo usuário a ser usada para resolver a referência de certificado do cofre de chaves. Se não for especificado, a identidade ASE atribuída pelo sistema será usada se disponível. corda

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
tipo Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. corda
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades principais do recurso AppServiceEnvironment
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos

NameValuePair

Nome Descrição Valor
nome Nome do par. corda
valor Valor do par. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. cadeia de caracteres (obrigatório)
sub-rede Sub-rede dentro da Rede Virtual. corda

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Ambiente do Serviço de Aplicativo com Plano de Hospedagem e do Azure WebApp Cria um Ambiente do Serviço de Aplicativo v2 com um Endereço ILB em uma rede virtual existente que será privada. O Ambiente do Serviço de Aplicativo conterá um Plano de Hospedagem e um Aplicativo Web do Azure
Criar um Ambiente do Serviço de Aplicativo v2 Cria um Ambiente do Serviço de Aplicativo v2 em sua rede virtual
criar um AppServicePlan e um aplicativo em um ASEv3 Criar um AppServicePlan e um aplicativo em um ASEv3

Definição de recurso de modelo do ARM

O tipo de recurso hostingEnvironments pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Web/hostingEnvironments, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Web/hostingEnvironments",
  "apiVersion": "2024-04-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
customDnsSuffixConfiguration Exibição completa da configuração de sufixo de domínio personalizado para ASEv3. CustomDnsSuffixConfiguration
dedicatedHostCount Contagem de host dedicada int
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
frontEndScaleFactor Fator de escala para front-ends. int
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente na Rede Virtual para o Ambiente do Serviço de Aplicativo. 'None'
'Publicando'
'Web'
'Web, Publicando'
ipsslAddressCount Número de endereços SSL de IP reservados para o Ambiente do Serviço de Aplicativo. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de Atualização 'Early'
'Tarde'
'Manual'
'None'
userWhitelistedIpRanges O usuário adicionou intervalos de ip à lista de permissões no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo tem ou não redundância de zona. Bool

AseV3NetworkingConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso AseV3NetworkingConfiguration aseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nome Descrição Valor
allowNewPrivateEndpointConnections Propriedade para habilitar e desabilitar a criação de nova conexão de ponto de extremidade privado no ASE Bool
ftpEnabled Propriedade para habilitar e desabilitar o FTP no ASEV3 Bool
inboundIpAddressOverride Endereço IP de entrada fornecido pelo cliente. Só é possível definir na criação do Ase. corda
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 Bool

CustomDnsSuffixConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado do Azure Key Vault que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. corda
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. corda
keyVaultReferenceIdentity A identidade atribuída pelo usuário a ser usada para resolver a referência de certificado do cofre de chaves. Se não for especificado, a identidade ASE atribuída pelo sistema será usada se disponível. corda

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
apiVersion A versão da API '2024-04-01'
tipo Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. corda
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades principais do recurso AppServiceEnvironment
Tags Marcas de recurso Dicionário de nomes e valores de marca. Consulte Marcas em modelos
tipo O tipo de recurso 'Microsoft.Web/hostingEnvironments'

NameValuePair

Nome Descrição Valor
nome Nome do par. corda
valor Valor do par. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. cadeia de caracteres (obrigatório)
sub-rede Sub-rede dentro da Rede Virtual. corda

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Ambiente do Serviço de Aplicativo com o back-end do SQL do Azure

Implantar no Azure 		Esse modelo cria um Ambiente do Serviço de Aplicativo com um back-end do SQL do Azure junto com pontos de extremidade privados, juntamente com recursos associados normalmente usados em um ambiente privado/isolado.
Ambiente do Serviço de Aplicativo com Plano de Hospedagem e do Azure WebApp

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo v2 com um Endereço ILB em uma rede virtual existente que será privada. O Ambiente do Serviço de Aplicativo conterá um Plano de Hospedagem e um Aplicativo Web do Azure
criar um ambiente do serviço de aplicativo

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo em sua rede virtual
Criar um Ambiente do Serviço de Aplicativo v2

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo v2 em sua rede virtual
criar um AppServicePlan e um aplicativo em um ASEv3

Implantar no Azure 		Criar um AppServicePlan e um aplicativo em um ASEv3
Criar Ambiente do Serviço de Aplicativo v2 com um endereço ILB

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo v2 em sua rede virtual com um endereço de balanceador de carga interno privado
Criar Ambiente do Serviço de Aplicativo com um endereço ILB

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo em sua rede virtual com um endereço de balanceador de carga interno privado
criar um ambiente do Serviço de Aplicativo do Azure com um aplicativo Web adicionado

Implantar no Azure 		Cria um Ambiente do Serviço de Aplicativo do Azure dentro de uma sub-rede de rede virtual. Esse modelo também adiciona um Aplicativo Web do Azure dentro do Ambiente do Serviço de Aplicativo. Modelo originalmente criado por Callum Brankin do PixelPin
Ambiente do Serviço de Aplicativo ILB com o Firewall do Azure

Implantar no Azure 		Modelos e parâmetros do Resource Manager demonstrando como implantar o ambiente do Serviço de Aplicativo com a integração do Firewall do Azure
certificado SSL para um ASE ILB ou um ILB ASE v2

Implantar no Azure 		Configura o certificado SSL padrão para um ASE ILB ou um ILB ASE v2

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso hostingEnvironments pode ser implantado com operações direcionadas:

  • grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Web/hostingEnvironments, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/hostingEnvironments@2024-04-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
customDnsSuffixConfiguration Exibição completa da configuração de sufixo de domínio personalizado para ASEv3. CustomDnsSuffixConfiguration
dedicatedHostCount Contagem de host dedicada int
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
frontEndScaleFactor Fator de escala para front-ends. int
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente na Rede Virtual para o Ambiente do Serviço de Aplicativo. 'None'
'Publicando'
'Web'
'Web, Publicando'
ipsslAddressCount Número de endereços SSL de IP reservados para o Ambiente do Serviço de Aplicativo. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de Atualização 'Early'
'Tarde'
'Manual'
'None'
userWhitelistedIpRanges O usuário adicionou intervalos de ip à lista de permissões no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo tem ou não redundância de zona. Bool

AseV3NetworkingConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso AseV3NetworkingConfiguration aseV3NetworkingConfigurationProperties

AseV3NetworkingConfigurationProperties

Nome Descrição Valor
allowNewPrivateEndpointConnections Propriedade para habilitar e desabilitar a criação de nova conexão de ponto de extremidade privado no ASE Bool
ftpEnabled Propriedade para habilitar e desabilitar o FTP no ASEV3 Bool
inboundIpAddressOverride Endereço IP de entrada fornecido pelo cliente. Só é possível definir na criação do Ase. corda
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 Bool

CustomDnsSuffixConfiguration

Nome Descrição Valor
tipo Tipo de recurso. corda
Propriedades Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado do Azure Key Vault que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. corda
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. corda
keyVaultReferenceIdentity A identidade atribuída pelo usuário a ser usada para resolver a referência de certificado do cofre de chaves. Se não for especificado, a identidade ASE atribuída pelo sistema será usada se disponível. corda

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
tipo Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. corda
localização Local do recurso. cadeia de caracteres (obrigatório)
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades Propriedades principais do recurso AppServiceEnvironment
Tags Marcas de recurso Dicionário de nomes e valores de marca.
tipo O tipo de recurso "Microsoft.Web/hostingEnvironments@2024-04-01"

NameValuePair

Nome Descrição Valor
nome Nome do par. corda
valor Valor do par. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. cadeia de caracteres (obrigatório)
sub-rede Sub-rede dentro da Rede Virtual. corda