Microsoft. Web staticSites

Definizione di risorsa Bicep

Il tipo di risorsa staticSites può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione di un'app Web statica.

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: {}
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
'app Web statica Modulo di risorse AVM per l'app Web statica

Formato risorsa

Per creare una risorsa Microsoft.Web/staticSites, aggiungere il bicep seguente al modello.

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'
  }
}

Valori delle proprietà

Microsoft.Web/staticSites

Nome Descrizione Valore
identità Identità del servizio gestito. ManagedServiceIdentity
gentile Tipo di risorsa. Se la risorsa è un'app, è possibile fare riferimento a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference per informazioni dettagliate sui valori supportati per il tipo. corda
ubicazione Percorso risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse principali staticSite
Sku Descrizione di uno SKU per una risorsa scalabile. skuDescription
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

Capacità

Nome Descrizione Valore
nome Nome della funzionalità SKU. corda
ragione Motivo della funzionalità SKU. corda
valore Valore della funzionalità SKU. corda

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned, UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Etichette delle risorse

Nome Descrizione Valore

SkuCapacità

Nome Descrizione Valore
impostazione predefinita Numero predefinito di ruoli di lavoro per questo SKU del piano di servizio app. Int
elasticoMassimo Numero massimo di ruoli di lavoro elastici per questo SKU del piano di servizio app. Int
massimo Numero massimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
minimo Numero minimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
scaleType Configurazioni di scalabilità disponibili per un piano di servizio app. corda

SKUDidescrizione

Nome Descrizione Valore
Funzionalità Le funzionalità dello SKU, ad esempio, sono abilitate per Gestione traffico? funzionalità[]
capacità Numero corrente di istanze assegnate alla risorsa. Int
famiglia Codice della famiglia dello SKU della risorsa. corda
Luoghi Posizioni dello SKU. stringa[]
nome Nome dello SKU della risorsa. corda
grandezza Identificatore di dimensioni dello SKU della risorsa. corda
skuCapacità Valori di scala minimo, massimo e predefinito dello SKU. SkuCapacità
livello Livello di servizio dello SKU della risorsa. corda

Sito statico

Nome Descrizione Valore
allowConfigFileUpdates <codice>false</code> se il file di configurazione è bloccato per questa app Web statica; in caso contrario, <codice>true</code>. Bool
ramo Ramo di destinazione nel repository. corda
buildProperties Compilare le proprietà da configurare nel repository. staticSiteBuildProperties
enterpriseGradeCdnStatus Stato che indica lo stato della rete CDN di livello aziendale che gestisce il traffico verso l'app Web statica. 'Disabilitato'
'Disabilitazione'
'Abilitato'
'Abilitazione'
fornitore Provider che ha inviato l'ultima distribuzione all'ambiente primario del sito statico. corda
pubblicoAccesso alla rete Stato che indica se il traffico pubblico è consentito o meno per un'app Web statica. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. corda
repositoryToken Token del repository GitHub di un utente. Viene usato per configurare il file del flusso di lavoro di Github Actions e i segreti dell'API. corda
repositoryUrl URL per il repository del sito statico. corda
stagingEnvironmentPolicy Stato che indica se gli ambienti di staging sono consentiti o meno per un'app Web statica. 'Disabilitato'
'Abilitato'
templateProprietà Opzioni di modello per la generazione di un nuovo repository. StaticSiteTemplateOptions

Proprietà StaticSiteBuildProperties

Nome Descrizione Valore
apiBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione API funzioni di Azure. corda
apiLocation Percorso del codice api all'interno del repository. corda
appArtifactLocation Deprecato: percorso degli artefatti dell'app dopo la compilazione (deprecato a favore di OutputLocation) corda
appBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione contenuto statico. corda
appLocation Percorso del codice dell'app all'interno del repository. corda
githubActionSecretNameOverride Override del nome segreto di Github Action. corda
outputLocation Percorso di output dell'app dopo la compilazione. corda
skipGithubActionWorkflowGeneration Ignorare la generazione del flusso di lavoro di Github Action. Bool

Opzioni StaticSiteTemplateOptions

Nome Descrizione Valore
descrizione Descrizione del repository appena generato. corda
èPrivate Indica se il repository appena generato è un repository privato. Il valore predefinito è false (ad esempio pubblico). Bool
proprietario Proprietario del repository appena generato. corda
repositoryName Nome del repository appena generato. corda
templateRepositoryUrl URL del repository di modelli. Il repository appena generato sarà basato su questo. corda

Identità Assegnata dall'Utente

Nome Descrizione Valore

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa staticSites può essere distribuito con operazioni destinate a:

Esempi di utilizzo

Formato risorsa

Per creare una risorsa Microsoft.Web/staticSites, aggiungere il codice JSON seguente al modello.

{
  "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"
  }
}

Valori delle proprietà

Microsoft.Web/staticSites

Nome Descrizione Valore
versione dell'API Versione dell'API '2025-03-01'
identità Identità del servizio gestito. ManagedServiceIdentity
gentile Tipo di risorsa. Se la risorsa è un'app, è possibile fare riferimento a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference per informazioni dettagliate sui valori supportati per il tipo. corda
ubicazione Percorso risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse principali staticSite
Sku Descrizione di uno SKU per una risorsa scalabile. skuDescription
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.Web/staticSites'

Capacità

Nome Descrizione Valore
nome Nome della funzionalità SKU. corda
ragione Motivo della funzionalità SKU. corda
valore Valore della funzionalità SKU. corda

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned, UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Etichette delle risorse

Nome Descrizione Valore

SkuCapacità

Nome Descrizione Valore
impostazione predefinita Numero predefinito di ruoli di lavoro per questo SKU del piano di servizio app. Int
elasticoMassimo Numero massimo di ruoli di lavoro elastici per questo SKU del piano di servizio app. Int
massimo Numero massimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
minimo Numero minimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
scaleType Configurazioni di scalabilità disponibili per un piano di servizio app. corda

SKUDidescrizione

Nome Descrizione Valore
Funzionalità Le funzionalità dello SKU, ad esempio, sono abilitate per Gestione traffico? funzionalità[]
capacità Numero corrente di istanze assegnate alla risorsa. Int
famiglia Codice della famiglia dello SKU della risorsa. corda
Luoghi Posizioni dello SKU. stringa[]
nome Nome dello SKU della risorsa. corda
grandezza Identificatore di dimensioni dello SKU della risorsa. corda
skuCapacità Valori di scala minimo, massimo e predefinito dello SKU. SkuCapacità
livello Livello di servizio dello SKU della risorsa. corda

Sito statico

Nome Descrizione Valore
allowConfigFileUpdates <codice>false</code> se il file di configurazione è bloccato per questa app Web statica; in caso contrario, <codice>true</code>. Bool
ramo Ramo di destinazione nel repository. corda
buildProperties Compilare le proprietà da configurare nel repository. staticSiteBuildProperties
enterpriseGradeCdnStatus Stato che indica lo stato della rete CDN di livello aziendale che gestisce il traffico verso l'app Web statica. 'Disabilitato'
'Disabilitazione'
'Abilitato'
'Abilitazione'
fornitore Provider che ha inviato l'ultima distribuzione all'ambiente primario del sito statico. corda
pubblicoAccesso alla rete Stato che indica se il traffico pubblico è consentito o meno per un'app Web statica. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. corda
repositoryToken Token del repository GitHub di un utente. Viene usato per configurare il file del flusso di lavoro di Github Actions e i segreti dell'API. corda
repositoryUrl URL per il repository del sito statico. corda
stagingEnvironmentPolicy Stato che indica se gli ambienti di staging sono consentiti o meno per un'app Web statica. 'Disabilitato'
'Abilitato'
templateProprietà Opzioni di modello per la generazione di un nuovo repository. StaticSiteTemplateOptions

Proprietà StaticSiteBuildProperties

Nome Descrizione Valore
apiBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione API funzioni di Azure. corda
apiLocation Percorso del codice api all'interno del repository. corda
appArtifactLocation Deprecato: percorso degli artefatti dell'app dopo la compilazione (deprecato a favore di OutputLocation) corda
appBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione contenuto statico. corda
appLocation Percorso del codice dell'app all'interno del repository. corda
githubActionSecretNameOverride Override del nome segreto di Github Action. corda
outputLocation Percorso di output dell'app dopo la compilazione. corda
skipGithubActionWorkflowGeneration Ignorare la generazione del flusso di lavoro di Github Action. Bool

Opzioni StaticSiteTemplateOptions

Nome Descrizione Valore
descrizione Descrizione del repository appena generato. corda
èPrivate Indica se il repository appena generato è un repository privato. Il valore predefinito è false (ad esempio pubblico). Bool
proprietario Proprietario del repository appena generato. corda
repositoryName Nome del repository appena generato. corda
templateRepositoryUrl URL del repository di modelli. Il repository appena generato sarà basato su questo. corda

Identità Assegnata dall'Utente

Nome Descrizione Valore

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa staticSites può essere distribuito con operazioni destinate a:

  • Gruppi di risorse Per un elenco delle proprietà modificate in ogni versione dell'API, vedi il registro modifiche.

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione di un'app Web statica.

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    = ["*"]
}

Moduli verificati di Azure

Per distribuire questo tipo di risorsa, è possibile usare moduli verificati di Azure.

Modulo Descrizione
'app Web statica Modulo di risorse AVM per l'app Web statica

Formato risorsa

Per creare una risorsa Microsoft.Web/staticSites, aggiungere il codice Terraform seguente al modello.

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"
    }
  }
}

Valori delle proprietà

Microsoft.Web/staticSites

Nome Descrizione Valore
identità Identità del servizio gestito. ManagedServiceIdentity
gentile Tipo di risorsa. Se la risorsa è un'app, è possibile fare riferimento a https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference per informazioni dettagliate sui valori supportati per il tipo. corda
ubicazione Percorso risorsa. stringa (obbligatorio)
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà delle risorse principali staticSite
Sku Descrizione di uno SKU per una risorsa scalabile. skuDescription
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.Web/staticSites@2025-03-01"

Capacità

Nome Descrizione Valore
nome Nome della funzionalità SKU. corda
ragione Motivo della funzionalità SKU. corda
valore Valore della funzionalità SKU. corda

Identità dei Servizi Gestiti

Nome Descrizione Valore
digitare Tipo di identità del servizio gestito. 'Nessuno'
'Assegnato dal sistema'
'SystemAssigned, UserAssigned'
'Assegnato dall'utente'
userAssignedIdentities Elenco di identità assegnate dall'utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

Etichette delle risorse

Nome Descrizione Valore

SkuCapacità

Nome Descrizione Valore
impostazione predefinita Numero predefinito di ruoli di lavoro per questo SKU del piano di servizio app. Int
elasticoMassimo Numero massimo di ruoli di lavoro elastici per questo SKU del piano di servizio app. Int
massimo Numero massimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
minimo Numero minimo di ruoli di lavoro per questo SKU del piano di servizio app. Int
scaleType Configurazioni di scalabilità disponibili per un piano di servizio app. corda

SKUDidescrizione

Nome Descrizione Valore
Funzionalità Le funzionalità dello SKU, ad esempio, sono abilitate per Gestione traffico? funzionalità[]
capacità Numero corrente di istanze assegnate alla risorsa. Int
famiglia Codice della famiglia dello SKU della risorsa. corda
Luoghi Posizioni dello SKU. stringa[]
nome Nome dello SKU della risorsa. corda
grandezza Identificatore di dimensioni dello SKU della risorsa. corda
skuCapacità Valori di scala minimo, massimo e predefinito dello SKU. SkuCapacità
livello Livello di servizio dello SKU della risorsa. corda

Sito statico

Nome Descrizione Valore
allowConfigFileUpdates <codice>false</code> se il file di configurazione è bloccato per questa app Web statica; in caso contrario, <codice>true</code>. Bool
ramo Ramo di destinazione nel repository. corda
buildProperties Compilare le proprietà da configurare nel repository. staticSiteBuildProperties
enterpriseGradeCdnStatus Stato che indica lo stato della rete CDN di livello aziendale che gestisce il traffico verso l'app Web statica. 'Disabilitato'
'Disabilitazione'
'Abilitato'
'Abilitazione'
fornitore Provider che ha inviato l'ultima distribuzione all'ambiente primario del sito statico. corda
pubblicoAccesso alla rete Stato che indica se il traffico pubblico è consentito o meno per un'app Web statica. Valori consentiti: 'Enabled', 'Disabled' o una stringa vuota. corda
repositoryToken Token del repository GitHub di un utente. Viene usato per configurare il file del flusso di lavoro di Github Actions e i segreti dell'API. corda
repositoryUrl URL per il repository del sito statico. corda
stagingEnvironmentPolicy Stato che indica se gli ambienti di staging sono consentiti o meno per un'app Web statica. 'Disabilitato'
'Abilitato'
templateProprietà Opzioni di modello per la generazione di un nuovo repository. StaticSiteTemplateOptions

Proprietà StaticSiteBuildProperties

Nome Descrizione Valore
apiBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione API funzioni di Azure. corda
apiLocation Percorso del codice api all'interno del repository. corda
appArtifactLocation Deprecato: percorso degli artefatti dell'app dopo la compilazione (deprecato a favore di OutputLocation) corda
appBuildCommand Comando personalizzato da eseguire durante la distribuzione dell'applicazione contenuto statico. corda
appLocation Percorso del codice dell'app all'interno del repository. corda
githubActionSecretNameOverride Override del nome segreto di Github Action. corda
outputLocation Percorso di output dell'app dopo la compilazione. corda
skipGithubActionWorkflowGeneration Ignorare la generazione del flusso di lavoro di Github Action. Bool

Opzioni StaticSiteTemplateOptions

Nome Descrizione Valore
descrizione Descrizione del repository appena generato. corda
èPrivate Indica se il repository appena generato è un repository privato. Il valore predefinito è false (ad esempio pubblico). Bool
proprietario Proprietario del repository appena generato. corda
repositoryName Nome del repository appena generato. corda
templateRepositoryUrl URL del repository di modelli. Il repository appena generato sarà basato su questo. corda

Identità Assegnata dall'Utente

Nome Descrizione Valore