Microsoft. WebbstaticSites

Bicep-resursdefinition

Resurstypen staticSites kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Användningsexempel

Bicep-exempel

Ett grundläggande exempel på distribution av 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: {}
}

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
Statisk webbapp AVM-resursmodul för statisk webbapp

Resursformat

Om du vill skapa en Microsoft.Web/staticSites-resurs lägger du till följande Bicep i mallen.

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

Egenskapsvärden

Microsoft.Web/staticSites

Namn Beskrivning Värde
identitet Hanterad tjänstidentitet. ManagedServiceIdentity (HanteradServiceIdentitet)
sort Typ av resurs. Om resursen är en app kan du läsa https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference för information om värden som stöds för typ. sträng
plats Resursplats. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Kärnresursegenskaper Statisk webbplats
Sku Beskrivning av en SKU för en skalbar resurs. SkuBeskrivning
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

Förmåga

Namn Beskrivning Värde
Namn Namnet på SKU-funktionen. sträng
förnuft Orsak till SKU-funktionen. sträng
värde Värdet för SKU-funktionen. sträng

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
användartilldelade identiteter Listan över användartilldelade identiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Resurstaggar

Namn Beskrivning Värde

SkuCapacity (på engelska)

Namn Beskrivning Värde
standard Standardantalet arbetare för den här App Service-plan-SKU:n. Int
elastiskMaximal Maximalt antal elastiska arbetare för denna App Service-plan-SKU. Int
maximal Maximalt antal arbetare för den här App Service-plan-SKU:n. Int
minsta Minsta antal arbetare för den här App Service-plan-SKU:n. Int
scaleType (på engelska) Tillgängliga skalningskonfigurationer för en App Service-plan. sträng

SkuBeskrivning

Namn Beskrivning Värde
Kapacitet Funktioner i SKU:n, t.ex. är Traffic Manager aktiverat? Kapacitet[]
kapacitet Aktuellt antal instanser som tilldelats resursen. Int
familj Familjekod för resurs-SKU:n. sträng
Platser Platser för SKU:n. sträng[]
Namn Namnet på resurs-SKU:n. sträng
storlek Storleksspecificerare för resurs-SKU:n. sträng
skuCapacity SKU:ns min-, max- och standardskalningsvärden. SkuCapacity (på engelska)
Nivå Tjänstnivå för resurs-SKU:n. sträng

Statisk webbplats

Namn Beskrivning Värde
allowConfigFileUpdates <kod>false</code> om konfigurationsfilen är låst för den här statiska webbappen. annars <kod>sant</code>. Bool
gren Målgrenen på lagringsplatsen. sträng
buildProperties Skapa egenskaper som ska konfigureras på lagringsplatsen. StaticSiteBuildProperties
enterpriseGradeCdnStatus Tillstånd som anger status för CDN i företagsklass som betjänar trafik till den statiska webbappen. "Inaktiverad"
"Inaktivera"
"Aktiverad"
"Aktivera"
familjeförsörjare Providern som skickade den senaste distributionen till den primära miljön på den statiska platsen. sträng
publicNetworkAccess (publicNetworkÅtkomst) Tillstånd som anger om offentlig trafik tillåts eller inte för en statisk webbapp. Tillåtna värden: "Aktiverad", "Inaktiverad" eller en tom sträng. sträng
repositoryToken (repositorytoken) En användares github-lagringsplatstoken. Detta används för att konfigurera Github Actions-arbetsflödesfilen och API-hemligheterna. sträng
repositoryUrl URL för lagringsplatsen för den statiska platsen. sträng
stagingEnvironmentPolicy Tillstånd som anger om mellanlagringsmiljöer tillåts eller inte tillåts för en statisk webbapp. "Inaktiverad"
"Aktiverad"
templateProperties (på engelska) Mallalternativ för att generera en ny lagringsplats. StaticSiteTemplateOptions

StaticSiteBuildProperties

Namn Beskrivning Värde
apiBuildKommando Ett anpassat kommando som ska köras under distributionen av Azure Functions API-programmet. sträng
apiLocation Sökvägen till API-koden på lagringsplatsen. sträng
appArtifactLocation Inaktuell: Sökvägen till appartefakterna efter skapandet (inaktuell till förmån för OutputLocation) sträng
appBuildKommando Ett anpassat kommando som ska köras under distributionen av det statiska innehållsprogrammet. sträng
appLocation Sökvägen till appkoden på lagringsplatsen. sträng
Åsidosätt githubActionSecretNameOverride Åsidosättning av hemligt namn för Github Action. sträng
outputLocation (på engelska) Utdatasökvägen för appen när du har skapat den. sträng
skipGithubActionWorkflowGeneration Hoppa över generering av Github Action-arbetsflöden. Bool

StaticSiteTemplateOptions

Namn Beskrivning Värde
beskrivning Beskrivning av den nyligen genererade lagringsplatsen. sträng
isPrivate Om den nyligen genererade lagringsplatsen är en privat lagringsplats eller inte. Standardvärdet är falskt (dvs. offentligt). Bool
ägare Ägare till den nyligen genererade lagringsplatsen. sträng
repositoryName (på engelska) Namnet på den nyligen genererade lagringsplatsen. sträng
templateRepositoryUrl URL för malllagringsplatsen. Den nyligen genererade lagringsplatsen baseras på den här. sträng

Användartilldelad identitet

Namn Beskrivning Värde

Resursdefinition för ARM-mall

Resurstypen staticSites kan distribueras med åtgärder som mål:

Användningsexempel

Resursformat

Om du vill skapa en Microsoft.Web/staticSites-resurs lägger du till följande JSON i mallen.

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

Egenskapsvärden

Microsoft.Web/staticSites

Namn Beskrivning Värde
apiVersion API-versionen '2025-03-01'
identitet Hanterad tjänstidentitet. ManagedServiceIdentity (HanteradServiceIdentitet)
sort Typ av resurs. Om resursen är en app kan du läsa https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference för information om värden som stöds för typ. sträng
plats Resursplats. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Kärnresursegenskaper Statisk webbplats
Sku Beskrivning av en SKU för en skalbar resurs. SkuBeskrivning
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.Web/staticSites"

Förmåga

Namn Beskrivning Värde
Namn Namnet på SKU-funktionen. sträng
förnuft Orsak till SKU-funktionen. sträng
värde Värdet för SKU-funktionen. sträng

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
användartilldelade identiteter Listan över användartilldelade identiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Resurstaggar

Namn Beskrivning Värde

SkuCapacity (på engelska)

Namn Beskrivning Värde
standard Standardantalet arbetare för den här App Service-plan-SKU:n. Int
elastiskMaximal Maximalt antal elastiska arbetare för denna App Service-plan-SKU. Int
maximal Maximalt antal arbetare för den här App Service-plan-SKU:n. Int
minsta Minsta antal arbetare för den här App Service-plan-SKU:n. Int
scaleType (på engelska) Tillgängliga skalningskonfigurationer för en App Service-plan. sträng

SkuBeskrivning

Namn Beskrivning Värde
Kapacitet Funktioner i SKU:n, t.ex. är Traffic Manager aktiverat? Kapacitet[]
kapacitet Aktuellt antal instanser som tilldelats resursen. Int
familj Familjekod för resurs-SKU:n. sträng
Platser Platser för SKU:n. sträng[]
Namn Namnet på resurs-SKU:n. sträng
storlek Storleksspecificerare för resurs-SKU:n. sträng
skuCapacity SKU:ns min-, max- och standardskalningsvärden. SkuCapacity (på engelska)
Nivå Tjänstnivå för resurs-SKU:n. sträng

Statisk webbplats

Namn Beskrivning Värde
allowConfigFileUpdates <kod>false</code> om konfigurationsfilen är låst för den här statiska webbappen. annars <kod>sant</code>. Bool
gren Målgrenen på lagringsplatsen. sträng
buildProperties Skapa egenskaper som ska konfigureras på lagringsplatsen. StaticSiteBuildProperties
enterpriseGradeCdnStatus Tillstånd som anger status för CDN i företagsklass som betjänar trafik till den statiska webbappen. "Inaktiverad"
"Inaktivera"
"Aktiverad"
"Aktivera"
familjeförsörjare Providern som skickade den senaste distributionen till den primära miljön på den statiska platsen. sträng
publicNetworkAccess (publicNetworkÅtkomst) Tillstånd som anger om offentlig trafik tillåts eller inte för en statisk webbapp. Tillåtna värden: "Aktiverad", "Inaktiverad" eller en tom sträng. sträng
repositoryToken (repositorytoken) En användares github-lagringsplatstoken. Detta används för att konfigurera Github Actions-arbetsflödesfilen och API-hemligheterna. sträng
repositoryUrl URL för lagringsplatsen för den statiska platsen. sträng
stagingEnvironmentPolicy Tillstånd som anger om mellanlagringsmiljöer tillåts eller inte tillåts för en statisk webbapp. "Inaktiverad"
"Aktiverad"
templateProperties (på engelska) Mallalternativ för att generera en ny lagringsplats. StaticSiteTemplateOptions

StaticSiteBuildProperties

Namn Beskrivning Värde
apiBuildKommando Ett anpassat kommando som ska köras under distributionen av Azure Functions API-programmet. sträng
apiLocation Sökvägen till API-koden på lagringsplatsen. sträng
appArtifactLocation Inaktuell: Sökvägen till appartefakterna efter skapandet (inaktuell till förmån för OutputLocation) sträng
appBuildKommando Ett anpassat kommando som ska köras under distributionen av det statiska innehållsprogrammet. sträng
appLocation Sökvägen till appkoden på lagringsplatsen. sträng
Åsidosätt githubActionSecretNameOverride Åsidosättning av hemligt namn för Github Action. sträng
outputLocation (på engelska) Utdatasökvägen för appen när du har skapat den. sträng
skipGithubActionWorkflowGeneration Hoppa över generering av Github Action-arbetsflöden. Bool

StaticSiteTemplateOptions

Namn Beskrivning Värde
beskrivning Beskrivning av den nyligen genererade lagringsplatsen. sträng
isPrivate Om den nyligen genererade lagringsplatsen är en privat lagringsplats eller inte. Standardvärdet är falskt (dvs. offentligt). Bool
ägare Ägare till den nyligen genererade lagringsplatsen. sträng
repositoryName (på engelska) Namnet på den nyligen genererade lagringsplatsen. sträng
templateRepositoryUrl URL för malllagringsplatsen. Den nyligen genererade lagringsplatsen baseras på den här. sträng

Användartilldelad identitet

Namn Beskrivning Värde

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen staticSites kan distribueras med åtgärder som mål:

  • Resursgrupper För en lista över ändrade egenskaper i varje API-version, se ändringslogg.

Användningsexempel

Terraform-exempel

Ett grundläggande exempel på distribution av 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    = ["*"]
}

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul Beskrivning
Statisk webbapp AVM-resursmodul för statisk webbapp

Resursformat

Om du vill skapa en Microsoft.Web/staticSites-resurs lägger du till följande Terraform i mallen.

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

Egenskapsvärden

Microsoft.Web/staticSites

Namn Beskrivning Värde
identitet Hanterad tjänstidentitet. ManagedServiceIdentity (HanteradServiceIdentitet)
sort Typ av resurs. Om resursen är en app kan du läsa https://github.com/Azure/app-service-linux-docs/blob/master/Things_You_Should_Know/kind_property.md#app-service-resource-kind-reference för information om värden som stöds för typ. sträng
plats Resursplats. sträng (krävs)
Namn Resursnamnet sträng (krävs)
Egenskaper Kärnresursegenskaper Statisk webbplats
Sku Beskrivning av en SKU för en skalbar resurs. SkuBeskrivning
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.Web/staticSites@2025-03-01"

Förmåga

Namn Beskrivning Värde
Namn Namnet på SKU-funktionen. sträng
förnuft Orsak till SKU-funktionen. sträng
värde Värdet för SKU-funktionen. sträng

ManagedServiceIdentity (HanteradServiceIdentitet)

Namn Beskrivning Värde
typ Typ av hanterad tjänstidentitet. "Ingen"
"SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
användartilldelade identiteter Listan över användartilldelade identiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ManagedServiceIdentityUserAssignedIdentiteter

ManagedServiceIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Resurstaggar

Namn Beskrivning Värde

SkuCapacity (på engelska)

Namn Beskrivning Värde
standard Standardantalet arbetare för den här App Service-plan-SKU:n. Int
elastiskMaximal Maximalt antal elastiska arbetare för denna App Service-plan-SKU. Int
maximal Maximalt antal arbetare för den här App Service-plan-SKU:n. Int
minsta Minsta antal arbetare för den här App Service-plan-SKU:n. Int
scaleType (på engelska) Tillgängliga skalningskonfigurationer för en App Service-plan. sträng

SkuBeskrivning

Namn Beskrivning Värde
Kapacitet Funktioner i SKU:n, t.ex. är Traffic Manager aktiverat? Kapacitet[]
kapacitet Aktuellt antal instanser som tilldelats resursen. Int
familj Familjekod för resurs-SKU:n. sträng
Platser Platser för SKU:n. sträng[]
Namn Namnet på resurs-SKU:n. sträng
storlek Storleksspecificerare för resurs-SKU:n. sträng
skuCapacity SKU:ns min-, max- och standardskalningsvärden. SkuCapacity (på engelska)
Nivå Tjänstnivå för resurs-SKU:n. sträng

Statisk webbplats

Namn Beskrivning Värde
allowConfigFileUpdates <kod>false</code> om konfigurationsfilen är låst för den här statiska webbappen. annars <kod>sant</code>. Bool
gren Målgrenen på lagringsplatsen. sträng
buildProperties Skapa egenskaper som ska konfigureras på lagringsplatsen. StaticSiteBuildProperties
enterpriseGradeCdnStatus Tillstånd som anger status för CDN i företagsklass som betjänar trafik till den statiska webbappen. "Inaktiverad"
"Inaktivera"
"Aktiverad"
"Aktivera"
familjeförsörjare Providern som skickade den senaste distributionen till den primära miljön på den statiska platsen. sträng
publicNetworkAccess (publicNetworkÅtkomst) Tillstånd som anger om offentlig trafik tillåts eller inte för en statisk webbapp. Tillåtna värden: "Aktiverad", "Inaktiverad" eller en tom sträng. sträng
repositoryToken (repositorytoken) En användares github-lagringsplatstoken. Detta används för att konfigurera Github Actions-arbetsflödesfilen och API-hemligheterna. sträng
repositoryUrl URL för lagringsplatsen för den statiska platsen. sträng
stagingEnvironmentPolicy Tillstånd som anger om mellanlagringsmiljöer tillåts eller inte tillåts för en statisk webbapp. "Inaktiverad"
"Aktiverad"
templateProperties (på engelska) Mallalternativ för att generera en ny lagringsplats. StaticSiteTemplateOptions

StaticSiteBuildProperties

Namn Beskrivning Värde
apiBuildKommando Ett anpassat kommando som ska köras under distributionen av Azure Functions API-programmet. sträng
apiLocation Sökvägen till API-koden på lagringsplatsen. sträng
appArtifactLocation Inaktuell: Sökvägen till appartefakterna efter skapandet (inaktuell till förmån för OutputLocation) sträng
appBuildKommando Ett anpassat kommando som ska köras under distributionen av det statiska innehållsprogrammet. sträng
appLocation Sökvägen till appkoden på lagringsplatsen. sträng
Åsidosätt githubActionSecretNameOverride Åsidosättning av hemligt namn för Github Action. sträng
outputLocation (på engelska) Utdatasökvägen för appen när du har skapat den. sträng
skipGithubActionWorkflowGeneration Hoppa över generering av Github Action-arbetsflöden. Bool

StaticSiteTemplateOptions

Namn Beskrivning Värde
beskrivning Beskrivning av den nyligen genererade lagringsplatsen. sträng
isPrivate Om den nyligen genererade lagringsplatsen är en privat lagringsplats eller inte. Standardvärdet är falskt (dvs. offentligt). Bool
ägare Ägare till den nyligen genererade lagringsplatsen. sträng
repositoryName (på engelska) Namnet på den nyligen genererade lagringsplatsen. sträng
templateRepositoryUrl URL för malllagringsplatsen. Den nyligen genererade lagringsplatsen baseras på den här. sträng

Användartilldelad identitet

Namn Beskrivning Värde