Definição de recursos do bíceps
O tipo de recurso staticSites pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Exemplos de uso
Amostras de bíceps
Um exemplo básico de implantação do Static Web App.
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
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo |
Descrição |
|
do aplicativo Web estático |
Módulo de recursos AVM para aplicação Web estática |
Para criar um recurso Microsoft.Web/staticSites, adicione o seguinte Bíceps 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
Capacidade
| Designação |
Descrição |
Valor |
| Designação |
Nome do recurso de SKU. |
cadeia (de caracteres) |
| Justificação |
Razão da capacidade de SKU. |
cadeia (de caracteres) |
| valor |
Valor da capacidade de SKU. |
cadeia (de caracteres) |
ManagedServiceIdentity
| Designação |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado. |
'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| identidades atribuídas pelo utilizador |
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 ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Designação |
Descrição |
Valor |
| Designação |
Descrição |
Valor |
Capacidade de Sku
| Designação |
Descrição |
Valor |
| predefinição |
Número padrão de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| elasticMaximum |
Número máximo de trabalhadores elásticos para esta SKU do plano do Serviço de Aplicativo. |
Int |
| máximo |
Número máximo de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| mínimo |
Número mínimo de trabalhadores para esta SKU do 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 (de caracteres) |
SkuDescrição
| Designação |
Descrição |
Valor |
| Capacidades |
Recursos do SKU, por exemplo, o gerenciador de tráfego está habilitado? |
Capacidade [] |
| capacidade |
Número atual de instâncias atribuídas ao recurso. |
Int |
| Família |
Código de família do recurso SKU. |
cadeia (de caracteres) |
| Locais |
Localizações do SKU. |
string[] |
| Designação |
Nome da SKU do recurso. |
cadeia (de caracteres) |
| tamanho |
Especificador de tamanho do recurso SKU. |
cadeia (de caracteres) |
| skuCapacidade |
Valores de escala mínimos, máximos e padrão da SKU. |
Capacidade de Sku |
| escalão |
Camada de serviço da SKU de recurso. |
cadeia (de caracteres) |
Sítio Estático
| Designação |
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>true</code>. |
Bool |
| ramificar |
A ramificação de destino no repositório. |
cadeia (de caracteres) |
| construirPropriedades |
Crie propriedades para configurar no repositório. |
StaticSiteBuildProperties |
| enterpriseGradeCdnStatus |
Estado que indica o estado da CDN de nível empresarial que serve o tráfego para a aplicação Web estática. |
'Desativado' 'Desativação' 'Habilitado' 'Habilitação' |
| fornecedor |
O provedor que enviou a última implantação para o ambiente primário do site estático. |
cadeia (de caracteres) |
| acesso à rede pública |
Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Ativado', 'Desativado' ou uma cadeia de caracteres vazia. |
cadeia (de caracteres) |
| repositoryToken |
Um token de repositório github do usuário. Isso é usado para configurar o arquivo de fluxo de trabalho do Github Actions e os segredos da API. |
cadeia (de caracteres) |
| repositoryUrl |
URL para o repositório do site estático. |
cadeia (de caracteres) |
| preparaçãoAmbientePolítica |
Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. |
'Desativado' 'Habilitado' |
| templatePropriedades |
Opções de modelo para gerar um novo repositório. |
StaticSiteTemplateOptions |
StaticSiteBuildProperties
| Designação |
Descrição |
Valor |
| apiBuildCommand |
Um comando personalizado para ser executado durante a implantação do aplicativo de API do Funções do Azure. |
cadeia (de caracteres) |
| apiLocalização |
O caminho para o código da api dentro do repositório. |
cadeia (de caracteres) |
| appArtifactLocalização |
Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) |
cadeia (de caracteres) |
| appBuildCommand |
Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. |
cadeia (de caracteres) |
| appLocalização |
O caminho para o código do aplicativo dentro do repositório. |
cadeia (de caracteres) |
| githubActionSecretNameOverride |
Substituição do nome secreto do Github Action. |
cadeia (de caracteres) |
| outputLocalização |
O caminho de saída do aplicativo após a compilação. |
cadeia (de caracteres) |
| skipGithubActionWorkflowGeneration |
Ignore a geração de fluxo de trabalho do Github Action. |
Bool |
StaticSiteTemplateOptions
| Designação |
Descrição |
Valor |
| Descrição |
Descrição do repositório recém-gerado. |
cadeia (de caracteres) |
| isPrivate |
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 (de caracteres) |
| Nome do Repositório |
Nome do repositório recém-gerado. |
cadeia (de caracteres) |
| templateRepositoryUrl |
URL do repositório de modelos. O repositório recém-gerado será baseado neste. |
cadeia (de caracteres) |
IdentidadeAtribuídaPeloUtilizador
| Designação |
Descrição |
Valor |
Definição de recurso de modelo ARM
O tipo de recurso staticSites pode ser implantado com operações que visam:
Exemplos de uso
Para criar um recurso Microsoft.Web/staticSites, adicione o seguinte JSON ao seu 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
Capacidade
| Designação |
Descrição |
Valor |
| Designação |
Nome do recurso de SKU. |
cadeia (de caracteres) |
| Justificação |
Razão da capacidade de SKU. |
cadeia (de caracteres) |
| valor |
Valor da capacidade de SKU. |
cadeia (de caracteres) |
ManagedServiceIdentity
| Designação |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado. |
'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| identidades atribuídas pelo utilizador |
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 ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Designação |
Descrição |
Valor |
| Designação |
Descrição |
Valor |
Capacidade de Sku
| Designação |
Descrição |
Valor |
| predefinição |
Número padrão de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| elasticMaximum |
Número máximo de trabalhadores elásticos para esta SKU do plano do Serviço de Aplicativo. |
Int |
| máximo |
Número máximo de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| mínimo |
Número mínimo de trabalhadores para esta SKU do 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 (de caracteres) |
SkuDescrição
| Designação |
Descrição |
Valor |
| Capacidades |
Recursos do SKU, por exemplo, o gerenciador de tráfego está habilitado? |
Capacidade [] |
| capacidade |
Número atual de instâncias atribuídas ao recurso. |
Int |
| Família |
Código de família do recurso SKU. |
cadeia (de caracteres) |
| Locais |
Localizações do SKU. |
string[] |
| Designação |
Nome da SKU do recurso. |
cadeia (de caracteres) |
| tamanho |
Especificador de tamanho do recurso SKU. |
cadeia (de caracteres) |
| skuCapacidade |
Valores de escala mínimos, máximos e padrão da SKU. |
Capacidade de Sku |
| escalão |
Camada de serviço da SKU de recurso. |
cadeia (de caracteres) |
Sítio Estático
| Designação |
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>true</code>. |
Bool |
| ramificar |
A ramificação de destino no repositório. |
cadeia (de caracteres) |
| construirPropriedades |
Crie propriedades para configurar no repositório. |
StaticSiteBuildProperties |
| enterpriseGradeCdnStatus |
Estado que indica o estado da CDN de nível empresarial que serve o tráfego para a aplicação Web estática. |
'Desativado' 'Desativação' 'Habilitado' 'Habilitação' |
| fornecedor |
O provedor que enviou a última implantação para o ambiente primário do site estático. |
cadeia (de caracteres) |
| acesso à rede pública |
Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Ativado', 'Desativado' ou uma cadeia de caracteres vazia. |
cadeia (de caracteres) |
| repositoryToken |
Um token de repositório github do usuário. Isso é usado para configurar o arquivo de fluxo de trabalho do Github Actions e os segredos da API. |
cadeia (de caracteres) |
| repositoryUrl |
URL para o repositório do site estático. |
cadeia (de caracteres) |
| preparaçãoAmbientePolítica |
Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. |
'Desativado' 'Habilitado' |
| templatePropriedades |
Opções de modelo para gerar um novo repositório. |
StaticSiteTemplateOptions |
StaticSiteBuildProperties
| Designação |
Descrição |
Valor |
| apiBuildCommand |
Um comando personalizado para ser executado durante a implantação do aplicativo de API do Funções do Azure. |
cadeia (de caracteres) |
| apiLocalização |
O caminho para o código da api dentro do repositório. |
cadeia (de caracteres) |
| appArtifactLocalização |
Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) |
cadeia (de caracteres) |
| appBuildCommand |
Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. |
cadeia (de caracteres) |
| appLocalização |
O caminho para o código do aplicativo dentro do repositório. |
cadeia (de caracteres) |
| githubActionSecretNameOverride |
Substituição do nome secreto do Github Action. |
cadeia (de caracteres) |
| outputLocalização |
O caminho de saída do aplicativo após a compilação. |
cadeia (de caracteres) |
| skipGithubActionWorkflowGeneration |
Ignore a geração de fluxo de trabalho do Github Action. |
Bool |
StaticSiteTemplateOptions
| Designação |
Descrição |
Valor |
| Descrição |
Descrição do repositório recém-gerado. |
cadeia (de caracteres) |
| isPrivate |
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 (de caracteres) |
| Nome do Repositório |
Nome do repositório recém-gerado. |
cadeia (de caracteres) |
| templateRepositoryUrl |
URL do repositório de modelos. O repositório recém-gerado será baseado neste. |
cadeia (de caracteres) |
IdentidadeAtribuídaPeloUtilizador
| Designação |
Descrição |
Valor |
O tipo de recurso staticSites pode ser implantado com operações que visam:
-
Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja registo de alterações.
Exemplos de uso
Um exemplo básico de implantação do Static Web App.
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
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo |
Descrição |
|
do aplicativo Web estático |
Módulo de recursos AVM para aplicação Web estática |
Para criar um recurso Microsoft.Web/staticSites, adicione o seguinte Terraform 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
Capacidade
| Designação |
Descrição |
Valor |
| Designação |
Nome do recurso de SKU. |
cadeia (de caracteres) |
| Justificação |
Razão da capacidade de SKU. |
cadeia (de caracteres) |
| valor |
Valor da capacidade de SKU. |
cadeia (de caracteres) |
ManagedServiceIdentity
| Designação |
Descrição |
Valor |
| tipo |
Tipo de identidade de serviço gerenciado. |
'Nenhuma' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' |
| identidades atribuídas pelo utilizador |
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 ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} |
ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Designação |
Descrição |
Valor |
| Designação |
Descrição |
Valor |
Capacidade de Sku
| Designação |
Descrição |
Valor |
| predefinição |
Número padrão de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| elasticMaximum |
Número máximo de trabalhadores elásticos para esta SKU do plano do Serviço de Aplicativo. |
Int |
| máximo |
Número máximo de trabalhadores para esta SKU do plano do Serviço de Aplicativo. |
Int |
| mínimo |
Número mínimo de trabalhadores para esta SKU do 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 (de caracteres) |
SkuDescrição
| Designação |
Descrição |
Valor |
| Capacidades |
Recursos do SKU, por exemplo, o gerenciador de tráfego está habilitado? |
Capacidade [] |
| capacidade |
Número atual de instâncias atribuídas ao recurso. |
Int |
| Família |
Código de família do recurso SKU. |
cadeia (de caracteres) |
| Locais |
Localizações do SKU. |
string[] |
| Designação |
Nome da SKU do recurso. |
cadeia (de caracteres) |
| tamanho |
Especificador de tamanho do recurso SKU. |
cadeia (de caracteres) |
| skuCapacidade |
Valores de escala mínimos, máximos e padrão da SKU. |
Capacidade de Sku |
| escalão |
Camada de serviço da SKU de recurso. |
cadeia (de caracteres) |
Sítio Estático
| Designação |
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>true</code>. |
Bool |
| ramificar |
A ramificação de destino no repositório. |
cadeia (de caracteres) |
| construirPropriedades |
Crie propriedades para configurar no repositório. |
StaticSiteBuildProperties |
| enterpriseGradeCdnStatus |
Estado que indica o estado da CDN de nível empresarial que serve o tráfego para a aplicação Web estática. |
'Desativado' 'Desativação' 'Habilitado' 'Habilitação' |
| fornecedor |
O provedor que enviou a última implantação para o ambiente primário do site estático. |
cadeia (de caracteres) |
| acesso à rede pública |
Estado que indica se o tráfego público é permitido ou não para um aplicativo Web estático. Valores permitidos: 'Ativado', 'Desativado' ou uma cadeia de caracteres vazia. |
cadeia (de caracteres) |
| repositoryToken |
Um token de repositório github do usuário. Isso é usado para configurar o arquivo de fluxo de trabalho do Github Actions e os segredos da API. |
cadeia (de caracteres) |
| repositoryUrl |
URL para o repositório do site estático. |
cadeia (de caracteres) |
| preparaçãoAmbientePolítica |
Estado que indica se os ambientes de preparo são permitidos ou não para um aplicativo Web estático. |
'Desativado' 'Habilitado' |
| templatePropriedades |
Opções de modelo para gerar um novo repositório. |
StaticSiteTemplateOptions |
StaticSiteBuildProperties
| Designação |
Descrição |
Valor |
| apiBuildCommand |
Um comando personalizado para ser executado durante a implantação do aplicativo de API do Funções do Azure. |
cadeia (de caracteres) |
| apiLocalização |
O caminho para o código da api dentro do repositório. |
cadeia (de caracteres) |
| appArtifactLocalização |
Preterido: o caminho dos artefatos do aplicativo após a criação (preterido em favor de OutputLocation) |
cadeia (de caracteres) |
| appBuildCommand |
Um comando personalizado a ser executado durante a implantação do aplicativo de conteúdo estático. |
cadeia (de caracteres) |
| appLocalização |
O caminho para o código do aplicativo dentro do repositório. |
cadeia (de caracteres) |
| githubActionSecretNameOverride |
Substituição do nome secreto do Github Action. |
cadeia (de caracteres) |
| outputLocalização |
O caminho de saída do aplicativo após a compilação. |
cadeia (de caracteres) |
| skipGithubActionWorkflowGeneration |
Ignore a geração de fluxo de trabalho do Github Action. |
Bool |
StaticSiteTemplateOptions
| Designação |
Descrição |
Valor |
| Descrição |
Descrição do repositório recém-gerado. |
cadeia (de caracteres) |
| isPrivate |
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 (de caracteres) |
| Nome do Repositório |
Nome do repositório recém-gerado. |
cadeia (de caracteres) |
| templateRepositoryUrl |
URL do repositório de modelos. O repositório recém-gerado será baseado neste. |
cadeia (de caracteres) |
IdentidadeAtribuídaPeloUtilizador
| Designação |
Descrição |
Valor |