Sites/blocos Microsoft.Web

Definição de recurso do Bicep

O tipo de recurso sites/blocos pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Web/sites/slots, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.Web/sites/slots@2022-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  parent: resourceSymbolicName
  extendedLocation: {
    name: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    clientAffinityEnabled: bool
    clientCertEnabled: bool
    clientCertExclusionPaths: 'string'
    clientCertMode: 'string'
    cloningInfo: {
      appSettingsOverrides: {}
      cloneCustomHostNames: bool
      cloneSourceControl: bool
      configureLoadBalancing: bool
      correlationId: 'string'
      hostingEnvironment: 'string'
      overwrite: bool
      sourceWebAppId: 'string'
      sourceWebAppLocation: 'string'
      trafficManagerProfileId: 'string'
      trafficManagerProfileName: 'string'
    }
    containerSize: int
    customDomainVerificationId: 'string'
    dailyMemoryTimeQuota: int
    enabled: bool
    hostingEnvironmentProfile: {
      id: 'string'
    }
    hostNamesDisabled: bool
    hostNameSslStates: [
      {
        hostType: 'string'
        name: 'string'
        sslState: 'string'
        thumbprint: 'string'
        toUpdate: bool
        virtualIP: 'string'
      }
    ]
    httpsOnly: bool
    hyperV: bool
    isXenon: bool
    keyVaultReferenceIdentity: 'string'
    managedEnvironmentId: 'string'
    publicNetworkAccess: 'string'
    redundancyMode: 'string'
    reserved: bool
    scmSiteAlsoStopped: bool
    serverFarmId: 'string'
    siteConfig: {
      acrUseManagedIdentityCreds: bool
      acrUserManagedIdentityID: 'string'
      alwaysOn: bool
      apiDefinition: {
        url: 'string'
      }
      apiManagementConfig: {
        id: 'string'
      }
      appCommandLine: 'string'
      appSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      autoHealEnabled: bool
      autoHealRules: {
        actions: {
          actionType: 'string'
          customAction: {
            exe: 'string'
            parameters: 'string'
          }
          minProcessExecutionTime: 'string'
        }
        triggers: {
          privateBytesInKB: int
          requests: {
            count: int
            timeInterval: 'string'
          }
          slowRequests: {
            count: int
            path: 'string'
            timeInterval: 'string'
            timeTaken: 'string'
          }
          slowRequestsWithPath: [
            {
              count: int
              path: 'string'
              timeInterval: 'string'
              timeTaken: 'string'
            }
          ]
          statusCodes: [
            {
              count: int
              path: 'string'
              status: int
              subStatus: int
              timeInterval: 'string'
              win32Status: int
            }
          ]
          statusCodesRange: [
            {
              count: int
              path: 'string'
              statusCodes: 'string'
              timeInterval: 'string'
            }
          ]
        }
      }
      autoSwapSlotName: 'string'
      azureStorageAccounts: {}
      connectionStrings: [
        {
          connectionString: 'string'
          name: 'string'
          type: 'string'
        }
      ]
      cors: {
        allowedOrigins: [
          'string'
        ]
        supportCredentials: bool
      }
      defaultDocuments: [
        'string'
      ]
      detailedErrorLoggingEnabled: bool
      documentRoot: 'string'
      elasticWebAppScaleLimit: int
      experiments: {
        rampUpRules: [
          {
            actionHostName: 'string'
            changeDecisionCallbackUrl: 'string'
            changeIntervalInMinutes: int
            changeStep: int
            maxReroutePercentage: int
            minReroutePercentage: int
            name: 'string'
            reroutePercentage: int
          }
        ]
      }
      ftpsState: 'string'
      functionAppScaleLimit: int
      functionsRuntimeScaleMonitoringEnabled: bool
      handlerMappings: [
        {
          arguments: 'string'
          extension: 'string'
          scriptProcessor: 'string'
        }
      ]
      healthCheckPath: 'string'
      http20Enabled: bool
      httpLoggingEnabled: bool
      ipSecurityRestrictions: [
        {
          action: 'string'
          description: 'string'
          headers: {}
          ipAddress: 'string'
          name: 'string'
          priority: int
          subnetMask: 'string'
          subnetTrafficTag: int
          tag: 'string'
          vnetSubnetResourceId: 'string'
          vnetTrafficTag: int
        }
      ]
      ipSecurityRestrictionsDefaultAction: 'string'
      javaContainer: 'string'
      javaContainerVersion: 'string'
      javaVersion: 'string'
      keyVaultReferenceIdentity: 'string'
      limits: {
        maxDiskSizeInMb: int
        maxMemoryInMb: int
        maxPercentageCpu: int
      }
      linuxFxVersion: 'string'
      loadBalancing: 'string'
      localMySqlEnabled: bool
      logsDirectorySizeLimit: int
      managedPipelineMode: 'string'
      managedServiceIdentityId: int
      metadata: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      minimumElasticInstanceCount: int
      minTlsVersion: 'string'
      netFrameworkVersion: 'string'
      nodeVersion: 'string'
      numberOfWorkers: int
      phpVersion: 'string'
      powerShellVersion: 'string'
      preWarmedInstanceCount: int
      publicNetworkAccess: 'string'
      publishingUsername: 'string'
      push: {
        kind: 'string'
        properties: {
          dynamicTagsJson: 'string'
          isPushEnabled: bool
          tagsRequiringAuth: 'string'
          tagWhitelistJson: 'string'
        }
      }
      pythonVersion: 'string'
      remoteDebuggingEnabled: bool
      remoteDebuggingVersion: 'string'
      requestTracingEnabled: bool
      requestTracingExpirationTime: 'string'
      scmIpSecurityRestrictions: [
        {
          action: 'string'
          description: 'string'
          headers: {}
          ipAddress: 'string'
          name: 'string'
          priority: int
          subnetMask: 'string'
          subnetTrafficTag: int
          tag: 'string'
          vnetSubnetResourceId: 'string'
          vnetTrafficTag: int
        }
      ]
      scmIpSecurityRestrictionsDefaultAction: 'string'
      scmIpSecurityRestrictionsUseMain: bool
      scmMinTlsVersion: 'string'
      scmType: 'string'
      tracingOptions: 'string'
      use32BitWorkerProcess: bool
      virtualApplications: [
        {
          physicalPath: 'string'
          preloadEnabled: bool
          virtualDirectories: [
            {
              physicalPath: 'string'
              virtualPath: 'string'
            }
          ]
          virtualPath: 'string'
        }
      ]
      vnetName: 'string'
      vnetPrivatePortsCount: int
      vnetRouteAllEnabled: bool
      websiteTimeZone: 'string'
      webSocketsEnabled: bool
      windowsFxVersion: 'string'
      xManagedServiceIdentityId: int
    }
    storageAccountRequired: bool
    virtualNetworkSubnetId: 'string'
    vnetContentShareEnabled: bool
    vnetImagePullEnabled: bool
    vnetRouteAllEnabled: bool
  }
}

Valores de propriedade

sites/blocos

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.
cadeia (obrigatório)

Limite de carateres: 2-59

Carateres válidos:
Carateres Alfanuméricos, hífenes e Unicode que podem ser mapeados para Punycode
localização Localização do Recurso. cadeia (obrigatório)
etiquetas Etiquetas de recursos. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
tipo Tipo de recurso. string
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.
Nome simbólico para recurso do tipo: sites
extendedLocation Localização Expandida. ExtendedLocation
identidade Identidade de serviço gerida. ManagedServiceIdentity
propriedades Propriedades específicas do recurso do site SiteProperties

ExtendedLocation

Nome Descrição Valor
name Nome da localização expandida. string

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida. "Nenhum"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities A lista de identidades atribuídas pelo utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} objeto

SiteProperties

Nome Descrição Valor
clientAffinityEnabled true para ativar a afinidade do cliente; false para parar de enviar cookies de afinidade de sessão, que encaminham os pedidos de cliente na mesma sessão para a mesma instância. A predefinição é true. bool
clientCertEnabled true para ativar a autenticação de certificado de cliente (autenticação mútua TLS); caso contrário, false. A predefinição é false. bool
clientCertExclusionPaths caminhos de exclusão separados por vírgulas de autenticação de certificado de cliente string
clientCertMode Isto compõe-se com a definição ClientCertEnabled.
- ClientCertEnabled: falso significa que o ClientCert é ignorado.
- ClientCertEnabled: true e ClientCertMode: Obrigatório significa que o ClientCert é necessário.
- ClientCertEnabled: true e ClientCertMode: Opcional significa que o ClientCert é opcional ou aceite.
"Opcional"
"OptionalInteractiveUser"
"Obrigatório"
cloningInfo Se for especificado durante a criação da aplicação, a aplicação é clonada a partir de uma aplicação de origem. CloningInfo
containerSize Tamanho do contentor de funções. int
customDomainVerificationId Identificador exclusivo que verifica os domínios personalizados atribuídos à aplicação. O cliente irá adicionar este ID a um registo txt para verificação. string
dailyMemoryTimeQuota Quota máxima de tempo de memória diária permitida (aplicável apenas a aplicações dinâmicas). int
ativado true se a aplicação estiver ativada; caso contrário, false. Definir este valor como falso desativa a aplicação (coloca a aplicação offline). bool
hostingEnvironmentProfile Ambiente do Serviço de Aplicações a utilizar para a aplicação. HostingEnvironmentProfile
hostNamesDisabled true para desativar os nomes de anfitrião públicos da aplicação; caso contrário, false.
Se true, a aplicação só está acessível através do processo de gestão de API.
bool
hostNameSslStates Os estados SSL do nome de anfitrião são utilizados para gerir os enlaces SSL para os nomes de anfitrião da aplicação. HostNameSslState[]
httpsOnly HttpsOnly: configura um web site para aceitar apenas pedidos https. Redirecionamento de problemas para
pedidos http
bool
hyperV Sandbox do Hyper-V. bool
isXenon Obsoleto: sandbox hyper-V. bool
keyVaultReferenceIdentity Identidade a utilizar para autenticação de Referência Key Vault. string
managedEnvironmentId O Azure Resource Manager ID do Ambiente Gerido selecionado pelo cliente no qual pretende alojar esta aplicação. Tem de ser do formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. Valores Permitidos: "Ativado", "Desativado" ou uma cadeia vazia. string
redundancyMode Modo de redundância do site "ActiveActive"
"Ativação Pós-falha"
"GeoRedundant"
"Manual"
"Nenhum"
reservado true se reservado; caso contrário, false. bool
scmSiteAlsoStopped true para parar o site do SCM (KUDU) quando a aplicação é parada; caso contrário, false. A predefinição é false. bool
serverFarmId ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configuração da aplicação. SiteConfig
storageAccountRequired Verifica se a conta de armazenamento fornecida pelo cliente é necessária bool
virtualNetworkSubnetId O Azure Resource Manager ID da Rede virtual e da sub-rede a associar à Integração de VNET Regional.
Tem de ser do formulário /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
string
vnetContentShareEnabled Para ativar o acesso ao conteúdo através da rede virtual bool
vnetImagePullEnabled Para ativar a solicitação da imagem Rede Virtual bool
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool

CloningInfo

Nome Descrição Valor
appSettingsOverrides Substituições da definição da aplicação para a aplicação clonada. Se especificado, estas definições substituem as definições clonadas
a partir da aplicação de origem. Caso contrário, as definições da aplicação de origem são mantidas.
objeto
cloneCustomHostNames true para clonar nomes de anfitrião personalizados a partir da aplicação de origem; caso contrário, false. bool
cloneSourceControl true para clonar o controlo de origem a partir da aplicação de origem; caso contrário, false. bool
configurarLoadBalancing true para configurar o balanceamento de carga para a aplicação de origem e de destino. bool
correlationId ID de correlação da operação de clonagem. Este ID associa várias operações de clonagem
juntos para utilizar o mesmo instantâneo.
string
hostingEnvironment Ambiente do Serviço de Aplicações. string
substituir true para substituir a aplicação de destino; caso contrário, false. bool
sourceWebAppId ID do recurso arm da aplicação de origem. O ID do recurso da aplicação é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para blocos de produção e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para outros blocos.
cadeia (obrigatório)
sourceWebAppLocation Localização da aplicação de origem, por exemplo: E.U.A. Oeste ou Europa do Norte string
trafficManagerProfileId ID de recurso arm do perfil do Gestor de Tráfego a utilizar, se existir. O ID de recurso do Gestor de Tráfego é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
string
trafficManagerProfileName Nome do perfil do Gestor de Tráfego a criar. Isto só é necessário se o perfil do Gestor de Tráfego ainda não existir. string

HostingEnvironmentProfile

Nome Descrição Valor
ID ID do recurso do Ambiente do Serviço de Aplicações. string

HostNameSslState

Nome Descrição Valor
hostType Indica se o nome do anfitrião é um nome de anfitrião padrão ou repositório. "Repositório"
'Standard'
name Nome do anfitrião. string
sslState Tipo de SSL. "Desativado"
"IpBasedEnabled"
'SniEnabled'
thumbprint Thumbprint do certificado SSL. string
toUpdate Defina como true para atualizar o nome do anfitrião existente. bool
virtualIP Endereço IP virtual atribuído ao nome do anfitrião se o SSL baseado em IP estiver ativado. string

SiteConfig

Nome Descrição Valor
acrUseManagedIdentityCreds Sinalizador para utilizar Creds de Identidade Gerida para solicitação do ACR bool
acrUserManagedIdentityID Se estiver a utilizar a identidade gerida pelo utilizador, o ClientId da identidade gerida pelo utilizador string
alwaysOn true se AlwaysOn estiver ativado; caso contrário, false. bool
apiDefinition Informações sobre a definição formal da API para a aplicação. ApiDefinitionInfo
apiManagementConfig Definições de gestão de API do Azure ligadas à aplicação. ApiManagementConfig
appCommandLine Linha de comandos da aplicação a iniciar. string
appSettings Definições da aplicação. NameValuePair[]
autoHealEnabled true se a Recuperação Automática estiver ativada; caso contrário, false. bool
autoHealRules Regras de Recuperação Automática. AutoHealRules
autoSwapSlotName Nome do bloco de troca automática. string
azureStorageAccounts Lista de Contas de Armazenamento do Azure. objeto
connectionStrings Cadeias de ligação. ConnStringInfo[]
cors Definições de Partilha de Recursos transversais à Origem (CORS). CorsSettings
defaultDocuments Documentos predefinidos. string[]
detailedErrorLoggingEnabled true se o registo de erros detalhado estiver ativado; caso contrário, false. bool
documentRoot Raiz do documento. string
elasticWebAppScaleLimit Número máximo de trabalhos para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas a aplicações em planos em que ElasticScaleEnabled está true
int
experimentações Esta é uma solução para tipos polimórficos. Experiências
ftpsState Estado do serviço FTP/FTPS 'AllAllowed'
"Desativado"
'FtpsOnly'
functionAppScaleLimit Número máximo de trabalhos para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas aos Planos De Consumo e Elastic Premium
int
functionsRuntimeScaleMonitoringEnabled Obtém ou define um valor que indica se a monitorização da escala do runtime das funções está ativada. Quando ativada,
o ScaleController não monitorizará as origens de eventos diretamente, mas chamará o
runtime para obter o estado de dimensionamento.
bool
handlerMappings Mapeamentos do processador. HandlerMapping[]
healthCheckPath Caminho de verificação do estado de funcionamento string
http20Enabled Http20Enabled: configura um web site para permitir que os clientes se liguem através de http2.0 bool
httpLoggingEnabled true se o registo HTTP estiver ativado; caso contrário, false. bool
ipSecurityRestrictions Restrições de segurança de IP para principal. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Ação predefinida para a restrição de acesso principal se não forem correspondidas regras. "Permitir"
"Negar"
javaContainer Contentor Java. string
javaContainerVersion Versão do contentor Java. string
javaVersion Versão java. string
keyVaultReferenceIdentity Identidade a utilizar para autenticação de Referência Key Vault. string
limites Limites do site. SiteLimits
linuxFxVersion Arquitetura de Aplicações do Linux e versão string
loadBalancing Balanceamento de carga do site. "LeastRequests"
"LeastResponseTime"
"PerSiteRoundRobin"
"RequestHash"
"WeightedRoundRobin"
"WeightedTotalTraffic"
localMySqlEnabled true para ativar o MySQL local; caso contrário, false. bool
logsDirectorySizeLimit Limite de tamanho do diretório de registos HTTP. int
managedPipelineMode Modo de pipeline gerido. 'Clássico'
"Integrado"
managedServiceIdentityId ID da Identidade de Serviço Gerida int
do IdP Metadados da aplicação. Não é possível obter esta propriedade, uma vez que pode conter segredos. NameValuePair[]
minimumElasticInstanceCount Número de número mínimo de instâncias para um site
Esta definição aplica-se apenas aos Planos Elásticos
int
minTlsVersion MinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL '1.0'
'1.1'
'1.2'
netFrameworkVersion .NET Framework versão. string
nodeVersion Versão do Node.js. string
numberOfWorkers Número de trabalhadores. int
phpVersion Versão do PHP. string
powerShellVersion Versão do PowerShell. string
preWarmedInstanceCount Número de instâncias pré-configuradas.
Esta definição aplica-se apenas aos Planos Elásticos e de Consumo
int
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. string
publishingUsername Nome de utilizador de publicação. string
push Definições de ponto final push. PushSettings
pythonVersion Versão do Python. string
remoteDebuggingEnabled true se a depuração remota estiver ativada; caso contrário, false. bool
remoteDebuggingVersion Versão de depuração remota. string
requestTracingEnabled true se o rastreio de pedidos estiver ativado; caso contrário, false. bool
requestTracingExpirationTime Tempo de expiração do rastreio do pedido. string
scmIpSecurityRestrictions Restrições de segurança de IP para scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Ação predefinida para a restrição de acesso scm se não forem correspondidas regras. "Permitir"
'Negar'
scmIpSecurityRestrictionsUseMain Restrições de segurança de IP para o scm utilizar principal. bool
scmMinTlsVersion ScmMinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL para o site SCM '1.0'
'1.1'
'1.2'
scmType Tipo de SCM. 'BitbucketGit'
"BitbucketHg"
"CodePlexGit"
"CodePlexHg"
'Dropbox'
"ExternalGit"
"ExternalHg"
"GitHub"
"LocalGit"
"Nenhum"
'OneDrive'
'Tfs'
'VSO'
"VSTSRM"
tracingOptions Opções de rastreio. string
use32BitWorkerProcess true para utilizar o processo de trabalho de 32 bits; caso contrário, false. bool
virtualApplications Aplicações virtuais. VirtualApplication[]
vnetName Rede Virtual nome. string
vnetPrivatePortsCount O número de portas privadas atribuídas a esta aplicação. Estes serão atribuídos dinamicamente no runtime. int
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool
siteTimeZone Define o fuso horário que um site utiliza para gerar carimbos de data/hora. Compatível com o Linux e o Windows Serviço de Aplicações. Definir a definição da aplicação WEBSITE_TIME_ZONE tem precedência sobre esta configuração. Para Linux, espera valores https://www.iana.org/time-zones da base de dados tz (para uma referência rápida, veja https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Para o Windows, espera um dos fusos horários listados em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se o WebSocket estiver ativado; caso contrário, false. bool
windowsFxVersion Xenon App Framework e versão string
xManagedServiceIdentityId ID de Identidade de Serviço Gerida Explícita int

ApiDefinitionInfo

Nome Descrição Valor
url O URL da definição da API. string

ApiManagementConfig

Nome Descrição Valor
ID APIM-Api Identificador. string

NameValuePair

Nome Descrição Valor
name Nome do par. string
valor Valor de emparelhamento. string

AutoHealRules

Nome Descrição Valor
ações Ações a executar quando uma regra é acionada. AutoHealActions
acionadores Condições que descrevem quando executar as ações de recuperação automática. AutoHealTriggers

AutoHealActions

Nome Descrição Valor
actionType Ação predefinida a tomar. "CustomAction"
"LogEvent"
"Reciclagem"
customAction Ação personalizada a tomar. AutoHealCustomAction
minProcessExecutionTime Tempo mínimo que o processo tem de executar
antes de efetuar a ação
string

AutoHealCustomAction

Nome Descrição Valor
exe Executável para ser executado. string
parâmetros Parâmetros para o executável. string

AutoHealTriggers

Nome Descrição Valor
privateBytesInKB Uma regra baseada em bytes privados. int
pedidos Uma regra baseada no total de pedidos. RequestsBasedTrigger
slowRequests Uma regra baseada no tempo de execução do pedido. SlowRequestsBasedTrigger
slowRequestsWithPath Uma regra baseada em várias Regras de Pedidos Lentos com caminho SlowRequestsBasedTrigger[]
statusCodes Uma regra baseada em códigos de estado. StatusCodesBasedTrigger[]
statusCodesRange Uma regra baseada em intervalos de códigos de estado. StatusCodesRangeBasedTrigger[]

RequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
timeInterval Intervalo de tempo. string

SlowRequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido. string
timeInterval Intervalo de tempo. string
timeTaken Tempo que demorou. string

StatusCodesBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido string
status Código de estado HTTP. int
subStatus Pedir Subestatório. int
timeInterval Intervalo de tempo. string
win32Status Código de erro Win32. int

StatusCodesRangeBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho cadeia (de carateres)
statusCodes Código de estado HTTP. string
timeInterval Intervalo de tempo. string

ConnStringInfo

Nome Descrição Valor
connectionString Valor da cadeia de ligação. string
name Nome da cadeia de ligação. string
tipo Tipo de base de dados. "ApiHub"
"Personalizado"
"DocDb"
"EventHub"
"MySql"
"NotificationHub"
"PostgreSQL"
'RedisCache'
"SQLAzure"
"SQLServer"
"ServiceBus"

CorsSettings

Nome Descrição Valor
allowedOrigins Obtém ou define a lista de origens que devem ser autorizadas a fazer várias origens
chama (por exemplo: http://example.com:12345). Utilize "*" para permitir todos.
string[]
supportCredentials Obtém ou define se os pedidos CORS com credenciais são permitidos. Consulte
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
para obter mais detalhes.
bool

Experimentações

Nome Descrição Valor
rampUpRules Lista de regras de ramp-up. RampUpRule[]

RampUpRule

Nome Descrição Valor
actionHostName Nome do anfitrião de um bloco para o qual o tráfego será redirecionado, se for decidido. Por exemplo, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl O algoritmo de decisão personalizado pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado. Veja Extensão do site TiPCallback para obter os andaimes e os contratos.
https://www.siteextensions.net/packages/TiPCallback/
string
changeIntervalInMinutes Especifica o intervalo em minutos para reavaliar ReroutePercentage. int
alterarPasso No cenário de aumento automático, este é o passo a adicionar/remover até ReroutePercentage chegar a \nMinReroutePercentage ou
MaxReroutePercentage. As métricas do site são verificadas a cada N minutos especificados no ChangeIntervalInMinutesalgoritmo de decisão personalizada .\n
pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado em ChangeDecisionCallbackUrl.
int
maxReroutePercentage Especifica o limite superior abaixo do qual ReroutePercentage permanecerá. int
minReroutePercentage Especifica o limite inferior acima do qual ReroutePercentage permanecerá. int
name Nome da regra de encaminhamento. O nome recomendado seria apontar para o bloco que irá receber o tráfego na experimentação. string
reroutePercentage Percentagem do tráfego que será redirecionado para ActionHostName. int

HandlerMapping

Nome Descrição Valor
argumentos Argumentos da linha de comandos a serem transmitidos para o processador de scripts. string
extensão Os pedidos com esta extensão serão processados com a aplicação FastCGI especificada. string
scriptProcessor O caminho absoluto para a aplicação FastCGI. string

IpSecurityRestriction

Nome Descrição Valor
action Permitir ou Negar acesso a este intervalo de IP. string
descrição Descrição da regra de restrição de IP. string
cabeçalhos Cabeçalhos de regras de restrição de IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todos os anfitriões (ou falta de) são permitidos.
- Um valor é comparado com ordinal-ignore-case (excluindo o número da porta).
- Os carateres universais de subdomínio são permitidos, mas não correspondem ao domínio de raiz. Por exemplo, *.contoso.com corresponde ao subdomínio foo.contoso.com
mas não o domínio de raiz contoso.com ou foo.bar.contoso.com de vários níveis
- Os nomes de anfitrião Unicode são permitidos, mas são convertidos em Punycode para correspondência.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todas as cadeias reencaminhadas (ou falta de) são permitidas.
- Se qualquer endereço (excluindo o número de porta) na cadeia (separado por vírgulas) corresponder ao CIDR definido pela propriedade .

X-Azure-FDID e X-FD-HealthProbe.
A lógica correspondente corresponde à exata.
objeto
endereço ip Endereço IP para o que a restrição de segurança é válida.
Pode ser sob a forma de endereço ipv4 puro (propriedade SubnetMask necessária) ou
Notação CIDR, como ipv4/mask (correspondência de bits à esquerda). Para CIDR,
Não é possível especificar a propriedade SubnetMask.
string
name Nome da regra de restrição de IP. string
prioridade Prioridade da regra de restrição de IP. int
subnetMask Máscara de sub-rede para o intervalo de endereços IP para o que a restrição é válida. string
subnetTrafficTag (interno) Etiqueta de tráfego de sub-rede int
etiqueta Define para que é que este filtro IP será utilizado. Isto é para suportar a filtragem de IP em proxies. 'Predefinição'
"ServiceTag"
'XffProxy'
vnetSubnetResourceId ID de recurso de rede virtual string
vnetTrafficTag (interno) Etiqueta de tráfego da Vnet int

SiteLimits

Nome Descrição Valor
maxDiskSizeInMb Utilização máxima permitida do tamanho do disco em MB. int
maxMemoryInMb Utilização máxima de memória permitida em MB. int
maxPercentageCpu Percentagem máxima de utilização da CPU permitida. int

PushSettings

Nome Descrição Valor
tipo Tipo de recurso. string
propriedades Propriedades específicas do recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrição Valor
dynamicTagsJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas dinâmicas que serão avaliadas a partir de afirmações de utilizador no ponto final de registo push. string
isPushEnabled Obtém ou define um sinalizador que indica se o ponto final push está ativado. bool (obrigatório)
tagsRequiringAuth Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que exigem que a autenticação do utilizador seja utilizada no ponto final de registo push.
As etiquetas podem consistir em carateres alfanuméricos e o seguinte:
'_', '@', '#', '.', ':', '-'.
A validação deve ser efetuada no PushRequestHandler.
string
tagWhitelistJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que são permitidas para utilização pelo ponto final de registo push. string

VirtualApplication

Nome Descrição Valor
physicalPath Caminho físico. string
preloadEnabled true se o pré-carregamento estiver ativado; caso contrário, false. bool
virtualDirectories Diretórios virtuais para a aplicação virtual. VirtualDirectory[]
virtualPath Caminho virtual. string

VirtualDirectory

Nome Descrição Valor
physicalPath Caminho físico. string
virtualPath Caminho para a aplicação virtual. string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Aprovisionar função do plano de Consumo com um Bloco de Implementação

Implementar no Azure
Este modelo aprovisiona uma aplicação de funções num plano de Consumo, que é um plano de alojamento dinâmico. A aplicação é executada a pedido e é faturada por execução, sem alocação de recursos permanente. Existem outros modelos disponíveis para aprovisionamento num plano de alojamento dedicado.
Aplicação de Funções do Azure com um Bloco de Implementação

Implementar no Azure
Este modelo aprovisiona uma aplicação de funções num plano Premium com bloco de produção e um bloco de implementação adicional.
Aplicação Web com blocos de Implementação personalizados

Implementar no Azure
Este modelo fornece uma forma fácil de implementar uma aplicação Web com blocos de implementação personalizados no Azure Aplicações Web.
Aplicação Web multi-região de elevada disponibilidade

Implementar no Azure
Este modelo permite-lhe criar uma solução de ponto a ponto segura, de elevada disponibilidade, com duas aplicações Web em regiões diferentes atrás do Azure Front Door
Proteger a Aplicação Web de N camadas

Implementar no Azure
Este modelo permite-lhe criar uma solução de ponto a ponto segura com duas aplicações Web com blocos de teste, front-end e back-end, o front-end consumirá de forma segura a parte de trás através da injeção de VNet e do Ponto Final Privado

Definição de recurso do modelo arm

O tipo de recurso sites/blocos pode ser implementado com operações que visam:

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

Formato do recurso

Para criar um recurso Microsoft.Web/sites/slots, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.Web/sites/slots",
  "apiVersion": "2022-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "extendedLocation": {
    "name": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "clientAffinityEnabled": "bool",
    "clientCertEnabled": "bool",
    "clientCertExclusionPaths": "string",
    "clientCertMode": "string",
    "cloningInfo": {
      "appSettingsOverrides": {},
      "cloneCustomHostNames": "bool",
      "cloneSourceControl": "bool",
      "configureLoadBalancing": "bool",
      "correlationId": "string",
      "hostingEnvironment": "string",
      "overwrite": "bool",
      "sourceWebAppId": "string",
      "sourceWebAppLocation": "string",
      "trafficManagerProfileId": "string",
      "trafficManagerProfileName": "string"
    },
    "containerSize": "int",
    "customDomainVerificationId": "string",
    "dailyMemoryTimeQuota": "int",
    "enabled": "bool",
    "hostingEnvironmentProfile": {
      "id": "string"
    },
    "hostNamesDisabled": "bool",
    "hostNameSslStates": [
      {
        "hostType": "string",
        "name": "string",
        "sslState": "string",
        "thumbprint": "string",
        "toUpdate": "bool",
        "virtualIP": "string"
      }
    ],
    "httpsOnly": "bool",
    "hyperV": "bool",
    "isXenon": "bool",
    "keyVaultReferenceIdentity": "string",
    "managedEnvironmentId": "string",
    "publicNetworkAccess": "string",
    "redundancyMode": "string",
    "reserved": "bool",
    "scmSiteAlsoStopped": "bool",
    "serverFarmId": "string",
    "siteConfig": {
      "acrUseManagedIdentityCreds": "bool",
      "acrUserManagedIdentityID": "string",
      "alwaysOn": "bool",
      "apiDefinition": {
        "url": "string"
      },
      "apiManagementConfig": {
        "id": "string"
      },
      "appCommandLine": "string",
      "appSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "autoHealEnabled": "bool",
      "autoHealRules": {
        "actions": {
          "actionType": "string",
          "customAction": {
            "exe": "string",
            "parameters": "string"
          },
          "minProcessExecutionTime": "string"
        },
        "triggers": {
          "privateBytesInKB": "int",
          "requests": {
            "count": "int",
            "timeInterval": "string"
          },
          "slowRequests": {
            "count": "int",
            "path": "string",
            "timeInterval": "string",
            "timeTaken": "string"
          },
          "slowRequestsWithPath": [
            {
              "count": "int",
              "path": "string",
              "timeInterval": "string",
              "timeTaken": "string"
            }
          ],
          "statusCodes": [
            {
              "count": "int",
              "path": "string",
              "status": "int",
              "subStatus": "int",
              "timeInterval": "string",
              "win32Status": "int"
            }
          ],
          "statusCodesRange": [
            {
              "count": "int",
              "path": "string",
              "statusCodes": "string",
              "timeInterval": "string"
            }
          ]
        }
      },
      "autoSwapSlotName": "string",
      "azureStorageAccounts": {},
      "connectionStrings": [
        {
          "connectionString": "string",
          "name": "string",
          "type": "string"
        }
      ],
      "cors": {
        "allowedOrigins": [ "string" ],
        "supportCredentials": "bool"
      },
      "defaultDocuments": [ "string" ],
      "detailedErrorLoggingEnabled": "bool",
      "documentRoot": "string",
      "elasticWebAppScaleLimit": "int",
      "experiments": {
        "rampUpRules": [
          {
            "actionHostName": "string",
            "changeDecisionCallbackUrl": "string",
            "changeIntervalInMinutes": "int",
            "changeStep": "int",
            "maxReroutePercentage": "int",
            "minReroutePercentage": "int",
            "name": "string",
            "reroutePercentage": "int"
          }
        ]
      },
      "ftpsState": "string",
      "functionAppScaleLimit": "int",
      "functionsRuntimeScaleMonitoringEnabled": "bool",
      "handlerMappings": [
        {
          "arguments": "string",
          "extension": "string",
          "scriptProcessor": "string"
        }
      ],
      "healthCheckPath": "string",
      "http20Enabled": "bool",
      "httpLoggingEnabled": "bool",
      "ipSecurityRestrictions": [
        {
          "action": "string",
          "description": "string",
          "headers": {},
          "ipAddress": "string",
          "name": "string",
          "priority": "int",
          "subnetMask": "string",
          "subnetTrafficTag": "int",
          "tag": "string",
          "vnetSubnetResourceId": "string",
          "vnetTrafficTag": "int"
        }
      ],
      "ipSecurityRestrictionsDefaultAction": "string",
      "javaContainer": "string",
      "javaContainerVersion": "string",
      "javaVersion": "string",
      "keyVaultReferenceIdentity": "string",
      "limits": {
        "maxDiskSizeInMb": "int",
        "maxMemoryInMb": "int",
        "maxPercentageCpu": "int"
      },
      "linuxFxVersion": "string",
      "loadBalancing": "string",
      "localMySqlEnabled": "bool",
      "logsDirectorySizeLimit": "int",
      "managedPipelineMode": "string",
      "managedServiceIdentityId": "int",
      "metadata": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "minimumElasticInstanceCount": "int",
      "minTlsVersion": "string",
      "netFrameworkVersion": "string",
      "nodeVersion": "string",
      "numberOfWorkers": "int",
      "phpVersion": "string",
      "powerShellVersion": "string",
      "preWarmedInstanceCount": "int",
      "publicNetworkAccess": "string",
      "publishingUsername": "string",
      "push": {
        "kind": "string",
        "properties": {
          "dynamicTagsJson": "string",
          "isPushEnabled": "bool",
          "tagsRequiringAuth": "string",
          "tagWhitelistJson": "string"
        }
      },
      "pythonVersion": "string",
      "remoteDebuggingEnabled": "bool",
      "remoteDebuggingVersion": "string",
      "requestTracingEnabled": "bool",
      "requestTracingExpirationTime": "string",
      "scmIpSecurityRestrictions": [
        {
          "action": "string",
          "description": "string",
          "headers": {},
          "ipAddress": "string",
          "name": "string",
          "priority": "int",
          "subnetMask": "string",
          "subnetTrafficTag": "int",
          "tag": "string",
          "vnetSubnetResourceId": "string",
          "vnetTrafficTag": "int"
        }
      ],
      "scmIpSecurityRestrictionsDefaultAction": "string",
      "scmIpSecurityRestrictionsUseMain": "bool",
      "scmMinTlsVersion": "string",
      "scmType": "string",
      "tracingOptions": "string",
      "use32BitWorkerProcess": "bool",
      "virtualApplications": [
        {
          "physicalPath": "string",
          "preloadEnabled": "bool",
          "virtualDirectories": [
            {
              "physicalPath": "string",
              "virtualPath": "string"
            }
          ],
          "virtualPath": "string"
        }
      ],
      "vnetName": "string",
      "vnetPrivatePortsCount": "int",
      "vnetRouteAllEnabled": "bool",
      "websiteTimeZone": "string",
      "webSocketsEnabled": "bool",
      "windowsFxVersion": "string",
      "xManagedServiceIdentityId": "int"
    },
    "storageAccountRequired": "bool",
    "virtualNetworkSubnetId": "string",
    "vnetContentShareEnabled": "bool",
    "vnetImagePullEnabled": "bool",
    "vnetRouteAllEnabled": "bool"
  }
}

Valores de propriedade

sites/blocos

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Web/sites/slots"
apiVersion A versão da API de recursos '2022-09-01'
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON.
cadeia (obrigatório)

Limite de carateres: 2-59

Carateres válidos:
Carateres Alfanuméricos, hífenes e Unicode que podem ser mapeados para Punycode
localização Localização do Recurso. cadeia (obrigatório)
etiquetas Etiquetas de recursos. Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos
tipo Tipo de recurso. string
extendedLocation Localização Expandida. ExtendedLocation
identidade Identidade de serviço gerida. ManagedServiceIdentity
propriedades Propriedades específicas do recurso do site Propriedades do Site

ExtendedLocation

Nome Descrição Valor
name Nome da localização expandida. string

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida. "Nenhum"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
userAssignedIdentities A lista de identidades atribuídas pelo utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} objeto

Propriedades do Site

Nome Descrição Valor
clientAffinityEnabled true para ativar a afinidade de cliente; false para parar de enviar cookies de afinidade de sessão, que encaminham os pedidos do cliente na mesma sessão para a mesma instância. A predefinição é true. bool
clientCertEnabled true para ativar a autenticação de certificados de cliente (autenticação mútua TLS); caso contrário, false. A predefinição é false. bool
clientCertExclusionPaths caminhos de exclusão separados por vírgulas da autenticação do certificado de cliente string
clientCertMode Isto compõe a definição ClientCertEnabled.
- ClientCertEnabled: falso significa que ClientCert é ignorado.
- ClientCertEnabled: true e ClientCertMode: Necessário significa que o ClientCert é necessário.
- ClientCertEnabled: true e ClientCertMode: opcional significa que ClientCert é opcional ou aceite.
"Opcional"
"OptionalInteractiveUser"
"Obrigatório"
cloningInfo Se for especificado durante a criação da aplicação, a aplicação é clonada a partir de uma aplicação de origem. CloningInfo
containerSize Tamanho do contentor de funções. int
customDomainVerificationId Identificador exclusivo que verifica os domínios personalizados atribuídos à aplicação. O cliente irá adicionar este ID a um registo txt para verificação. string
dailyMemoryTimeQuota Quota máxima de tempo de memória diária permitida (aplicável apenas a aplicações dinâmicas). int
ativado true se a aplicação estiver ativada; caso contrário, false. Definir este valor como falso desativa a aplicação (coloca a aplicação offline). bool
hostingEnvironmentProfile Ambiente do Serviço de Aplicações a utilizar para a aplicação. HostingEnvironmentProfile
hostNamesDisabled true para desativar os nomes de anfitrião públicos da aplicação; caso contrário, false.
Se true, a aplicação só está acessível através do processo de gestão de API.
bool
hostNameSslStates Os estados SSL do nome de anfitrião são utilizados para gerir os enlaces SSL para os nomes de anfitrião da aplicação. HostNameSslState[]
httpsOnly HttpsOnly: configura um web site para aceitar apenas pedidos https. Redirecionamento de problemas para
pedidos http
bool
hyperV Sandbox do Hyper-V. bool
isXenon Obsoleto: sandbox hyper-V. bool
keyVaultReferenceIdentity Identidade a utilizar para autenticação de Referência Key Vault. string
managedEnvironmentId O Azure Resource Manager ID do Ambiente Gerido selecionado pelo cliente no qual pretende alojar esta aplicação. Tem de ser do formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. Valores Permitidos: "Ativado", "Desativado" ou uma cadeia vazia. string
redundancyMode Modo de redundância do site "ActiveActive"
"Ativação Pós-falha"
"GeoRedundant"
"Manual"
"Nenhum"
reservado true se reservado; caso contrário, false. bool
scmSiteAlsoStopped true para parar o site do SCM (KUDU) quando a aplicação é parada; caso contrário, false. A predefinição é false. bool
serverFarmId ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configuração da aplicação. SiteConfig
storageAccountRequired Verifica se a conta de armazenamento fornecida pelo cliente é necessária bool
virtualNetworkSubnetId O Azure Resource Manager ID da Rede virtual e da sub-rede a associar à Integração de VNET Regional.
Tem de ser do formulário /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
string
vnetContentShareEnabled Para ativar o acesso ao conteúdo através da rede virtual bool
vnetImagePullEnabled Para ativar a solicitação da imagem Rede Virtual bool
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool

CloningInfo

Nome Descrição Valor
appSettingsOverrides Substituições da definição da aplicação para a aplicação clonada. Se especificado, estas definições substituem as definições clonadas
a partir da aplicação de origem. Caso contrário, as definições da aplicação de origem são mantidas.
objeto
cloneCustomHostNames true para clonar nomes de anfitrião personalizados a partir da aplicação de origem; caso contrário, false. bool
cloneSourceControl true para clonar o controlo de origem a partir da aplicação de origem; caso contrário, false. bool
configurarLoadBalancing true para configurar o balanceamento de carga para a aplicação de origem e de destino. bool
correlationId ID de correlação da operação de clonagem. Este ID associa várias operações de clonagem
juntos para utilizar o mesmo instantâneo.
string
hostingEnvironment Ambiente do Serviço de Aplicações. string
substituir true para substituir a aplicação de destino; caso contrário, false. bool
sourceWebAppId ID do recurso arm da aplicação de origem. O ID do recurso da aplicação é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para blocos de produção e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para outros blocos.
cadeia (obrigatório)
sourceWebAppLocation Localização da aplicação de origem, por exemplo: E.U.A. Oeste ou Europa do Norte string
trafficManagerProfileId ID de recurso arm do perfil do Gestor de Tráfego a utilizar, se existir. O ID de recurso do Gestor de Tráfego é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
string
trafficManagerProfileName Nome do perfil do Gestor de Tráfego a criar. Isto só é necessário se o perfil do Gestor de Tráfego ainda não existir. string

HostingEnvironmentProfile

Nome Descrição Valor
ID ID do recurso do Ambiente do Serviço de Aplicações. string

HostNameSslState

Nome Descrição Valor
hostType Indica se o nome do anfitrião é um nome de anfitrião padrão ou repositório. "Repositório"
'Standard'
name Nome do anfitrião. string
sslState Tipo de SSL. "Desativado"
"IpBasedEnabled"
'SniEnabled'
thumbprint Thumbprint do certificado SSL. string
toUpdate Defina como true para atualizar o nome do anfitrião existente. bool
virtualIP Endereço IP virtual atribuído ao nome do anfitrião se o SSL baseado em IP estiver ativado. string

SiteConfig

Nome Descrição Valor
acrUseManagedIdentityCreds Sinalizador para utilizar Creds de Identidade Gerida para solicitação do ACR bool
acrUserManagedIdentityID Se estiver a utilizar a identidade gerida pelo utilizador, o ClientId da identidade gerida pelo utilizador string
alwaysOn true se AlwaysOn estiver ativado; caso contrário, false. bool
apiDefinition Informações sobre a definição formal da API para a aplicação. ApiDefinitionInfo
apiManagementConfig Definições de gestão de API do Azure ligadas à aplicação. ApiManagementConfig
appCommandLine Linha de comandos da aplicação a iniciar. string
appSettings Definições da aplicação. NameValuePair[]
autoHealEnabled true se a Recuperação Automática estiver ativada; caso contrário, false. bool
autoHealRules Regras de Recuperação Automática. AutoHealRules
autoSwapSlotName Nome do bloco de troca automática. string
azureStorageAccounts Lista de Contas de Armazenamento do Azure. objeto
connectionStrings Cadeias de ligação. ConnStringInfo[]
cors Definições de Partilha de Recursos transversais à Origem (CORS). CorsSettings
defaultDocuments Documentos predefinidos. string[]
detailedErrorLoggingEnabled true se o registo de erros detalhado estiver ativado; caso contrário, false. bool
documentRoot Raiz do documento. string
elasticWebAppScaleLimit Número máximo de trabalhadores para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas a aplicações em planos em que ElasticScaleEnabled é true
int
experimentações Isto é uma solução para tipos polimórficos. Experiências
ftpsState Estado do serviço FTP/FTPS 'AllAllowed'
"Desativado"
'FtpsOnly'
functionAppScaleLimit Número máximo de trabalhadores para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas aos Planos De Consumo e Elástico Premium
int
functionsRuntimeScaleMonitoringEnabled Obtém ou define um valor que indica se a monitorização da escala de runtime das funções está ativada. Quando ativado,
o ScaleController não monitorizará diretamente as origens de eventos, mas irá, em vez disso, chamar para o
runtime para obter o estado de dimensionamento.
bool
handlerMappings Mapeamentos do processador. HandlerMapping[]
healthCheckPath Caminho de verificação do estado de funcionamento string
http20Enabled Http20Enabled: configura um web site para permitir que os clientes se liguem através de http2.0 bool
httpLoggingEnabled true se o registo HTTP estiver ativado; caso contrário, false. bool
ipSecurityRestrictions Restrições de segurança de IP para principal. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Ação predefinida para a restrição de acesso principal se não forem correspondidas regras. "Permitir"
'Negar'
javaContainer Contentor Java. string
javaContainerVersion Versão do contentor Java. string
javaVersion Versão java. string
keyVaultReferenceIdentity Identidade a utilizar para autenticação de referência Key Vault. string
limites Limites do site. SiteLimits
linuxFxVersion Arquitetura de Aplicações e versão do Linux string
loadBalancing Balanceamento de carga do site. "LeastRequests"
"LeastResponseTime"
"PerSiteRoundRobin"
"RequestHash"
"WeightedRoundRobin"
"WeightedTotalTraffic"
localMySqlEnabled true para ativar o MySQL local; caso contrário, false. bool
logsDirectorySizeLimit Limite de tamanho do diretório de registos HTTP. int
managedPipelineMode Modo de pipeline gerido. 'Clássico'
"Integrado"
managedServiceIdentityId ID da Identidade de Serviço Gerida int
do IdP Metadados da aplicação. Não é possível obter esta propriedade, uma vez que pode conter segredos. NameValuePair[]
minimumElasticInstanceCount Número de número mínimo de instâncias para um site
Esta definição aplica-se apenas aos Planos Elásticos
int
minTlsVersion MinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL '1.0'
'1.1'
'1.2'
netFrameworkVersion .NET Framework versão. string
nodeVersion Versão do Node.js. string
numberOfWorkers Número de trabalhadores. int
phpVersion Versão do PHP. string
powerShellVersion Versão do PowerShell. string
preWarmedInstanceCount Número de instâncias pré-configuradas.
Esta definição aplica-se apenas aos Planos Elásticos e de Consumo
int
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. string
publishingUsername Nome de utilizador de publicação. string
push Definições de ponto final push. PushSettings
pythonVersion Versão do Python. string
remoteDebuggingEnabled true se a depuração remota estiver ativada; caso contrário, false. bool
remoteDebuggingVersion Versão de depuração remota. string
requestTracingEnabled true se o rastreio de pedidos estiver ativado; caso contrário, false. bool
requestTracingExpirationTime Tempo de expiração do rastreio do pedido. string
scmIpSecurityRestrictions Restrições de segurança de IP para scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Ação predefinida para a restrição de acesso scm se não forem correspondidas regras. "Permitir"
'Negar'
scmIpSecurityRestrictionsUseMain Restrições de segurança de IP para o scm utilizar principal. bool
scmMinTlsVersion ScmMinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL para o site SCM '1.0'
'1.1'
'1.2'
scmType Tipo de SCM. 'BitbucketGit'
"BitbucketHg"
"CodePlexGit"
"CodePlexHg"
'Dropbox'
"ExternalGit"
"ExternalHg"
"GitHub"
"LocalGit"
"Nenhum"
'OneDrive'
'Tfs'
'VSO'
"VSTSRM"
tracingOptions Opções de rastreio. string
use32BitWorkerProcess true para utilizar o processo de trabalho de 32 bits; caso contrário, false. bool
virtualApplications Aplicações virtuais. VirtualApplication[]
vnetName Rede Virtual nome. string
vnetPrivatePortsCount O número de portas privadas atribuídas a esta aplicação. Estes serão atribuídos dinamicamente no runtime. int
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool
siteTimeZone Define o fuso horário que um site utiliza para gerar carimbos de data/hora. Compatível com o Linux e o Windows Serviço de Aplicações. Definir a definição da aplicação WEBSITE_TIME_ZONE tem precedência sobre esta configuração. Para Linux, espera valores https://www.iana.org/time-zones da base de dados tz (para uma referência rápida, veja https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Para o Windows, espera um dos fusos horários listados em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se o WebSocket estiver ativado; caso contrário, false. bool
windowsFxVersion Xenon App Framework e versão string
xManagedServiceIdentityId ID de Identidade de Serviço Gerida Explícita int

ApiDefinitionInfo

Nome Descrição Valor
url O URL da definição da API. string

ApiManagementConfig

Nome Descrição Valor
ID APIM-Api Identificador. string

NameValuePair

Nome Descrição Valor
name Nome do par. string
valor Valor de emparelhamento. string

AutoHealRules

Nome Descrição Valor
ações Ações a executar quando uma regra é acionada. AutoHealActions
acionadores Condições que descrevem quando executar as ações de recuperação automática. AutoHealTriggers

AutoHealActions

Nome Descrição Valor
actionType Ação predefinida a tomar. "CustomAction"
"LogEvent"
"Reciclagem"
customAction Ação personalizada a tomar. AutoHealCustomAction
minProcessExecutionTime Tempo mínimo que o processo tem de executar
antes de efetuar a ação
string

AutoHealCustomAction

Nome Descrição Valor
exe Executável para ser executado. string
parâmetros Parâmetros para o executável. string

AutoHealTriggers

Nome Descrição Valor
privateBytesInKB Uma regra baseada em bytes privados. int
pedidos Uma regra baseada no total de pedidos. RequestsBasedTrigger
slowRequests Uma regra baseada no tempo de execução do pedido. SlowRequestsBasedTrigger
slowRequestsWithPath Uma regra baseada em várias Regras de Pedidos Lentos com caminho SlowRequestsBasedTrigger[]
statusCodes Uma regra baseada em códigos de estado. StatusCodesBasedTrigger[]
statusCodesRange Uma regra baseada em intervalos de códigos de estado. StatusCodesRangeBasedTrigger[]

RequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
timeInterval Intervalo de tempo. string

SlowRequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido. string
timeInterval Intervalo de tempo. string
timeTaken Tempo que demorou. string

StatusCodesBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido string
status Código de estado HTTP. int
subStatus Pedir Subestatório. int
timeInterval Intervalo de tempo. string
win32Status Código de erro Win32. int

StatusCodesRangeBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho cadeia (de carateres)
statusCodes Código de estado HTTP. string
timeInterval Intervalo de tempo. string

ConnStringInfo

Nome Descrição Valor
connectionString Valor da cadeia de ligação. string
name Nome da cadeia de ligação. string
tipo Tipo de base de dados. "ApiHub"
"Personalizado"
"DocDb"
"EventHub"
"MySql"
"NotificationHub"
"PostgreSQL"
'RedisCache'
"SQLAzure"
"SQLServer"
"ServiceBus"

CorsSettings

Nome Descrição Valor
allowedOrigins Obtém ou define a lista de origens que devem ser autorizadas a fazer várias origens
chama (por exemplo: http://example.com:12345). Utilize "*" para permitir todos.
string[]
supportCredentials Obtém ou define se os pedidos CORS com credenciais são permitidos. Consulte
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
para obter mais detalhes.
bool

Experimentações

Nome Descrição Valor
rampUpRules Lista de regras de ramp-up. RampUpRule[]

RampUpRule

Nome Descrição Valor
actionHostName Nome do anfitrião de um bloco para o qual o tráfego será redirecionado, se for decidido. Por exemplo, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl O algoritmo de decisão personalizado pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado. Veja Extensão do site TiPCallback para obter o estrutura e os contratos.
https://www.siteextensions.net/packages/TiPCallback/
string
changeIntervalInMinutes Especifica o intervalo em minutos para reavaliar o ReroutePercentage. int
changeStep No cenário de aumento automático, este é o passo para adicionar/remover até ReroutePercentage chegar ao \nMinReroutePercentage ou
MaxReroutePercentage. As métricas do site são verificadas a cada N minutos especificados no ChangeIntervalInMinutesalgoritmo de decisão personalizada .\n
pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado em ChangeDecisionCallbackUrl.
int
maxReroutePercentage Especifica o limite superior abaixo do qual ReroutePercentage permanecerá. int
minReroutePercentage Especifica o limite inferior acima do qual ReroutePercentage permanecerá. int
name Nome da regra de encaminhamento. O nome recomendado seria apontar para o bloco que irá receber o tráfego na experimentação. string
reroutePercentage Percentagem do tráfego que será redirecionado para ActionHostName. int

HandlerMapping

Nome Descrição Valor
argumentos Argumentos da linha de comandos a transmitir ao processador de scripts. string
extensão Os pedidos com esta extensão serão processados com a aplicação FastCGI especificada. string
scriptProcessor O caminho absoluto para a aplicação FastCGI. string

IpSecurityRestriction

Nome Descrição Valor
action Permitir ou Negar acesso a este intervalo de IP. string
descrição Descrição da regra de restrição de IP. string
cabeçalhos Cabeçalhos de regras de restrição de IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todos os anfitriões(ou falta de) são permitidos.
- Um valor é comparado com ordinal-ignore-case (excluindo o número da porta).
- Os carateres universais de subdomínio são permitidos, mas não correspondem ao domínio raiz. Por exemplo, *.contoso.com corresponde ao subdomínio foo.contoso.com
mas não o domínio de raiz contoso.com ou foo.bar.contoso.com de vários níveis
- Os nomes de anfitrião unicode são permitidos, mas são convertidos em Punycode para correspondência.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todas as cadeias reencaminhadas (ou falta de) são permitidas.
- Se qualquer endereço (excluindo o número da porta) na cadeia (separado por vírgulas) corresponder ao CIDR definido pela propriedade.

X-Azure-FDID e X-FD-HealthProbe.
A lógica correspondente corresponde à exata.
objeto
ipAddress Endereço IP para o que a restrição de segurança é válida.
Pode ser em forma de endereço ipv4 puro (propriedade SubnetMask necessária) ou
Notação CIDR, como ipv4/mask (correspondência de bits à esquerda). Para CIDR,
Não é possível especificar a propriedade SubnetMask.
string
name Nome da regra de restrição de IP. string
prioridade Prioridade da regra de restrição de IP. int
subnetMask Máscara de sub-rede para o intervalo de endereços IP para o que a restrição é válida. string
subnetTrafficTag (interno) Etiqueta de tráfego de sub-rede int
etiqueta Define para que é que este filtro IP será utilizado. Isto é para suportar a filtragem de IP em proxies. 'Predefinição'
"ServiceTag"
'XffProxy'
vnetSubnetResourceId ID de recurso de rede virtual string
vnetTrafficTag (interno) Etiqueta de tráfego da Vnet int

SiteLimits

Nome Descrição Valor
maxDiskSizeInMb Utilização máxima permitida do tamanho do disco em MB. int
maxMemoryInMb Utilização máxima permitida da memória em MB. int
maxPercentageCpu Percentagem de utilização máxima permitida da CPU. int

PushSettings

Nome Descrição Valor
tipo Tipo de recurso. string
propriedades Propriedades específicas do recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrição Valor
dynamicTagsJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas dinâmicas que serão avaliadas a partir de afirmações de utilizador no ponto final de registo push. string
isPushEnabled Obtém ou define um sinalizador que indica se o ponto final push está ativado. bool (obrigatório)
tagsRequiringAuth Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que exigem que a autenticação do utilizador seja utilizada no ponto final de registo push.
As etiquetas podem consistir em carateres alfanuméricos e o seguinte:
'_', '@', '#', '.', ':', '-'.
A validação deve ser efetuada no PushRequestHandler.
string
tagWhitelistJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que são permitidas para utilização pelo ponto final de registo push. string

VirtualApplication

Nome Descrição Valor
physicalPath Caminho físico. string
preloadEnabled true se o pré-carregamento estiver ativado; caso contrário, false. bool
virtualDirectories Diretórios virtuais para a aplicação virtual. VirtualDirectory[]
virtualPath Caminho virtual. string

VirtualDirectory

Nome Descrição Valor
physicalPath Caminho físico. string
virtualPath Caminho para a aplicação virtual. string

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Aprovisionar função de plano de Consumo com um Bloco de Implementação

Implementar no Azure
Este modelo aprovisiona uma aplicação de funções num plano de Consumo, que é um plano de alojamento dinâmico. A aplicação é executada a pedido e é faturada por execução, sem alocação de recursos permanente. Existem outros modelos disponíveis para aprovisionamento num plano de alojamento dedicado.
Aplicação de Funções do Azure com um Bloco de Implementação

Implementar no Azure
Este modelo aprovisiona uma aplicação de funções num plano Premium com bloco de produção e um bloco de implementação adicional.
Aplicação Web com blocos de Implementação personalizados

Implementar no Azure
Este modelo fornece uma forma fácil de implementar uma aplicação Web com blocos de implementação personalizados no Azure Aplicações Web.
Aplicação Web de Várias Regiões de Elevada Disponibilidade

Implementar no Azure
Este modelo permite-lhe criar uma solução de ponto a ponto segura, de elevada disponibilidade e de várias regiões com duas aplicações Web em regiões diferentes atrás do Azure Front Door
Proteger a Aplicação Web de N camadas

Implementar no Azure
Este modelo permite-lhe criar uma solução de ponto a ponto segura com duas aplicações Web com blocos de teste, front-end e back-end. O front-end consumirá de forma segura a parte de trás através da injeção de VNet e do Ponto Final Privado

Definição de recurso terraform (fornecedor AzAPI)

O tipo de recurso sites/blocos pode ser implementado com operações que visam:

  • Grupos de recursos

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

Formato do recurso

Para criar um recurso Microsoft.Web/sites/slots, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/sites/slots@2022-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      clientAffinityEnabled = bool
      clientCertEnabled = bool
      clientCertExclusionPaths = "string"
      clientCertMode = "string"
      cloningInfo = {
        appSettingsOverrides = {}
        cloneCustomHostNames = bool
        cloneSourceControl = bool
        configureLoadBalancing = bool
        correlationId = "string"
        hostingEnvironment = "string"
        overwrite = bool
        sourceWebAppId = "string"
        sourceWebAppLocation = "string"
        trafficManagerProfileId = "string"
        trafficManagerProfileName = "string"
      }
      containerSize = int
      customDomainVerificationId = "string"
      dailyMemoryTimeQuota = int
      enabled = bool
      hostingEnvironmentProfile = {
        id = "string"
      }
      hostNamesDisabled = bool
      hostNameSslStates = [
        {
          hostType = "string"
          name = "string"
          sslState = "string"
          thumbprint = "string"
          toUpdate = bool
          virtualIP = "string"
        }
      ]
      httpsOnly = bool
      hyperV = bool
      isXenon = bool
      keyVaultReferenceIdentity = "string"
      managedEnvironmentId = "string"
      publicNetworkAccess = "string"
      redundancyMode = "string"
      reserved = bool
      scmSiteAlsoStopped = bool
      serverFarmId = "string"
      siteConfig = {
        acrUseManagedIdentityCreds = bool
        acrUserManagedIdentityID = "string"
        alwaysOn = bool
        apiDefinition = {
          url = "string"
        }
        apiManagementConfig = {
          id = "string"
        }
        appCommandLine = "string"
        appSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        autoHealEnabled = bool
        autoHealRules = {
          actions = {
            actionType = "string"
            customAction = {
              exe = "string"
              parameters = "string"
            }
            minProcessExecutionTime = "string"
          }
          triggers = {
            privateBytesInKB = int
            requests = {
              count = int
              timeInterval = "string"
            }
            slowRequests = {
              count = int
              path = "string"
              timeInterval = "string"
              timeTaken = "string"
            }
            slowRequestsWithPath = [
              {
                count = int
                path = "string"
                timeInterval = "string"
                timeTaken = "string"
              }
            ]
            statusCodes = [
              {
                count = int
                path = "string"
                status = int
                subStatus = int
                timeInterval = "string"
                win32Status = int
              }
            ]
            statusCodesRange = [
              {
                count = int
                path = "string"
                statusCodes = "string"
                timeInterval = "string"
              }
            ]
          }
        }
        autoSwapSlotName = "string"
        azureStorageAccounts = {}
        connectionStrings = [
          {
            connectionString = "string"
            name = "string"
            type = "string"
          }
        ]
        cors = {
          allowedOrigins = [
            "string"
          ]
          supportCredentials = bool
        }
        defaultDocuments = [
          "string"
        ]
        detailedErrorLoggingEnabled = bool
        documentRoot = "string"
        elasticWebAppScaleLimit = int
        experiments = {
          rampUpRules = [
            {
              actionHostName = "string"
              changeDecisionCallbackUrl = "string"
              changeIntervalInMinutes = int
              changeStep = int
              maxReroutePercentage = int
              minReroutePercentage = int
              name = "string"
              reroutePercentage = int
            }
          ]
        }
        ftpsState = "string"
        functionAppScaleLimit = int
        functionsRuntimeScaleMonitoringEnabled = bool
        handlerMappings = [
          {
            arguments = "string"
            extension = "string"
            scriptProcessor = "string"
          }
        ]
        healthCheckPath = "string"
        http20Enabled = bool
        httpLoggingEnabled = bool
        ipSecurityRestrictions = [
          {
            action = "string"
            description = "string"
            headers = {}
            ipAddress = "string"
            name = "string"
            priority = int
            subnetMask = "string"
            subnetTrafficTag = int
            tag = "string"
            vnetSubnetResourceId = "string"
            vnetTrafficTag = int
          }
        ]
        ipSecurityRestrictionsDefaultAction = "string"
        javaContainer = "string"
        javaContainerVersion = "string"
        javaVersion = "string"
        keyVaultReferenceIdentity = "string"
        limits = {
          maxDiskSizeInMb = int
          maxMemoryInMb = int
          maxPercentageCpu = int
        }
        linuxFxVersion = "string"
        loadBalancing = "string"
        localMySqlEnabled = bool
        logsDirectorySizeLimit = int
        managedPipelineMode = "string"
        managedServiceIdentityId = int
        metadata = [
          {
            name = "string"
            value = "string"
          }
        ]
        minimumElasticInstanceCount = int
        minTlsVersion = "string"
        netFrameworkVersion = "string"
        nodeVersion = "string"
        numberOfWorkers = int
        phpVersion = "string"
        powerShellVersion = "string"
        preWarmedInstanceCount = int
        publicNetworkAccess = "string"
        publishingUsername = "string"
        push = {
          kind = "string"
          properties = {
            dynamicTagsJson = "string"
            isPushEnabled = bool
            tagsRequiringAuth = "string"
            tagWhitelistJson = "string"
          }
        }
        pythonVersion = "string"
        remoteDebuggingEnabled = bool
        remoteDebuggingVersion = "string"
        requestTracingEnabled = bool
        requestTracingExpirationTime = "string"
        scmIpSecurityRestrictions = [
          {
            action = "string"
            description = "string"
            headers = {}
            ipAddress = "string"
            name = "string"
            priority = int
            subnetMask = "string"
            subnetTrafficTag = int
            tag = "string"
            vnetSubnetResourceId = "string"
            vnetTrafficTag = int
          }
        ]
        scmIpSecurityRestrictionsDefaultAction = "string"
        scmIpSecurityRestrictionsUseMain = bool
        scmMinTlsVersion = "string"
        scmType = "string"
        tracingOptions = "string"
        use32BitWorkerProcess = bool
        virtualApplications = [
          {
            physicalPath = "string"
            preloadEnabled = bool
            virtualDirectories = [
              {
                physicalPath = "string"
                virtualPath = "string"
              }
            ]
            virtualPath = "string"
          }
        ]
        vnetName = "string"
        vnetPrivatePortsCount = int
        vnetRouteAllEnabled = bool
        websiteTimeZone = "string"
        webSocketsEnabled = bool
        windowsFxVersion = "string"
        xManagedServiceIdentityId = int
      }
      storageAccountRequired = bool
      virtualNetworkSubnetId = "string"
      vnetContentShareEnabled = bool
      vnetImagePullEnabled = bool
      vnetRouteAllEnabled = bool
    }
    kind = "string"
    extendedLocation = {
      name = "string"
    }
  })
}

Valores de propriedade

sites/blocos

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Web/sites/slots@2022-09-01"
name O nome do recurso cadeia (obrigatório)

Limite de carateres: 2-59

Carateres válidos:
Carateres Alfanuméricos, hífenes e Unicode que podem ser mapeados para Punycode
localização Localização do Recurso. cadeia (obrigatório)
parent_id O ID do recurso que é o principal para este recurso. ID do recurso do tipo: sites
etiquetas Etiquetas de recursos. Dicionário de nomes e valores de etiquetas.
tipo Tipo de recurso. string
extendedLocation Localização Expandida. ExtendedLocation
identidade Identidade de serviço gerida. ManagedServiceIdentity
propriedades Propriedades específicas do recurso do site Propriedades do Site

ExtendedLocation

Nome Descrição Valor
name Nome da localização expandida. string

ManagedServiceIdentity

Nome Descrição Valor
tipo Tipo de identidade de serviço gerida. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids A lista de identidades atribuídas pelo utilizador associadas ao recurso. As referências da chave do dicionário de identidade do utilizador serão IDs de recursos do ARM no formulário: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} Matriz de IDs de identidade do utilizador.

Propriedades do Site

Nome Descrição Valor
clientAffinityEnabled true para ativar a afinidade de cliente; false para parar de enviar cookies de afinidade de sessão, que encaminham os pedidos do cliente na mesma sessão para a mesma instância. A predefinição é true. bool
clientCertEnabled true para ativar a autenticação de certificados de cliente (autenticação mútua TLS); caso contrário, false. A predefinição é false. bool
clientCertExclusionPaths caminhos de exclusão separados por vírgulas da autenticação do certificado de cliente string
clientCertMode Isto compõe a definição ClientCertEnabled.
- ClientCertEnabled: falso significa que ClientCert é ignorado.
- ClientCertEnabled: true e ClientCertMode: Necessário significa que o ClientCert é necessário.
- ClientCertEnabled: true e ClientCertMode: opcional significa que ClientCert é opcional ou aceite.
"Opcional"
"OptionalInteractiveUser"
"Obrigatório"
cloningInfo Se for especificado durante a criação da aplicação, a aplicação é clonada a partir de uma aplicação de origem. CloningInfo
containerSize Tamanho do contentor de funções. int
customDomainVerificationId Identificador exclusivo que verifica os domínios personalizados atribuídos à aplicação. O cliente irá adicionar este ID a um registo txt para verificação. string
dailyMemoryTimeQuota Quota máxima de tempo de memória diária permitida (aplicável apenas a aplicações dinâmicas). int
ativado true se a aplicação estiver ativada; caso contrário, false. Definir este valor como falso desativa a aplicação (coloca a aplicação offline). bool
hostingEnvironmentProfile Ambiente do Serviço de Aplicações a utilizar para a aplicação. HostingEnvironmentProfile
hostNamesDisabled true para desativar os nomes de anfitrião públicos da aplicação; caso contrário, false.
Se true, a aplicação só está acessível através do processo de gestão de API.
bool
hostNameSslStates Os estados SSL do nome de anfitrião são utilizados para gerir os enlaces SSL para os nomes de anfitrião da aplicação. HostNameSslState[]
httpsOnly HttpsOnly: configura um web site para aceitar apenas pedidos https. Redirecionamento de problemas para
pedidos http
bool
hyperV Sandbox do Hyper-V. bool
isXenon Obsoleto: sandbox hyper-V. bool
keyVaultReferenceIdentity Identidade a utilizar para autenticação de Referência Key Vault. string
managedEnvironmentId O Azure Resource Manager ID do Ambiente Gerido selecionado pelo cliente no qual pretende alojar esta aplicação. Tem de ser do formulário /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.App/managedEnvironments/{managedEnvironmentName} string
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. Valores Permitidos: "Ativado", "Desativado" ou uma cadeia vazia. string
redundancyMode Modo de redundância do site "ActiveActive"
"Ativação Pós-falha"
"GeoRedundant"
"Manual"
"Nenhum"
reservado true se reservado; caso contrário, false. bool
scmSiteAlsoStopped true para parar o site do SCM (KUDU) quando a aplicação é parada; caso contrário, false. A predefinição é false. bool
serverFarmId ID de recurso do plano de Serviço de Aplicações associado, formatado como: "/subscriptions/{subscriptionID}/resourceGroups/{groupName}/providers/Microsoft.Web/serverfarms/{appServicePlanName}". string
siteConfig Configuração da aplicação. SiteConfig
storageAccountRequired Verifica se a conta de armazenamento fornecida pelo cliente é necessária bool
virtualNetworkSubnetId O Azure Resource Manager ID da Rede virtual e da sub-rede a associar à Integração de VNET Regional.
Tem de ser do formulário /subscriptions/{subscriptionName}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{vnetName}/subnets/{subnetName}
string
vnetContentShareEnabled Para ativar o acesso ao conteúdo através da rede virtual bool
vnetImagePullEnabled Para ativar a solicitação da imagem Rede Virtual bool
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool

CloningInfo

Nome Descrição Valor
appSettingsOverrides Substituições da definição da aplicação para a aplicação clonada. Se especificado, estas definições substituem as definições clonadas
a partir da aplicação de origem. Caso contrário, as definições da aplicação de origem são mantidas.
objeto
cloneCustomHostNames true para clonar nomes de anfitrião personalizados a partir da aplicação de origem; caso contrário, false. bool
cloneSourceControl true para clonar o controlo de origem a partir da aplicação de origem; caso contrário, false. bool
configurarLoadBalancing true para configurar o balanceamento de carga para a aplicação de origem e de destino. bool
correlationId ID de correlação da operação de clonagem. Este ID associa várias operações de clonagem
juntos para utilizar o mesmo instantâneo.
string
hostingEnvironment Ambiente do Serviço de Aplicações. string
substituir true para substituir a aplicação de destino; caso contrário, false. bool
sourceWebAppId ID do recurso arm da aplicação de origem. O ID do recurso da aplicação é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName} para blocos de produção e
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/sites/{siteName}/slots/{slotName} para outros blocos.
cadeia (obrigatório)
sourceWebAppLocation Localização da aplicação de origem, por exemplo: E.U.A. Oeste ou Europa do Norte string
trafficManagerProfileId ID de recurso arm do perfil do Gestor de Tráfego a utilizar, se existir. O ID de recurso do Gestor de Tráfego é do formulário
/subscriptions/{subId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/trafficManagerProfiles/{profileName}.
string
trafficManagerProfileName Nome do perfil do Gestor de Tráfego a criar. Isto só é necessário se o perfil do Gestor de Tráfego ainda não existir. string

HostingEnvironmentProfile

Nome Descrição Valor
ID ID de recurso do Ambiente do Serviço de Aplicações. string

HostNameSslState

Nome Descrição Valor
hostType Indica se o nome do anfitrião é um nome de anfitrião padrão ou repositório. "Repositório"
"Standard"
name Nome do anfitrião. string
sslState Tipo de SSL. "Desativado"
"IpBasedEnabled"
"SniEnabled"
thumbprint Thumbprint do certificado SSL. string
toUpdate Defina como true para atualizar o nome do anfitrião existente. bool
virtualIP Endereço IP virtual atribuído ao nome do anfitrião se o SSL baseado em IP estiver ativado. string

SiteConfig

Nome Descrição Valor
acrUseManagedIdentityCreds Sinalizador para utilizar o Managed Identity Creds para a solicitação do ACR bool
acrUserManagedIdentityID Se utilizar a identidade gerida pelo utilizador, o ClientId da identidade gerida pelo utilizador string
alwaysOn true se AlwaysOn estiver ativado; caso contrário, false. bool
apiDefinition Informações sobre a definição formal da API para a aplicação. ApiDefinitionInfo
apiManagementConfig Definições de gestão de API do Azure ligadas à aplicação. ApiManagementConfig
appCommandLine Linha de comandos da aplicação a iniciar. string
appSettings Definições da aplicação. NameValuePair[]
autoHealEnabled true se a Recuperação Automática estiver ativada; caso contrário, false. bool
autoHealRules Regras de Recuperação Automática. AutoHealRules
autoSwapSlotName Nome do bloco de troca automática. string
azureStorageAccounts Lista de Contas de Armazenamento do Azure. objeto
connectionStrings Cadeias de ligação. ConnStringInfo[]
cors Definições de Partilha de Recursos entre Origens (CORS). CorsSettings
defaultDocuments Documentos predefinidos. cadeia[]
detailedErrorLoggingEnabled true se o registo de erros detalhado estiver ativado; caso contrário, false. bool
documentRoot Raiz do documento. string
elasticWebAppScaleLimit Número máximo de trabalhadores para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas a aplicações em planos em que ElasticScaleEnabled é true
int
experimentações Isto é uma solução para tipos polimórficos. Experiências
ftpsState Estado do serviço FTP/FTPS "AllAllowed"
"Desativado"
"FtpsOnly"
functionAppScaleLimit Número máximo de trabalhadores para os quais um site pode aumentar horizontalmente.
Esta definição aplica-se apenas aos Planos De Consumo e Elástico Premium
int
functionsRuntimeScaleMonitoringEnabled Obtém ou define um valor que indica se a monitorização da escala de runtime das funções está ativada. Quando ativado,
o ScaleController não monitorizará diretamente as origens de eventos, mas irá, em vez disso, chamar para o
runtime para obter o estado de dimensionamento.
bool
handlerMappings Mapeamentos do processador. HandlerMapping[]
healthCheckPath Caminho de verificação do estado de funcionamento string
http20Enabled Http20Enabled: configura um web site para permitir que os clientes se liguem através de http2.0 bool
httpLoggingEnabled true se o registo HTTP estiver ativado; caso contrário, false. bool
ipSecurityRestrictions Restrições de segurança de IP para principal. IpSecurityRestriction[]
ipSecurityRestrictionsDefaultAction Ação predefinida para a restrição de acesso principal se não forem correspondidas regras. "Permitir"
"Negar"
javaContainer Contentor Java. string
javaContainerVersion Versão do contentor Java. string
javaVersion Versão java. string
keyVaultReferenceIdentity Identidade a utilizar para autenticação de referência Key Vault. string
limites Limites do site. SiteLimits
linuxFxVersion Arquitetura de Aplicações e versão do Linux string
loadBalancing Balanceamento de carga do site. "LeastRequests"
"LeastResponseTime"
"PerSiteRoundRobin"
"RequestHash"
"WeightedRoundRobin"
"WeightedTotalTraffic"
localMySqlEnabled true para ativar o MySQL local; caso contrário, false. bool
logsDirectorySizeLimit Limite de tamanho do diretório de registos HTTP. int
managedPipelineMode Modo de pipeline gerido. "Clássico"
"Integrado"
managedServiceIdentityId ID da Identidade de Serviço Gerida int
do IdP Metadados da aplicação. Não é possível obter esta propriedade, uma vez que pode conter segredos. NameValuePair[]
minimumElasticInstanceCount Número de número mínimo de instâncias para um site
Esta definição aplica-se apenas aos Planos Elásticos
int
minTlsVersion MinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL "1.0"
"1.1"
"1.2"
netFrameworkVersion .NET Framework versão. string
nodeVersion Versão do Node.js. string
numberOfWorkers Número de trabalhadores. int
phpVersion Versão do PHP. string
powerShellVersion Versão do PowerShell. string
preWarmedInstanceCount Número de instâncias pré-configuradas.
Esta definição aplica-se apenas aos Planos Elásticos e de Consumo
int
publicNetworkAccess Propriedade para permitir ou bloquear todo o tráfego público. string
publishingUsername Nome de utilizador de publicação. string
push Definições de ponto final push. PushSettings
pythonVersion Versão do Python. string
remoteDebuggingEnabled true se a depuração remota estiver ativada; caso contrário, false. bool
remoteDebuggingVersion Versão de depuração remota. string
requestTracingEnabled true se o rastreio de pedidos estiver ativado; caso contrário, false. bool
requestTracingExpirationTime Tempo de expiração do rastreio do pedido. string
scmIpSecurityRestrictions Restrições de segurança de IP para scm. IpSecurityRestriction[]
scmIpSecurityRestrictionsDefaultAction Ação predefinida para restrição de acesso scm se não forem correspondidas regras. "Permitir"
"Negar"
scmIpSecurityRestrictionsUseMain Restrições de segurança de IP para o scm utilizar principal. bool
scmMinTlsVersion ScmMinTlsVersion: configura a versão mínima do TLS necessária para pedidos SSL para o site SCM "1.0"
"1.1"
"1.2"
scmType Tipo de SCM. "BitbucketGit"
"BitbucketHg"
"CodePlexGit"
"CodePlexHg"
"Dropbox"
"ExternalGit"
"ExternalHg"
"GitHub"
"LocalGit"
"Nenhum"
"OneDrive"
"Tfs"
"VSO"
"VSTSRM"
tracingOptions Opções de rastreio. string
use32BitWorkerProcess true para utilizar o processo de trabalho de 32 bits; caso contrário, false. bool
virtualApplications Aplicações virtuais. VirtualApplication[]
vnetName Rede Virtual nome. string
vnetPrivatePortsCount O número de portas privadas atribuídas a esta aplicação. Estes serão atribuídos dinamicamente no runtime. int
vnetRouteAllEnabled Rede Virtual Encaminhar Tudo ativado. Isto faz com que todo o tráfego de saída tenha Rede Virtual Grupos de Segurança e Rotas Definidas pelo Utilizador aplicadas. bool
websiteTimeZone Define o fuso horário que um site utiliza para gerar carimbos de data/hora. Compatível com Linux e Windows Serviço de Aplicações. Definir a definição da aplicação WEBSITE_TIME_ZONE tem precedência sobre esta configuração. Para Linux, espera valores https://www.iana.org/time-zones de base de dados tz (para uma referência rápida, veja https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). Para o Windows, espera um dos fusos horários listados em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones string
webSocketsEnabled true se o WebSocket estiver ativado; caso contrário, false. bool
windowsFxVersion Xenon App Framework e versão string
xManagedServiceIdentityId ID de Identidade de Serviço Gerida Explícita int

ApiDefinitionInfo

Nome Descrição Valor
url O URL da definição da API. string

ApiManagementConfig

Nome Descrição Valor
ID APIM-Api Identificador. string

NameValuePair

Nome Descrição Valor
name Nome do par. string
valor Valor de emparelhamento. string

AutoHealRules

Nome Descrição Valor
ações Ações a executar quando uma regra é acionada. AutoHealActions
acionadores Condições que descrevem quando executar as ações de recuperação automática. AutoHealTriggers

AutoHealActions

Nome Descrição Valor
actionType Ação predefinida a tomar. "CustomAction"
"LogEvent"
"Reciclagem"
customAction Ação personalizada a tomar. AutoHealCustomAction
minProcessExecutionTime Tempo mínimo que o processo tem de executar
antes de efetuar a ação
string

AutoHealCustomAction

Nome Descrição Valor
exe Executável para ser executado. string
parâmetros Parâmetros para o executável. string

AutoHealTriggers

Nome Descrição Valor
privateBytesInKB Uma regra baseada em bytes privados. int
pedidos Uma regra baseada no total de pedidos. RequestsBasedTrigger
slowRequests Uma regra baseada no tempo de execução do pedido. SlowRequestsBasedTrigger
slowRequestsWithPath Uma regra baseada em várias Regras de Pedidos Lentos com caminho SlowRequestsBasedTrigger[]
statusCodes Uma regra baseada em códigos de estado. StatusCodesBasedTrigger[]
statusCodesRange Uma regra baseada em intervalos de códigos de estado. StatusCodesRangeBasedTrigger[]

RequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
timeInterval Intervalo de tempo. string

SlowRequestsBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido. string
timeInterval Intervalo de tempo. string
timeTaken O tempo demorou. string

StatusCodesBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho Caminho do Pedido string
status Código de estado HTTP. int
subStatus Pedir Subestatório. int
timeInterval Intervalo de tempo. string
win32Status Código de erro Win32. int

StatusCodesRangeBasedTrigger

Nome Descrição Valor
count Contagem de Pedidos. int
caminho cadeia (de carateres)
statusCodes Código de estado HTTP. string
timeInterval Intervalo de tempo. string

ConnStringInfo

Nome Descrição Valor
connectionString Valor da cadeia de ligação. string
name Nome da cadeia de ligação. string
tipo Tipo de base de dados. "ApiHub"
"Personalizado"
"DocDb"
"EventHub"
"MySql"
"NotificationHub"
"PostgreSQL"
"RedisCache"
"SQLAzure"
"SQLServer"
"ServiceBus"

CorsSettings

Nome Descrição Valor
allowedOrigins Obtém ou define a lista de origens que devem ser autorizadas a fazer várias origens
chama (por exemplo: http://example.com:12345). Utilize "*" para permitir todos.
string[]
supportCredentials Obtém ou define se os pedidos CORS com credenciais são permitidos. Consulte
https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#Requests_with_credentials
para obter mais detalhes.
bool

Experimentações

Nome Descrição Valor
rampUpRules Lista de regras de ramp-up. RampUpRule[]

RampUpRule

Nome Descrição Valor
actionHostName Nome do anfitrião de um bloco para o qual o tráfego será redirecionado, se for decidido. Por exemplo, myapp-stage.azurewebsites.net. string
changeDecisionCallbackUrl O algoritmo de decisão personalizado pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado. Veja Extensão do site TiPCallback para obter os andaimes e os contratos.
https://www.siteextensions.net/packages/TiPCallback/
string
changeIntervalInMinutes Especifica o intervalo em minutos para reavaliar ReroutePercentage. int
alterarPasso No cenário de aumento automático, este é o passo a adicionar/remover até ReroutePercentage chegar a \nMinReroutePercentage ou
MaxReroutePercentage. As métricas do site são verificadas a cada N minutos especificados no ChangeIntervalInMinutesalgoritmo de decisão personalizada .\n
pode ser fornecido na extensão do site TiPCallback que o URL pode ser especificado em ChangeDecisionCallbackUrl.
int
maxReroutePercentage Especifica o limite superior abaixo do qual ReroutePercentage permanecerá. int
minReroutePercentage Especifica o limite inferior acima do qual ReroutePercentage permanecerá. int
name Nome da regra de encaminhamento. O nome recomendado seria apontar para o bloco que irá receber o tráfego na experimentação. string
reroutePercentage Percentagem do tráfego que será redirecionado para ActionHostName. int

HandlerMapping

Nome Descrição Valor
argumentos Argumentos da linha de comandos a serem transmitidos para o processador de scripts. string
extensão Os pedidos com esta extensão serão processados com a aplicação FastCGI especificada. string
scriptProcessor O caminho absoluto para a aplicação FastCGI. string

IpSecurityRestriction

Nome Descrição Valor
action Permitir ou Negar acesso a este intervalo de IP. string
descrição Descrição da regra de restrição de IP. string
cabeçalhos Cabeçalhos de regras de restrição de IP.
X-Forwarded-Host (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-Host#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todos os anfitriões (ou falta de) são permitidos.
- Um valor é comparado com ordinal-ignore-case (excluindo o número da porta).
- Os carateres universais de subdomínio são permitidos, mas não correspondem ao domínio de raiz. Por exemplo, *.contoso.com corresponde ao subdomínio foo.contoso.com
mas não o domínio de raiz contoso.com ou foo.bar.contoso.com de vários níveis
- Os nomes de anfitrião Unicode são permitidos, mas são convertidos em Punycode para correspondência.

X-Forwarded-For (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Forwarded-For#Examples).
A lógica correspondente é ..
- Se a propriedade for nula ou vazia (predefinição), todas as cadeias reencaminhadas (ou falta de) são permitidas.
- Se qualquer endereço (excluindo o número de porta) na cadeia (separado por vírgulas) corresponder ao CIDR definido pela propriedade .

X-Azure-FDID e X-FD-HealthProbe.
A lógica correspondente corresponde à exata.
objeto
endereço ip Endereço IP para o que a restrição de segurança é válida.
Pode ser sob a forma de endereço ipv4 puro (propriedade SubnetMask necessária) ou
Notação CIDR, como ipv4/mask (correspondência de bits à esquerda). Para CIDR,
Não é possível especificar a propriedade SubnetMask.
string
name Nome da regra de restrição de IP. string
prioridade Prioridade da regra de restrição de IP. int
subnetMask Máscara de sub-rede para o intervalo de endereços IP para o que a restrição é válida. string
subnetTrafficTag (interno) Etiqueta de tráfego de sub-rede int
etiqueta Define para que será utilizado este filtro IP. Isto destina-se a suportar a filtragem de IP em proxies. "Predefinição"
"ServiceTag"
"XffProxy"
vnetSubnetResourceId ID do recurso de rede virtual string
vnetTrafficTag (interno) Etiqueta de tráfego da VNet int

SiteLimits

Nome Descrição Valor
maxDiskSizeInMb Utilização máxima permitida do tamanho do disco em MB. int
maxMemoryInMb Utilização máxima permitida da memória em MB. int
maxPercentageCpu Percentagem de utilização máxima permitida da CPU. int

PushSettings

Nome Descrição Valor
tipo Tipo de recurso. string
propriedades Propriedades específicas do recurso PushSettings PushSettingsProperties

PushSettingsProperties

Nome Descrição Valor
dynamicTagsJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas dinâmicas que serão avaliadas a partir de afirmações de utilizador no ponto final de registo push. string
isPushEnabled Obtém ou define um sinalizador que indica se o ponto final push está ativado. bool (obrigatório)
tagsRequiringAuth Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que exigem que a autenticação do utilizador seja utilizada no ponto final de registo push.
As etiquetas podem consistir em carateres alfanuméricos e o seguinte:
'_', '@', '#', '.', ':', '-'.
A validação deve ser efetuada no PushRequestHandler.
string
tagWhitelistJson Obtém ou define uma cadeia JSON que contém uma lista de etiquetas que são permitidas para utilização pelo ponto final de registo push. string

VirtualApplication

Nome Descrição Valor
physicalPath Caminho físico. string
preloadEnabled true se o pré-carregamento estiver ativado; caso contrário, false. bool
virtualDirectories Diretórios virtuais para a aplicação virtual. VirtualDirectory[]
virtualPath Caminho virtual. string

VirtualDirectory

Nome Descrição Valor
physicalPath Caminho físico. string
virtualPath Caminho para a aplicação virtual. string