Microsoft.Web staticSites 2020-12-01

  • مقالة
  • قراءة خلال 4 دقائق

The staticSites resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.Web/staticSites resource, add the following Bicep or JSON to your template.

resource symbolicname 'Microsoft.Web/staticSites@2020-12-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  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'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    allowConfigFileUpdates: bool
    branch: 'string'
    buildProperties: {
      apiBuildCommand: 'string'
      apiLocation: 'string'
      appArtifactLocation: 'string'
      appBuildCommand: 'string'
      appLocation: 'string'
      githubActionSecretNameOverride: 'string'
      outputLocation: 'string'
      skipGithubActionWorkflowGeneration: bool
    }
    repositoryToken: 'string'
    repositoryUrl: 'string'
    stagingEnvironmentPolicy: 'string'
    templateProperties: {
      description: 'string'
      isPrivate: bool
      owner: 'string'
      repositoryName: 'string'
      templateRepositoryUrl: 'string'
    }
  }
}

Property values

staticSites

Name Description Value
type The resource type

For Bicep, set this value in the resource declaration.		 'Microsoft.Web/staticSites'
apiVersion The resource api version

For Bicep, set this value in the resource declaration.		 '2020-12-01'
name The resource name string (required)
location Resource Location. string (required)
tags Resource tags. Dictionary of tag names and values. See Tags in templates
sku Description of a SKU for a scalable resource. SkuDescription
kind Kind of resource. string
identity Managed service identity. ManagedServiceIdentity
properties A static site. StaticSite

ManagedServiceIdentity

Name Description Value
type Type of managed service identity. 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities The list of user assigned identities associated with the resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} object

StaticSite

Name Description Value
allowConfigFileUpdates false if config file is locked for this static web app; otherwise, true. bool
branch The target branch in the repository. string
buildProperties Build properties for the static site. StaticSiteBuildProperties
repositoryToken A user's github repository token. This is used to setup the Github Actions workflow file and API secrets. string
repositoryUrl URL for the repository of the static site. string
stagingEnvironmentPolicy State indicating whether staging environments are allowed or not allowed for a static web app. 'Disabled'
'Enabled'
templateProperties Template Options for the static site. StaticSiteTemplateOptions

StaticSiteBuildProperties

Name Description Value
apiBuildCommand A custom command to run during deployment of the Azure Functions API application. string
apiLocation The path to the api code within the repository. string
appArtifactLocation Deprecated: The path of the app artifacts after building (deprecated in favor of OutputLocation) string
appBuildCommand A custom command to run during deployment of the static content application. string
appLocation The path to the app code within the repository. string
githubActionSecretNameOverride Github Action secret name override. string
outputLocation The output path of the app after building. string
skipGithubActionWorkflowGeneration Skip Github Action workflow generation. bool

StaticSiteTemplateOptions

Name Description Value
description Description of the newly generated repository. string
isPrivate Whether or not the newly generated repository is a private repository. Defaults to false (i.e. public). bool
owner Owner of the newly generated repository. string
repositoryName Name of the newly generated repository. string
templateRepositoryUrl URL of the template repository. The newly generated repository will be based on this one. string

SkuDescription

Name Description Value
capabilities Capabilities of the SKU, e.g., is traffic manager enabled? Capability[]
capacity Current number of instances assigned to the resource. int
family Family code of the resource SKU. string
locations Locations of the SKU. string[]
name Name of the resource SKU. string
size Size specifier of the resource SKU. string
skuCapacity Description of the App Service plan scale options. SkuCapacity
tier Service tier of the resource SKU. string

Capability

Name Description Value
name Name of the SKU capability. string
reason Reason of the SKU capability. string
value Value of the SKU capability. string

SkuCapacity

Name Description Value
default Default number of workers for this App Service plan SKU. int
elasticMaximum Maximum number of Elastic workers for this App Service plan SKU. int
maximum Maximum number of workers for this App Service plan SKU. int
minimum Minimum number of workers for this App Service plan SKU. int
scaleType Available scale configurations for an App Service plan. string