Compartilhar via


Microsoft.Web hostingEnvironments 2022-09-01

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 log de alterações.

Formato de recurso

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

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

hostingEnvironments

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
kind Tipo de recurso. string
properties Propriedades principais do recurso AppServiceEnvironment

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 hosts dedicados INT
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. string
frontEndScaleFactor Fator de escala para front-ends. INT
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente no Rede Virtual para o Ambiente do Serviço de Aplicativo. 'None'
'Publicando'
'Web'
'Web, Publicação'
ipsslAddressCount Número de endereços SSL ip reservados para o Ambiente do Serviço de Aplicativo. INT
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". string
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de Atualização 'Early'
'Atrasado'
'Manual'
'None'
userWhitelistedIpRanges Intervalos de ip adicionados pelo usuário para permitir no banco de dados ASE string[]
virtualNetwork Descrição do Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo é ou não com redundância de zona. bool

NameValuePair

Nome Descrição Valor
name Nome do par. string
value Valor do par. string

CustomDnsSuffixConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado Key Vault do Azure que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. string
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. string
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 do ASE atribuída pelo sistema será usada se disponível. string

AseV3NetworkingConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties 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. string
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 bool

VirtualNetworkProfile

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

Modelos de início rápido

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

Modelo Descrição
ILB Ambiente do Serviço de Aplicativo com Firewall do Azure

Implantar no Azure
Resource Manager modelos e parâmetros que demonstram como implantar Serviço de Aplicativo ambiente com Firewall do Azure integração
Ambiente do Serviço de Aplicativo com SQL do Azure back-end

Implantar no Azure
Esse modelo cria um Ambiente do Serviço de Aplicativo com um back-end SQL do Azure juntamente com pontos de extremidade privados, juntamente com recursos associados normalmente usados em um ambiente privado/isolado.
Ambiente do Serviço de Aplicativo com o Plano de Hospedagem e o 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á privadamente disponível. O Ambiente do Serviço de Aplicativo conterá um Plano de Hospedagem e um Aplicativo Web do Azure
Criar Serviço de Aplicativo do Azure ambiente com um aplicativo Web adicionado

Implantar no Azure
Cria um ambiente de Serviço de Aplicativo do Azure dentro de uma sub-rede 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 da PixelPin
Criar um Ambiente do Serviço de Aplicativo

Implantar no Azure
Cria um Ambiente do Serviço de Aplicativo em sua rede virtual
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 ASE v2 ILB
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 v2

Implantar no Azure
Cria um Ambiente do Serviço de Aplicativo v2 em sua rede virtual
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 um AppServicePlan e um aplicativo em um ASEv3

Implantar no Azure
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 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": "2022-09-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 propriedade

hostingEnvironments

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Web/hostingEnvironments'
apiVersion A versão da API de recursos '2022-09-01'
name O nome do recurso cadeia de caracteres (obrigatório)
local Local do recurso. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
kind Tipo de recurso. string
properties Propriedades principais do recurso AppServiceEnvironment

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 hosts dedicados INT
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. string
frontEndScaleFactor Fator de escala para front-ends. INT
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente no Rede Virtual para o Ambiente do Serviço de Aplicativo. 'None'
'Publicando'
'Web'
'Web, Publicação'
ipsslAddressCount Número de endereços SSL ip reservados para o Ambiente do Serviço de Aplicativo. INT
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". string
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de Atualização 'Early'
'Atrasado'
'Manual'
'None'
userWhitelistedIpRanges Intervalos de ip adicionados pelo usuário para permitir no banco de dados ASE string[]
virtualNetwork Descrição do Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo é ou não com redundância de zona. bool

NameValuePair

Nome Descrição Valor
name Nome do par. string
value Valor do par. string

CustomDnsSuffixConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado Key Vault do Azure que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. string
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. string
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 do ASE atribuída pelo sistema será usada se disponível. string

AseV3NetworkingConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties 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. string
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 bool

VirtualNetworkProfile

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

Modelos de início rápido

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

Modelo Descrição
ILB Ambiente do Serviço de Aplicativo com Firewall do Azure

Implantar no Azure
Resource Manager modelos e parâmetros que demonstram como implantar Serviço de Aplicativo ambiente com integração Firewall do Azure
Ambiente do Serviço de Aplicativo com SQL do Azure back-end

Implantar no Azure
Esse modelo cria uma Ambiente do Serviço de Aplicativo com um back-end SQL do Azure juntamente com pontos de extremidade privados, juntamente com recursos associados normalmente usados em um ambiente privado/isolado.
Ambiente do Serviço de Aplicativo com o Plano de Hospedagem e o 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á de modo privado. O Ambiente do Serviço de Aplicativo conterá um Plano de Hospedagem e um Aplicativo Web do Azure
Criar Serviço de Aplicativo do Azure ambiente com um aplicativo Web adicionado

Implantar no Azure
Cria um ambiente de 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
Criar um Ambiente do Serviço de Aplicativo

Implantar no Azure
Cria um Ambiente do Serviço de Aplicativo em sua rede virtual
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 ASE v2 ILB
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 v2

Implantar no Azure
Cria um Ambiente do Serviço de Aplicativo v2 em sua rede virtual
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 um AppServicePlan e um aplicativo em um ASEv3

Implantar no Azure
Criar um AppServicePlan e um aplicativo em um ASEv3

Definição de recurso do Terraform (provedor 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 log de alterações.

Formato de recurso

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

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

hostingEnvironments

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Web/hostingEnvironments@2022-09-01"
name O nome do recurso cadeia de caracteres (obrigatório)
local Local do recurso. cadeia de caracteres (obrigatório)
parent_id Para implantar em um grupo de recursos, use a ID desse grupo de recursos. cadeia de caracteres (obrigatório)
marcas Marcas de recurso. Dicionário de nomes e valores de marcas.
kind Tipo de recurso. string
properties Propriedades do recurso principal AppServiceEnvironment

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 hosts dedicados INT
dnsSuffix Sufixo DNS do Ambiente do Serviço de Aplicativo. string
frontEndScaleFactor Fator de escala para front-ends. INT
internalLoadBalancingMode Especifica quais pontos de extremidade servir internamente no Rede Virtual para o Ambiente do Serviço de Aplicativo. "None"
"Publicação"
"Web"
"Web, Publicação"
ipsslAddressCount Número de endereços IP SSL reservados para o Ambiente do Serviço de Aplicativo. INT
multiSize Tamanho da VM de front-end, por exemplo, "Médio", "Grande". string
networkingConfiguration Exibição completa da configuração de rede para um ASE. AseV3NetworkingConfiguration
upgradePreference Preferência de atualização "Cedo"
"Atrasado"
"Manual"
"None"
userWhitelistedIpRanges O usuário adicionou intervalos de IP para permitir no banco de dados ASE string[]
virtualNetwork Descrição do Rede Virtual. VirtualNetworkProfile (obrigatório)
zoneRedundant Se esse Ambiente do Serviço de Aplicativo tem ou não redundância de zona. bool

NameValuePair

Nome Descrição Valor
name Nome do par. string
value Valor do par. string

CustomDnsSuffixConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties Propriedades específicas do recurso CustomDnsSuffixConfiguration CustomDnsSuffixConfigurationProperties

CustomDnsSuffixConfigurationProperties

Nome Descrição Valor
certificateUrl A URL que faz referência ao segredo do certificado Key Vault do Azure que deve ser usado como o certificado SSL/TLS padrão para sites com o sufixo de domínio personalizado. string
dnsSuffix O sufixo de domínio personalizado padrão a ser usado para todos os sites implantados no ASE. string
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 do ASE atribuída pelo sistema será usada se disponível. string

AseV3NetworkingConfiguration

Nome Descrição Valor
kind Tipo de recurso. string
properties 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. string
remoteDebugEnabled Propriedade para habilitar e desabilitar a Depuração Remota no ASEV3 bool

VirtualNetworkProfile

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