Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Definição de recurso do Bicep
O tipo de recurso staticSites pode ser implantado com operações de destino:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Exemplos de uso
Exemplos do Bicep
Um exemplo básico de implantação do Aplicativo Web Estático.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource staticSite 'Microsoft.Web/staticSites@2021-02-01' = {
name: resourceName
location: location
sku: {
name: 'Free'
tier: 'Free'
}
properties: {}
}
Módulos verificados do Azure
O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| aplicativo Web estático | Módulo de recurso AVM para aplicativo Web estático |
Formato de recurso
Para criar um recurso Microsoft.Web/staticSites, adicione o Bicep a seguir ao seu modelo.
resource symbolicname 'Microsoft.Web/staticSites@2025-03-01' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
kind: 'string'
location: 'string'
name: 'string'
properties: {
allowConfigFileUpdates: bool
branch: 'string'
buildProperties: {
apiBuildCommand: 'string'
apiLocation: 'string'
appArtifactLocation: 'string'
appBuildCommand: 'string'
appLocation: 'string'
githubActionSecretNameOverride: 'string'
outputLocation: 'string'
skipGithubActionWorkflowGeneration: bool
}
enterpriseGradeCdnStatus: 'string'
provider: 'string'
publicNetworkAccess: 'string'
repositoryToken: 'string'
repositoryUrl: 'string'
stagingEnvironmentPolicy: 'string'
templateProperties: {
description: 'string'
isPrivate: bool
owner: 'string'
repositoryName: 'string'
templateRepositoryUrl: 'string'
}
}
sku: {
capabilities: [
{
name: 'string'
reason: 'string'
value: 'string'
}
]
capacity: int
family: 'string'
locations: [
'string'
]
name: 'string'
size: 'string'
skuCapacity: {
default: int
elasticMaximum: int
maximum: int
minimum: int
scaleType: 'string'
}
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Microsoft.Web/staticSites
| Nome | Descrição | Valor |
|---|---|---|
| identidade | Identidade de serviço gerenciada. | ManagedServiceIdentity |
| tipo | Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. | cadeia |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades principais do recurso | StaticSite |
| Sku | Descrição de um SKU para um recurso escalonável. | SkuDescription |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
Capacidade
| Nome | Descrição | Valor |
|---|---|---|
| nome | Nome da funcionalidade de SKU. | cadeia |
| razão | Motivo da funcionalidade de SKU. | cadeia |
| valor | Valor da funcionalidade de SKU. | cadeia |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado. | 'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| Identidades Atribuídas pelo Usuário | A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Tags de recursos
| Nome | Descrição | Valor |
|---|
Capacidade de SKU
| Nome | Descrição | Valor |
|---|---|---|
| padrão | Número padrão de trabalhos para este SKU de plano do Serviço de Aplicativo. | int |
| elásticoMáximo | Número máximo de trabalhos elásticos para este SKU de plano do Serviço de Aplicativo. | int |
| máximo | Número máximo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| mínimo | Número mínimo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| tipo de escala | Configurações de escala disponíveis para um plano do Serviço de Aplicativo. | cadeia |
Descrição do Sku
Site estático
| Nome | Descrição | Valor |
|---|---|---|
| allowConfigFileUpdates | <código>falso</code> se o arquivo de configuração estiver bloqueado para este aplicativo Web estático; caso contrário, <código>verdadeiro</code>. | Bool |
| branch | O branch de destino no repositório. | cadeia |
| Propriedades de compilação | Compile propriedades para configurar no repositório. | staticSiteBuildProperties |
| enterpriseGradeCdnStatus | Estado que indica o status da CDN de nível empresarial que atende o tráfego para o aplicativo Web estático. | 'Desabilitado' 'Desabilitando' 'Habilitado' 'Habilitando' |
| fornecedor | O provedor que enviou a última implantação para o ambiente primário do site estático. | cadeia |
| públicoAcessoRedeAcesso | Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Habilitado', 'Desabilitado' ou uma cadeia de caracteres vazia. | cadeia |
| repositórioToken | Token de repositório github de um usuário. Isso é usado para configurar o arquivo de fluxo de trabalho e os segredos da API do Github Actions. | cadeia |
| repositórioUrl | URL para o repositório do site estático. | cadeia |
| stagingEnvironmentPolicy | Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. | 'Desabilitado' 'Habilitado' |
| templateProperties | Opções de modelo para gerar um novo repositório. | staticSiteTemplateOptions |
StaticSiteBuildProperties
| Nome | Descrição | Valor |
|---|---|---|
| apiBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de API do Azure Functions. | cadeia |
| apiLocalização | O caminho para o código de api dentro do repositório. | cadeia |
| appArtifactLocation | Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) | cadeia |
| appBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. | cadeia |
| appLocation | O caminho para o código do aplicativo dentro do repositório. | cadeia |
| githubActionSecretNameOverride | Substituição do nome do segredo da Ação do Github. | cadeia |
| local de saída | O caminho de saída do aplicativo após a criação. | cadeia |
| skipGithubActionWorkflowGeneration | Ignorar a geração de fluxo de trabalho do Github Action. | Bool |
StaticSiteTemplateOptions
| Nome | Descrição | Valor |
|---|---|---|
| descrição | Descrição do repositório recém-gerado. | cadeia |
| éPrivado | Se o repositório recém-gerado é ou não um repositório privado. O padrão é false (ou seja, público). | Bool |
| proprietário | Proprietário do repositório recém-gerado. | cadeia |
| repositórioName | Nome do repositório recém-gerado. | cadeia |
| templateRepositoryUrl | URL do repositório de modelos. O repositório recém-gerado será baseado neste. | cadeia |
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|
Definição de recurso de modelo do ARM
O tipo de recurso staticSites pode ser implantado com operações de destino:
- Grupos de recursos - Veja comandos de implantação de grupos de recursos Para uma lista de propriedades alteradas em cada versão da API, veja registro de alterações.
Exemplos de uso
Formato de recurso
Para criar um recurso Microsoft.Web/staticSites, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.Web/staticSites",
"apiVersion": "2025-03-01",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"kind": "string",
"location": "string",
"properties": {
"allowConfigFileUpdates": "bool",
"branch": "string",
"buildProperties": {
"apiBuildCommand": "string",
"apiLocation": "string",
"appArtifactLocation": "string",
"appBuildCommand": "string",
"appLocation": "string",
"githubActionSecretNameOverride": "string",
"outputLocation": "string",
"skipGithubActionWorkflowGeneration": "bool"
},
"enterpriseGradeCdnStatus": "string",
"provider": "string",
"publicNetworkAccess": "string",
"repositoryToken": "string",
"repositoryUrl": "string",
"stagingEnvironmentPolicy": "string",
"templateProperties": {
"description": "string",
"isPrivate": "bool",
"owner": "string",
"repositoryName": "string",
"templateRepositoryUrl": "string"
}
},
"sku": {
"capabilities": [
{
"name": "string",
"reason": "string",
"value": "string"
}
],
"capacity": "int",
"family": "string",
"locations": [ "string" ],
"name": "string",
"size": "string",
"skuCapacity": {
"default": "int",
"elasticMaximum": "int",
"maximum": "int",
"minimum": "int",
"scaleType": "string"
},
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Microsoft.Web/staticSites
| Nome | Descrição | Valor |
|---|---|---|
| apiVersion | A versão da API | '2025-03-01' |
| identidade | Identidade de serviço gerenciada. | ManagedServiceIdentity |
| tipo | Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. | cadeia |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades principais do recurso | StaticSite |
| Sku | Descrição de um SKU para um recurso escalonável. | SkuDescription |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
| tipo | O tipo de recurso | 'Microsoft.Web/staticSites' |
Capacidade
| Nome | Descrição | Valor |
|---|---|---|
| nome | Nome da funcionalidade de SKU. | cadeia |
| razão | Motivo da funcionalidade de SKU. | cadeia |
| valor | Valor da funcionalidade de SKU. | cadeia |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado. | 'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| Identidades Atribuídas pelo Usuário | A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Tags de recursos
| Nome | Descrição | Valor |
|---|
Capacidade de SKU
| Nome | Descrição | Valor |
|---|---|---|
| padrão | Número padrão de trabalhos para este SKU de plano do Serviço de Aplicativo. | int |
| elásticoMáximo | Número máximo de trabalhos elásticos para este SKU de plano do Serviço de Aplicativo. | int |
| máximo | Número máximo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| mínimo | Número mínimo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| tipo de escala | Configurações de escala disponíveis para um plano do Serviço de Aplicativo. | cadeia |
Descrição do Sku
Site estático
| Nome | Descrição | Valor |
|---|---|---|
| allowConfigFileUpdates | <código>falso</code> se o arquivo de configuração estiver bloqueado para este aplicativo Web estático; caso contrário, <código>verdadeiro</code>. | Bool |
| branch | O branch de destino no repositório. | cadeia |
| Propriedades de compilação | Compile propriedades para configurar no repositório. | staticSiteBuildProperties |
| enterpriseGradeCdnStatus | Estado que indica o status da CDN de nível empresarial que atende o tráfego para o aplicativo Web estático. | 'Desabilitado' 'Desabilitando' 'Habilitado' 'Habilitando' |
| fornecedor | O provedor que enviou a última implantação para o ambiente primário do site estático. | cadeia |
| públicoAcessoRedeAcesso | Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Habilitado', 'Desabilitado' ou uma cadeia de caracteres vazia. | cadeia |
| repositórioToken | Token de repositório github de um usuário. Isso é usado para configurar o arquivo de fluxo de trabalho e os segredos da API do Github Actions. | cadeia |
| repositórioUrl | URL para o repositório do site estático. | cadeia |
| stagingEnvironmentPolicy | Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. | 'Desabilitado' 'Habilitado' |
| templateProperties | Opções de modelo para gerar um novo repositório. | staticSiteTemplateOptions |
StaticSiteBuildProperties
| Nome | Descrição | Valor |
|---|---|---|
| apiBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de API do Azure Functions. | cadeia |
| apiLocalização | O caminho para o código de api dentro do repositório. | cadeia |
| appArtifactLocation | Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) | cadeia |
| appBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. | cadeia |
| appLocation | O caminho para o código do aplicativo dentro do repositório. | cadeia |
| githubActionSecretNameOverride | Substituição do nome do segredo da Ação do Github. | cadeia |
| local de saída | O caminho de saída do aplicativo após a criação. | cadeia |
| skipGithubActionWorkflowGeneration | Ignorar a geração de fluxo de trabalho do Github Action. | Bool |
StaticSiteTemplateOptions
| Nome | Descrição | Valor |
|---|---|---|
| descrição | Descrição do repositório recém-gerado. | cadeia |
| éPrivado | Se o repositório recém-gerado é ou não um repositório privado. O padrão é false (ou seja, público). | Bool |
| proprietário | Proprietário do repositório recém-gerado. | cadeia |
| repositórioName | Nome do repositório recém-gerado. | cadeia |
| templateRepositoryUrl | URL do repositório de modelos. O repositório recém-gerado será baseado neste. | cadeia |
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso staticSites pode ser implantado com operações de destino:
- Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja o registro de alterações.
Exemplos de uso
Exemplos do Terraform
Um exemplo básico de implantação do Aplicativo Web Estático.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "staticSite" {
type = "Microsoft.Web/staticSites@2021-02-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
}
sku = {
name = "Free"
tier = "Free"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Módulos verificados do Azure
O módulos verificados do Azure a seguir pode ser usado para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| aplicativo Web estático | Módulo de recurso AVM para aplicativo Web estático |
Formato de recurso
Para criar um recurso Microsoft.Web/staticSites, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Web/staticSites@2025-03-01"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
kind = "string"
properties = {
allowConfigFileUpdates = bool
branch = "string"
buildProperties = {
apiBuildCommand = "string"
apiLocation = "string"
appArtifactLocation = "string"
appBuildCommand = "string"
appLocation = "string"
githubActionSecretNameOverride = "string"
outputLocation = "string"
skipGithubActionWorkflowGeneration = bool
}
enterpriseGradeCdnStatus = "string"
provider = "string"
publicNetworkAccess = "string"
repositoryToken = "string"
repositoryUrl = "string"
stagingEnvironmentPolicy = "string"
templateProperties = {
description = "string"
isPrivate = bool
owner = "string"
repositoryName = "string"
templateRepositoryUrl = "string"
}
}
sku = {
capabilities = [
{
name = "string"
reason = "string"
value = "string"
}
]
capacity = int
family = "string"
locations = [
"string"
]
name = "string"
size = "string"
skuCapacity = {
default = int
elasticMaximum = int
maximum = int
minimum = int
scaleType = "string"
}
tier = "string"
}
}
}
Valores de propriedade
Microsoft.Web/staticSites
| Nome | Descrição | Valor |
|---|---|---|
| identidade | Identidade de serviço gerenciada. | ManagedServiceIdentity |
| tipo | Tipo de recurso. Se o recurso for um aplicativo, você poderá consultar https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference para obter detalhes de valores com suporte para tipo. | cadeia |
| local | Local do recurso. | cadeia de caracteres (obrigatório) |
| nome | O nome do recurso | cadeia de caracteres (obrigatório) |
| Propriedades | Propriedades principais do recurso | StaticSite |
| Sku | Descrição de um SKU para um recurso escalonável. | SkuDescription |
| Tags | Marcas de recurso | Dicionário de nomes e valores de marca. |
| tipo | O tipo de recurso | "Microsoft.Web/staticSites@2025-03-01" |
Capacidade
| Nome | Descrição | Valor |
|---|---|---|
| nome | Nome da funcionalidade de SKU. | cadeia |
| razão | Motivo da funcionalidade de SKU. | cadeia |
| valor | Valor da funcionalidade de SKU. | cadeia |
ManagedServiceIdentity
| Nome | Descrição | Valor |
|---|---|---|
| tipo | Tipo de identidade de serviço gerenciado. | 'Nenhum' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| Identidades Atribuídas pelo Usuário | A lista de identidades atribuídas pelo usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nome | Descrição | Valor |
|---|
Tags de recursos
| Nome | Descrição | Valor |
|---|
Capacidade de SKU
| Nome | Descrição | Valor |
|---|---|---|
| padrão | Número padrão de trabalhos para este SKU de plano do Serviço de Aplicativo. | int |
| elásticoMáximo | Número máximo de trabalhos elásticos para este SKU de plano do Serviço de Aplicativo. | int |
| máximo | Número máximo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| mínimo | Número mínimo de trabalhadores para esse SKU de plano do Serviço de Aplicativo. | int |
| tipo de escala | Configurações de escala disponíveis para um plano do Serviço de Aplicativo. | cadeia |
Descrição do Sku
Site estático
| Nome | Descrição | Valor |
|---|---|---|
| allowConfigFileUpdates | <código>falso</code> se o arquivo de configuração estiver bloqueado para este aplicativo Web estático; caso contrário, <código>verdadeiro</code>. | Bool |
| branch | O branch de destino no repositório. | cadeia |
| Propriedades de compilação | Compile propriedades para configurar no repositório. | staticSiteBuildProperties |
| enterpriseGradeCdnStatus | Estado que indica o status da CDN de nível empresarial que atende o tráfego para o aplicativo Web estático. | 'Desabilitado' 'Desabilitando' 'Habilitado' 'Habilitando' |
| fornecedor | O provedor que enviou a última implantação para o ambiente primário do site estático. | cadeia |
| públicoAcessoRedeAcesso | Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Habilitado', 'Desabilitado' ou uma cadeia de caracteres vazia. | cadeia |
| repositórioToken | Token de repositório github de um usuário. Isso é usado para configurar o arquivo de fluxo de trabalho e os segredos da API do Github Actions. | cadeia |
| repositórioUrl | URL para o repositório do site estático. | cadeia |
| stagingEnvironmentPolicy | Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. | 'Desabilitado' 'Habilitado' |
| templateProperties | Opções de modelo para gerar um novo repositório. | staticSiteTemplateOptions |
StaticSiteBuildProperties
| Nome | Descrição | Valor |
|---|---|---|
| apiBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de API do Azure Functions. | cadeia |
| apiLocalização | O caminho para o código de api dentro do repositório. | cadeia |
| appArtifactLocation | Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) | cadeia |
| appBuildCommand | Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. | cadeia |
| appLocation | O caminho para o código do aplicativo dentro do repositório. | cadeia |
| githubActionSecretNameOverride | Substituição do nome do segredo da Ação do Github. | cadeia |
| local de saída | O caminho de saída do aplicativo após a criação. | cadeia |
| skipGithubActionWorkflowGeneration | Ignorar a geração de fluxo de trabalho do Github Action. | Bool |
StaticSiteTemplateOptions
| Nome | Descrição | Valor |
|---|---|---|
| descrição | Descrição do repositório recém-gerado. | cadeia |
| éPrivado | Se o repositório recém-gerado é ou não um repositório privado. O padrão é false (ou seja, público). | Bool |
| proprietário | Proprietário do repositório recém-gerado. | cadeia |
| repositórioName | Nome do repositório recém-gerado. | cadeia |
| templateRepositoryUrl | URL do repositório de modelos. O repositório recém-gerado será baseado neste. | cadeia |
UserAssignedIdentity
| Nome | Descrição | Valor |
|---|