Compartir a través de


Plantilla Microsoft.ResourcesSpecs

Definición de recursos de Bicep

El tipo de recurso templateSpecs 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.

Comentarios

En lugar de usar una plantilla de ARM o un archivo de Bicep para definir la especificación de plantilla, se recomienda usar New-AzTemplateSpec en Azure PowerShell o az ts create en la CLI de Azure para crear la especificación de plantilla. Esos comandos convierten automáticamente plantillas vinculadas en artefactos conectados a la plantilla principal. Si se usa una plantilla de Resource Manager para crear la especificación de plantilla, las plantillas vinculadas se deben agregar manualmente como artefactos, lo que puede resultar complicado. Para obtener más información, consulte Inicio rápido: Create e implementación de la especificación de plantilla.

Formato de los recursos

Para crear un recurso Microsoft.Resources/templateSpecs, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Resources/templateSpecs@2022-02-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    description: 'string'
    displayName: 'string'
    metadata: any()
  }
}

Valores de propiedad

templateSpecs

Nombre Descripción Value
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos, guiones y paréntesis.
ubicación Ubicación de la especificación de plantilla. No se puede cambiar después de la creación de la especificación de plantilla. Debe ser una de las ubicaciones de Azure admitidas. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Propiedades de especificación de plantilla. TemplateSpecProperties

TemplateSpecProperties

Nombre Descripción Valor
description Descripción de la especificación de plantilla. string

Restricciones:
Longitud máxima = 4096
DisplayName Nombre para mostrar de la especificación de plantilla. string

Restricciones:
Longitud máxima = 64
metadata Metadatos de la especificación de plantilla. Los metadatos son un objeto abierto y normalmente es una colección de pares clave-valor. Para Bicep, puede usar la función any().

Definición de recursos de plantilla de ARM

El tipo de recurso templateSpecs 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.

Comentarios

En lugar de usar una plantilla de ARM o un archivo de Bicep para definir la especificación de plantilla, se recomienda usar New-AzTemplateSpec en Azure PowerShell o az ts create en la CLI de Azure para crear la especificación de plantilla. Esos comandos convierten automáticamente plantillas vinculadas en artefactos conectados a la plantilla principal. Si se usa una plantilla de Resource Manager para crear la especificación de plantilla, las plantillas vinculadas se deben agregar manualmente como artefactos, lo que puede resultar complicado. Para obtener más información, consulte Inicio rápido: Create e implementación de la especificación de plantilla.

Formato de los recursos

Para crear un recurso Microsoft.Resources/templateSpecs, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.Resources/templateSpecs",
  "apiVersion": "2022-02-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "description": "string",
    "displayName": "string",
    "metadata": {}
  }
}

Valores de propiedad

templateSpecs

Nombre Descripción Value
type Tipo de recurso "Microsoft.Resources/templateSpecs"
apiVersion La versión de la API de recursos '2022-02-01'
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos, guiones y paréntesis.
ubicación Ubicación de la especificación de plantilla. No se puede cambiar después de la creación de la especificación de plantilla. Debe ser una de las ubicaciones de Azure admitidas. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
properties Propiedades de especificación de plantilla. TemplateSpecProperties

TemplateSpecProperties

Nombre Descripción Valor
description Descripción de la especificación de plantilla. string

Restricciones:
Longitud máxima = 4096
DisplayName Nombre para mostrar de la especificación de plantilla. string

Restricciones:
Longitud máxima = 64
metadata Metadatos de la especificación de plantilla. Los metadatos son un objeto abierto y normalmente es una colección de pares clave-valor.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso templateSpecs 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.Resources/templateSpecs, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/templateSpecs@2022-02-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      description = "string"
      displayName = "string"
    }
  })
}

Valores de propiedad

templateSpecs

Nombre Descripción Value
type Tipo de recurso "Microsoft.Resources/templateSpecs@2022-02-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 1-90

Caracteres válidos:
Caracteres alfanuméricos, de subrayado, puntos, guiones y paréntesis.
ubicación Ubicación de la especificación de plantilla. No se puede cambiar después de la creación de la especificación de plantilla. Debe ser una de las ubicaciones de Azure admitidas. 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.
properties Propiedades de especificación de plantilla. TemplateSpecProperties

TemplateSpecProperties

Nombre Descripción Valor
description Descripción de la especificación de plantilla. string

Restricciones:
Longitud máxima = 4096
DisplayName Nombre para mostrar de la especificación de plantilla. string

Restricciones:
Longitud máxima = 64
metadata Metadatos de la especificación de plantilla. Los metadatos son un objeto abierto y normalmente es una colección de pares clave-valor.