Share via

Microsoft.Web staticSites 2020-09-01

  • Article

Bicep resource definition

The staticSites resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

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

resource symbolicname 'Microsoft.Web/staticSites@2020-09-01' = {
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    branch: 'string'
    buildProperties: {
      apiLocation: 'string'
      appArtifactLocation: 'string'
      appLocation: 'string'
    }
    repositoryToken: 'string'
    repositoryUrl: 'string'
  }
  sku: {
    capabilities: [
      {
        name: 'string'
        reason: 'string'
        value: 'string'
      }
    ]
    capacity: int
    family: 'string'
    locations: [
      'string'
    ]
    name: 'string'
    size: 'string'
    skuCapacity: {
      default: int
      maximum: int
      minimum: int
      scaleType: 'string'
    }
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Property values

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

Microsoft.Web/staticSites

Name Description Value
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties StaticSite
sku Description of a SKU for a scalable resource. SkuDescription
tags Resource tags Dictionary of tag names and values. See Tags in templates

ResourceTags

Name Description Value

SkuCapacity

Name Description Value
default Default number of 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

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 Min, max, and default scale values of the SKU. SkuCapacity
tier Service tier of the resource SKU. string

StaticSite

Name Description Value
branch The target branch in the repository. string
buildProperties Build properties to configure on the repository. 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

StaticSiteBuildProperties

Name Description Value
apiLocation The path to the api code within the repository. string
appArtifactLocation The path of the app artifacts after building. string
appLocation The path to the app code within the repository. string

ARM template resource definition

The staticSites resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

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

{
  "type": "Microsoft.Web/staticSites",
  "apiVersion": "2020-09-01",
  "name": "string",
  "kind": "string",
  "location": "string",
  "properties": {
    "branch": "string",
    "buildProperties": {
      "apiLocation": "string",
      "appArtifactLocation": "string",
      "appLocation": "string"
    },
    "repositoryToken": "string",
    "repositoryUrl": "string"
  },
  "sku": {
    "capabilities": [
      {
        "name": "string",
        "reason": "string",
        "value": "string"
      }
    ],
    "capacity": "int",
    "family": "string",
    "locations": [ "string" ],
    "name": "string",
    "size": "string",
    "skuCapacity": {
      "default": "int",
      "maximum": "int",
      "minimum": "int",
      "scaleType": "string"
    },
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Property values

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

Microsoft.Web/staticSites

Name Description Value
apiVersion The api version '2020-09-01'
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties StaticSite
sku Description of a SKU for a scalable resource. SkuDescription
tags Resource tags Dictionary of tag names and values. See Tags in templates
type The resource type 'Microsoft.Web/staticSites'

ResourceTags

Name Description Value

SkuCapacity

Name Description Value
default Default number of 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

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 Min, max, and default scale values of the SKU. SkuCapacity
tier Service tier of the resource SKU. string

StaticSite

Name Description Value
branch The target branch in the repository. string
buildProperties Build properties to configure on the repository. 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

StaticSiteBuildProperties

Name Description Value
apiLocation The path to the api code within the repository. string
appArtifactLocation The path of the app artifacts after building. string
appLocation The path to the app code within the repository. string

Terraform (AzAPI provider) resource definition

The staticSites resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/staticSites@2020-09-01"
  name = "string"
  kind = "string"
  location = "string"
  body = jsonencode({
    properties = {
      branch = "string"
      buildProperties = {
        apiLocation = "string"
        appArtifactLocation = "string"
        appLocation = "string"
      }
      repositoryToken = "string"
      repositoryUrl = "string"
    }
  })
  sku = {
    capabilities = [
      {
        name = "string"
        reason = "string"
        value = "string"
      }
    ]
    capacity = int
    family = "string"
    locations = [
      "string"
    ]
    name = "string"
    size = "string"
    skuCapacity = {
      default = int
      maximum = int
      minimum = int
      scaleType = "string"
    }
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
}

Property values

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

Microsoft.Web/staticSites

Name Description Value
kind Kind of resource. string
location Resource Location. string (required)
name The resource name string (required)
properties Core resource properties StaticSite
sku Description of a SKU for a scalable resource. SkuDescription
tags Resource tags Dictionary of tag names and values.
type The resource type "Microsoft.Web/staticSites@2020-09-01"

ResourceTags

Name Description Value

SkuCapacity

Name Description Value
default Default number of 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

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 Min, max, and default scale values of the SKU. SkuCapacity
tier Service tier of the resource SKU. string

StaticSite

Name Description Value
branch The target branch in the repository. string
buildProperties Build properties to configure on the repository. 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

StaticSiteBuildProperties

Name Description Value
apiLocation The path to the api code within the repository. string
appArtifactLocation The path of the app artifacts after building. string
appLocation The path to the app code within the repository. string