Partilhar via

Microsoft.Web hostingEnvironments 2020-09-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@2020-09-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
apiManagementAccountId Conta de Gerenciamento de API associada ao Ambiente do Serviço de Aplicativo. corda
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
dynamicCacheEnabled True/false indicando se o Ambiente do Serviço de Aplicativo está suspenso. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
frontEndScaleFactor Fator de escala para front-ends. int
hasLinuxWorkers Sinalizador que exibe se um ASE tem trabalhos linux ou não Bool
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
localização Local do Ambiente do Serviço de Aplicativo, por exemplo, "Oeste dos EUA". cadeia de caracteres (obrigatório)
multiRoleCount Número de instâncias front-end. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
nome Nome do Ambiente do Serviço de Aplicativo. cadeia de caracteres (obrigatório)
networkAccessControlList Lista de controle de acesso para controlar o tráfego para o Ambiente do Serviço de Aplicativo. NetworkAccessControlEntry []
sslCertKeyVaultId ID do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
sslCertKeyVaultSecretName Nome secreto do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
suspenso <código>verdadeiro</code> se o Ambiente do Serviço de Aplicativo for suspenso; caso contrário, <código>falso</code>. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
userWhitelistedIpRanges Lista adicionada pelo usuário de intervalos de IP permitidos no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
vnetName Nome da Rede Virtual para o Ambiente do Serviço de Aplicativo. corda
vnetResourceGroupName Grupo de recursos da Rede Virtual. corda
vnetSubnetName Sub-rede da Rede Virtual. corda
workerPools Descrição dos pools de trabalho com IDs de tamanho do trabalho, tamanhos de VM e número de trabalhos em cada pool. do WorkerPool [] (obrigatório)

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
tipo Tipo de recurso. 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

NetworkAccessControlEntry

Nome Descrição Valor
ação Objeto de ação. 'Negar'
'Permitir'
descrição Descrição da entrada de controle de acesso à rede. corda
ordem Ordem de precedência. int
remoteSubnet Sub-rede remota. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. corda
sub-rede Sub-rede dentro da Rede Virtual. corda

WorkerPool

Nome Descrição Valor
computeMode Hospedagem de aplicativos compartilhados ou dedicados. 'Dedicado'
'Dinâmico'
'Compartilhado'
workerCount Número de instâncias no pool de trabalho. int
workerSize Tamanho da VM das instâncias do pool de trabalho. corda
workerSizeId ID do tamanho do trabalho para referenciar esse pool de trabalho. int

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": "2020-09-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
apiManagementAccountId Conta de Gerenciamento de API associada ao Ambiente do Serviço de Aplicativo. corda
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
dynamicCacheEnabled True/false indicando se o Ambiente do Serviço de Aplicativo está suspenso. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
frontEndScaleFactor Fator de escala para front-ends. int
hasLinuxWorkers Sinalizador que exibe se um ASE tem trabalhos linux ou não Bool
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
localização Local do Ambiente do Serviço de Aplicativo, por exemplo, "Oeste dos EUA". cadeia de caracteres (obrigatório)
multiRoleCount Número de instâncias front-end. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
nome Nome do Ambiente do Serviço de Aplicativo. cadeia de caracteres (obrigatório)
networkAccessControlList Lista de controle de acesso para controlar o tráfego para o Ambiente do Serviço de Aplicativo. NetworkAccessControlEntry []
sslCertKeyVaultId ID do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
sslCertKeyVaultSecretName Nome secreto do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
suspenso <código>verdadeiro</code> se o Ambiente do Serviço de Aplicativo for suspenso; caso contrário, <código>falso</code>. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
userWhitelistedIpRanges Lista adicionada pelo usuário de intervalos de IP permitidos no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
vnetName Nome da Rede Virtual para o Ambiente do Serviço de Aplicativo. corda
vnetResourceGroupName Grupo de recursos da Rede Virtual. corda
vnetSubnetName Sub-rede da Rede Virtual. corda
workerPools Descrição dos pools de trabalho com IDs de tamanho do trabalho, tamanhos de VM e número de trabalhos em cada pool. do WorkerPool [] (obrigatório)

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
apiVersion A versão da API '2020-09-01'
tipo Tipo de recurso. 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

NetworkAccessControlEntry

Nome Descrição Valor
ação Objeto de ação. 'Negar'
'Permitir'
descrição Descrição da entrada de controle de acesso à rede. corda
ordem Ordem de precedência. int
remoteSubnet Sub-rede remota. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. corda
sub-rede Sub-rede dentro da Rede Virtual. corda

WorkerPool

Nome Descrição Valor
computeMode Hospedagem de aplicativos compartilhados ou dedicados. 'Dedicado'
'Dinâmico'
'Compartilhado'
workerCount Número de instâncias no pool de trabalho. int
workerSize Tamanho da VM das instâncias do pool de trabalho. corda
workerSizeId ID do tamanho do trabalho para referenciar esse pool de trabalho. int

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@2020-09-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 propriedade

AppServiceEnvironment

Nome Descrição Valor
apiManagementAccountId Conta de Gerenciamento de API associada ao Ambiente do Serviço de Aplicativo. corda
clusterSettings Configurações personalizadas para alterar o comportamento do Ambiente do Serviço de Aplicativo. NameValuePair[]
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. corda
dynamicCacheEnabled True/false indicando se o Ambiente do Serviço de Aplicativo está suspenso. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
frontEndScaleFactor Fator de escala para front-ends. int
hasLinuxWorkers Sinalizador que exibe se um ASE tem trabalhos linux ou não Bool
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
localização Local do Ambiente do Serviço de Aplicativo, por exemplo, "Oeste dos EUA". cadeia de caracteres (obrigatório)
multiRoleCount Número de instâncias front-end. int
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". corda
nome Nome do Ambiente do Serviço de Aplicativo. cadeia de caracteres (obrigatório)
networkAccessControlList Lista de controle de acesso para controlar o tráfego para o Ambiente do Serviço de Aplicativo. NetworkAccessControlEntry []
sslCertKeyVaultId ID do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
sslCertKeyVaultSecretName Nome secreto do Key Vault para o certificado SSL padrão do Ambiente do Serviço de Aplicativo ILB corda
suspenso <código>verdadeiro</code> se o Ambiente do Serviço de Aplicativo for suspenso; caso contrário, <código>falso</code>. O ambiente pode ser suspenso, por exemplo, quando o ponto de extremidade de gerenciamento não está mais disponível
(provavelmente porque o NSG bloqueou o tráfego de entrada).		 Bool
userWhitelistedIpRanges Lista adicionada pelo usuário de intervalos de IP permitidos no banco de dados ASE string[]
virtualNetwork Descrição da Rede Virtual. VirtualNetworkProfile (obrigatório)
vnetName Nome da Rede Virtual para o Ambiente do Serviço de Aplicativo. corda
vnetResourceGroupName Grupo de recursos da Rede Virtual. corda
vnetSubnetName Sub-rede da Rede Virtual. corda
workerPools Descrição dos pools de trabalho com IDs de tamanho do trabalho, tamanhos de VM e número de trabalhos em cada pool. do WorkerPool [] (obrigatório)

Microsoft.Web/hostingEnvironments

Nome Descrição Valor
tipo Tipo de recurso. 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@2020-09-01"

NameValuePair

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

NetworkAccessControlEntry

Nome Descrição Valor
ação Objeto de ação. 'Negar'
'Permitir'
descrição Descrição da entrada de controle de acesso à rede. corda
ordem Ordem de precedência. int
remoteSubnet Sub-rede remota. corda

ResourceTags

Nome Descrição Valor

VirtualNetworkProfile

Nome Descrição Valor
id ID do recurso da Rede Virtual. corda
sub-rede Sub-rede dentro da Rede Virtual. corda

WorkerPool

Nome Descrição Valor
computeMode Hospedagem de aplicativos compartilhados ou dedicados. 'Dedicado'
'Dinâmico'
'Compartilhado'
workerCount Número de instâncias no pool de trabalho. int
workerSize Tamanho da VM das instâncias do pool de trabalho. corda
workerSizeId ID do tamanho do trabalho para referenciar esse pool de trabalho. int