Microsoft. Web staticSites

Definição de recurso do Bicep

O tipo de recurso staticSites pode ser implantado com operações de destino:

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

Nome Descrição Valor
Capacidades Os recursos da SKU, por exemplo, estão habilitados para o gerenciador de tráfego? de funcionalidade do []
capacidade Número atual de instâncias atribuídas ao recurso. int
família Código de família do SKU do recurso. cadeia
Locais Locais do SKU. cadeia de caracteres[]
nome Nome do SKU do recurso. cadeia
tamanho Especificador de tamanho do SKU do recurso. cadeia
Capacidade de sku Valores de escala mínimo, máximo e padrão da SKU. SkuCapacity
nível Camada de serviço do SKU do recurso. cadeia

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:

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

Nome Descrição Valor
Capacidades Os recursos da SKU, por exemplo, estão habilitados para o gerenciador de tráfego? de funcionalidade do []
capacidade Número atual de instâncias atribuídas ao recurso. int
família Código de família do SKU do recurso. cadeia
Locais Locais do SKU. cadeia de caracteres[]
nome Nome do SKU do recurso. cadeia
tamanho Especificador de tamanho do SKU do recurso. cadeia
Capacidade de sku Valores de escala mínimo, máximo e padrão da SKU. SkuCapacity
nível Camada de serviço do SKU do recurso. cadeia

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:

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

Nome Descrição Valor
Capacidades Os recursos da SKU, por exemplo, estão habilitados para o gerenciador de tráfego? de funcionalidade do []
capacidade Número atual de instâncias atribuídas ao recurso. int
família Código de família do SKU do recurso. cadeia
Locais Locais do SKU. cadeia de caracteres[]
nome Nome do SKU do recurso. cadeia
tamanho Especificador de tamanho do SKU do recurso. cadeia
Capacidade de sku Valores de escala mínimo, máximo e padrão da SKU. SkuCapacity
nível Camada de serviço do SKU do recurso. cadeia

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