Share via

Microsoft.Web staticSites 2022-03-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso staticSites se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Web/staticSites, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Web/staticSites@2022-03-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
    }
    enterpriseGradeCdnStatus: 'string'
    provider: 'string'
    publicNetworkAccess: 'string'
    repositoryToken: 'string'
    repositoryUrl: 'string'
    stagingEnvironmentPolicy: 'string'
    templateProperties: {
      description: 'string'
      isPrivate: bool
      owner: 'string'
      repositoryName: 'string'
      templateRepositoryUrl: 'string'
    }
  }
}

Valores de propiedad

staticSites

Nombre Descripción Value
name El nombre del recurso string (obligatorio)
ubicación Ubicación del recurso. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku Descripción de una SKU para un recurso escalable. SkuDescription
kind Tipo de recurso. string
identidad Identidad de servicio administrada. ManagedServiceIdentity
properties Propiedades de recursos principales StaticSite

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} object

StaticSite

Nombre Descripción Valor
allowConfigFileUpdates false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true. bool
branch Rama de destino en el repositorio. string
buildProperties Cree propiedades para configurar en el repositorio. StaticSiteBuildProperties
enterpriseGradeCdnStatus Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática. 'Deshabilitado'
'Deshabilitar'
'Habilitado'
"Habilitar"
provider Proveedor que envió la última implementación al entorno principal del sitio estático. string
publicNetworkAccess Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía. string
repositoryToken Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API. string
repositoryUrl Dirección URL del repositorio del sitio estático. string
stagingEnvironmentPolicy Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática. 'Deshabilitado'
'Habilitado'
templateProperties Opciones de plantilla para generar un nuevo repositorio. StaticSiteTemplateOptions

StaticSiteBuildProperties

Nombre Descripción Valor
apiBuildCommand Comando personalizado que se va a ejecutar durante la implementación de la aplicación de API de Azure Functions. string
apiLocation Ruta de acceso al código de API dentro del repositorio. string
appArtifactLocation En desuso: la ruta de acceso de los artefactos de la aplicación después de la compilación (en desuso en favor de OutputLocation) string
appBuildCommand Comando personalizado que se ejecutará durante la implementación de la aplicación de contenido estático. string
appLocation Ruta de acceso al código de la aplicación dentro del repositorio. string
githubActionSecretNameOverride Invalidación del nombre del secreto de acción de GitHub. string
outputLocation Ruta de acceso de salida de la aplicación después de la compilación. string
skipGithubActionWorkflowGeneration Omita la generación del flujo de trabajo de acción de GitHub. bool

StaticSiteTemplateOptions

Nombre Descripción Valor
description Descripción del repositorio recién generado. string
isPrivate Indica si el repositorio recién generado es un repositorio privado. El valor predeterminado es false (es decir, público). bool
owner Propietario del repositorio recién generado. string
repositoryName Nombre del repositorio recién generado. string
templateRepositoryUrl Dirección URL del repositorio de plantillas. El repositorio recién generado se basará en este. string

SkuDescription

Nombre Descripción Valor
capabilities ¿Las funcionalidades de la SKU, por ejemplo, están habilitadas para Traffic Manager? Funcionalidad[]
capacity Número actual de instancias asignadas al recurso. int
family Código de familia de la SKU de recursos. string
locations Ubicaciones de la SKU. string[]
name Nombre de la SKU del recurso. string
tamaño Especificador de tamaño de la SKU de recursos. string
skuCapacity Valores de escala mínimo, máximo y predeterminado de la SKU. SkuCapacity
Nivel: Nivel de servicio de la SKU de recursos. string

Capacidad

Nombre Descripción Value
name Nombre de la funcionalidad de SKU. string
reason Motivo de la funcionalidad de SKU. string
value Valor de la funcionalidad de SKU. string

SkuCapacity

Nombre Descripción Valor
default Número predeterminado de trabajos para esta SKU de plan de App Service. int
elasticMaximum Número máximo de trabajos elásticos para esta SKU de plan de App Service. int
maximum Número máximo de trabajos para esta SKU de plan de App Service. int
minimum Número mínimo de trabajos para esta SKU de plan de App Service. int
scaleType Configuraciones de escala disponibles para un plan de App Service. string

Definición de recursos de plantilla de ARM

El tipo de recurso staticSites se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Web/staticSites, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Web/staticSites",
  "apiVersion": "2022-03-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"
    },
    "enterpriseGradeCdnStatus": "string",
    "provider": "string",
    "publicNetworkAccess": "string",
    "repositoryToken": "string",
    "repositoryUrl": "string",
    "stagingEnvironmentPolicy": "string",
    "templateProperties": {
      "description": "string",
      "isPrivate": "bool",
      "owner": "string",
      "repositoryName": "string",
      "templateRepositoryUrl": "string"
    }
  }
}

Valores de propiedad

staticSites

Nombre Descripción Value
type Tipo de recurso 'Microsoft.Web/staticSites'
apiVersion La versión de la API de recursos '2022-03-01'
name El nombre del recurso string (obligatorio)
ubicación Ubicación del recurso. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
sku Descripción de una SKU para un recurso escalable. SkuDescription
kind Tipo de recurso. string
identidad Identidad de servicio administrada. ManagedServiceIdentity
properties Propiedades de recursos principales StaticSite

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} object

StaticSite

Nombre Descripción Valor
allowConfigFileUpdates false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true. bool
branch Rama de destino en el repositorio. string
buildProperties Cree propiedades para configurar en el repositorio. StaticSiteBuildProperties
enterpriseGradeCdnStatus Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática. 'Deshabilitado'
'Deshabilitar'
'Habilitado'
"Habilitar"
provider Proveedor que envió la última implementación al entorno principal del sitio estático. string
publicNetworkAccess Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía. string
repositoryToken Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API. string
repositoryUrl Dirección URL del repositorio del sitio estático. string
stagingEnvironmentPolicy Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática. 'Deshabilitado'
'Habilitado'
templateProperties Opciones de plantilla para generar un nuevo repositorio. StaticSiteTemplateOptions

StaticSiteBuildProperties

Nombre Descripción Valor
apiBuildCommand Comando personalizado que se va a ejecutar durante la implementación de la aplicación de API de Azure Functions. string
apiLocation Ruta de acceso al código de API dentro del repositorio. string
appArtifactLocation En desuso: la ruta de acceso de los artefactos de la aplicación después de la compilación (en desuso en favor de OutputLocation) string
appBuildCommand Comando personalizado que se ejecutará durante la implementación de la aplicación de contenido estático. string
appLocation Ruta de acceso al código de la aplicación dentro del repositorio. string
githubActionSecretNameOverride Invalidación del nombre del secreto de acción de GitHub. string
outputLocation Ruta de acceso de salida de la aplicación después de la compilación. string
skipGithubActionWorkflowGeneration Omita la generación del flujo de trabajo de acción de GitHub. bool

StaticSiteTemplateOptions

Nombre Descripción Valor
description Descripción del repositorio recién generado. string
isPrivate Indica si el repositorio recién generado es un repositorio privado. El valor predeterminado es false (es decir, público). bool
owner Propietario del repositorio recién generado. string
repositoryName Nombre del repositorio recién generado. string
templateRepositoryUrl Dirección URL del repositorio de plantillas. El repositorio recién generado se basará en este. string

SkuDescription

Nombre Descripción Valor
capabilities ¿Las funcionalidades de la SKU, por ejemplo, están habilitadas para Traffic Manager? Funcionalidad[]
capacity Número actual de instancias asignadas al recurso. int
family Código de familia de la SKU de recursos. string
locations Ubicaciones de la SKU. string[]
name Nombre de la SKU del recurso. string
tamaño Especificador de tamaño de la SKU de recursos. string
skuCapacity Valores de escala mínimo, máximo y predeterminado de la SKU. SkuCapacity
Nivel: Nivel de servicio de la SKU de recursos. string

Capacidad

Nombre Descripción Value
name Nombre de la funcionalidad de SKU. string
reason Motivo de la funcionalidad de SKU. string
value Valor de la funcionalidad de SKU. string

SkuCapacity

Nombre Descripción Valor
default Número predeterminado de trabajos para esta SKU de plan de App Service. int
elasticMaximum Número máximo de trabajos elásticos para esta SKU de plan de App Service. int
maximum Número máximo de trabajos para esta SKU de plan de App Service. int
minimum Número mínimo de trabajos para esta SKU de plan de App Service. int
scaleType Configuraciones de escala disponibles para un plan de App Service. string

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso staticSites se puede implementar con operaciones destinadas a:

  • Grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.Web/staticSites, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Web/staticSites@2022-03-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    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"
    }
    kind = "string"
  })
}

Valores de propiedad

staticSites

Nombre Descripción Value
type Tipo de recurso "Microsoft.Web/staticSites@2022-03-01"
name El nombre del recurso string (obligatorio)
ubicación Ubicación del recurso. string (obligatorio)
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta.
sku Descripción de una SKU para un recurso escalable. SkuDescription
kind Tipo de recurso. string
identidad Identidad de servicio administrada. ManagedServiceIdentity
properties Propiedades de recursos principales StaticSite

ManagedServiceIdentity

Nombre Descripción Value
type Tipo de identidad de servicio administrada. "SystemAssigned"
"SystemAssigned, UserAssigned"
"UserAssigned"
identity_ids Lista de identidades asignadas por el usuario asociadas al recurso. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} Matriz de identificadores de identidad de usuario.

StaticSite

Nombre Descripción Value
allowConfigFileUpdates false si el archivo de configuración está bloqueado para esta aplicación web estática; de lo contrario, true. bool
branch Rama de destino en el repositorio. string
buildProperties Cree propiedades para configurar en el repositorio. StaticSiteBuildProperties
enterpriseGradeCdnStatus Estado que indica el estado de la red CDN de nivel empresarial que atiende el tráfico a la aplicación web estática. "Deshabilitado"
"Deshabilitar"
"Habilitado"
"Habilitación"
provider Proveedor que envió la última implementación al entorno principal del sitio estático. string
publicNetworkAccess Estado que indica si se permite o no el tráfico público para una aplicación web estática. Valores permitidos: 'Enabled', 'Disabled' o una cadena vacía. string
repositoryToken Token del repositorio de GitHub de un usuario. Se usa para configurar el archivo de flujo de trabajo de Acciones de Github y los secretos de API. string
repositoryUrl Dirección URL del repositorio del sitio estático. string
stagingEnvironmentPolicy Estado que indica si se permiten o no entornos de ensayo para una aplicación web estática. "Deshabilitado"
"Habilitado"
templateProperties Opciones de plantilla para generar un nuevo repositorio. StaticSiteTemplateOptions

StaticSiteBuildProperties

Nombre Descripción Valor
apiBuildCommand Comando personalizado que se va a ejecutar durante la implementación de la aplicación de API de Azure Functions. string
apiLocation Ruta de acceso al código de API dentro del repositorio. string
appArtifactLocation En desuso: la ruta de acceso de los artefactos de la aplicación después de la compilación (en desuso en favor de OutputLocation) string
appBuildCommand Comando personalizado que se ejecutará durante la implementación de la aplicación de contenido estático. string
appLocation Ruta de acceso al código de la aplicación dentro del repositorio. string
githubActionSecretNameOverride Invalidación del nombre del secreto de acción de GitHub. string
outputLocation Ruta de acceso de salida de la aplicación después de la compilación. string
skipGithubActionWorkflowGeneration Omita la generación del flujo de trabajo de acción de GitHub. bool

StaticSiteTemplateOptions

Nombre Descripción Value
description Descripción del repositorio recién generado. string
isPrivate Indica si el repositorio recién generado es un repositorio privado. El valor predeterminado es false (es decir, público). bool
owner Propietario del repositorio recién generado. string
repositoryName Nombre del repositorio recién generado. string
templateRepositoryUrl Dirección URL del repositorio de plantillas. El repositorio recién generado se basará en este. string

SkuDescription

Nombre Descripción Valor
capabilities ¿Las funcionalidades de la SKU, por ejemplo, están habilitadas para Traffic Manager? Funcionalidad[]
capacity Número actual de instancias asignadas al recurso. int
family Código de familia de la SKU de recursos. string
locations Ubicaciones de la SKU. string[]
name Nombre de la SKU del recurso. string
tamaño Especificador de tamaño de la SKU de recursos. string
skuCapacity Valores de escala mínimo, máximo y predeterminado de la SKU. SkuCapacity
Nivel: Nivel de servicio de la SKU de recursos. string

Capacidad

Nombre Descripción Value
name Nombre de la funcionalidad de SKU. string
reason Motivo de la funcionalidad de SKU. string
value Valor de la funcionalidad de SKU. string

SkuCapacity

Nombre Descripción Valor
default Número predeterminado de trabajos para esta SKU de plan de App Service. int
elasticMaximum Número máximo de trabajos elásticos para esta SKU de plan de App Service. int
maximum Número máximo de trabajos para esta SKU de plan de App Service. int
minimum Número mínimo de trabajos para esta SKU de plan de App Service. int
scaleType Configuraciones de escala disponibles para un plan de App Service. string