Planos técnicos y versiones de Microsoft.Blueprint

Artículo
12/20/2024

Definición de recursos de Bicep

El tipo de recurso blueprints/versions se puede implementar con operaciones que tienen como destino:

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

Formato de recurso

Para crear un recurso Microsoft.Blueprint/blueprints/versions, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.Blueprint/blueprints/versions@2018-11-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    blueprintName: 'string'
    changeNotes: 'string'
    description: 'string'
    displayName: 'string'
    parameters: {
      {customized property}: {
        allowedValues: [
          any(Azure.Bicep.Types.Concrete.AnyType)
        ]
        defaultValue: any(Azure.Bicep.Types.Concrete.AnyType)
        metadata: {
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        type: 'string'
      }
    }
    resourceGroups: {
      {customized property}: {
        dependsOn: [
          'string'
        ]
        location: 'string'
        metadata: {
          description: 'string'
          displayName: 'string'
          strongType: 'string'
        }
        name: 'string'
        tags: {
          {customized property}: 'string'
        }
      }
    }
    targetScope: 'string'
  }
}

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

Nombre	Descripción	Valor
nombre	El nombre del recurso	string (obligatorio)
padre	En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para obtener más información, consulte recurso secundario fuera del recurso primario.	Nombre simbólico del recurso de tipo: planos técnicos
Propiedades	Propiedades detalladas del plano técnico publicado.	PublishedBlueprintProperties (obligatorio)

ParameterDefinition

Nombre	Descripción	Valor
allowedValues	Matriz de valores permitidos para este parámetro.	any[]
defaultValue	Valor predeterminado para este parámetro.	cualquier
metadatos	Propiedades fáciles de usar para este parámetro.	ParameterDefinitionMetadata
tipo	Tipos de datos permitidos para los parámetros de plantilla de Resource Manager.	'array' 'bool' 'int' 'object' 'secureObject' "secureString" 'string' (obligatorio)

ParameterDefinitionMetadata

Nombre	Descripción	Valor
descripción	Descripción de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 500
displayName	DisplayName de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 256
strongType	StrongType para que la interfaz de usuario represente una experiencia enriquecida durante la asignación del plano técnico. Los tipos seguros admitidos son resourceType, principalId y location.	cuerda Restricciones: Longitud máxima = 64

PublishedBlueprintProperties

Nombre	Descripción	Valor
blueprintName	Nombre de la definición del plano técnico publicado.	cuerda
changeNotes	Notas de cambio específicas de la versión.	cuerda Restricciones: Longitud máxima = 500
descripción	En varias líneas se explica este recurso.	cuerda Restricciones: Longitud máxima = 500
displayName	Una cadena de línea explica este recurso.	cuerda Restricciones: Longitud máxima = 256
Parámetros	Parámetros requeridos por esta definición de plano técnico.	sharedBlueprintPropertiesParameters
resourceGroups	Marcadores de posición del grupo de recursos definidos por esta definición de plano técnico.	SharedBlueprintPropertiesResourceGroups
targetScope	Ámbito en el que se puede asignar esta definición de plano técnico.	'managementGroup' 'subscription'

ResourceGroupDefinition

Nombre	Descripción	Valor
dependsOn	Artefactos que deben implementarse antes de este grupo de recursos.	string[]
ubicación	Ubicación de este resourceGroup. Deje vacío si la ubicación del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
metadatos	Propiedades fáciles de usar para este grupo de recursos.	ParameterDefinitionMetadata
nombre	Nombre de este resourceGroup. Deje vacío si el nombre del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
Etiquetas	Etiquetas que se asignarán a este grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nombre	Descripción	Valor

SharedBlueprintPropertiesParameters

Nombre	Descripción	Valor

SharedBlueprintPropertiesResourceGroups

Nombre	Descripción	Valor

Definición de recursos de plantilla de ARM

El tipo de recurso blueprints/versions se puede implementar con operaciones que tienen como destino:

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

Formato de recurso

Para crear un recurso Microsoft.Blueprint/blueprints/versions, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Blueprint/blueprints/versions",
  "apiVersion": "2018-11-01-preview",
  "name": "string",
  "properties": {
    "blueprintName": "string",
    "changeNotes": "string",
    "description": "string",
    "displayName": "string",
    "parameters": {
      "{customized property}": {
        "allowedValues": [ {} ],
        "defaultValue": {},
        "metadata": {
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "type": "string"
      }
    },
    "resourceGroups": {
      "{customized property}": {
        "dependsOn": [ "string" ],
        "location": "string",
        "metadata": {
          "description": "string",
          "displayName": "string",
          "strongType": "string"
        },
        "name": "string",
        "tags": {
          "{customized property}": "string"
        }
      }
    },
    "targetScope": "string"
  }
}

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

Nombre	Descripción	Valor
apiVersion	La versión de api	'2018-11-01-preview'
nombre	El nombre del recurso	string (obligatorio)
Propiedades	Propiedades detalladas del plano técnico publicado.	PublishedBlueprintProperties (obligatorio)
tipo	El tipo de recurso	"Microsoft.Blueprint/blueprints/versions"

ParameterDefinition

Nombre	Descripción	Valor
allowedValues	Matriz de valores permitidos para este parámetro.	any[]
defaultValue	Valor predeterminado para este parámetro.	cualquier
metadatos	Propiedades fáciles de usar para este parámetro.	ParameterDefinitionMetadata
tipo	Tipos de datos permitidos para los parámetros de plantilla de Resource Manager.	'array' 'bool' 'int' 'object' 'secureObject' "secureString" 'string' (obligatorio)

ParameterDefinitionMetadata

Nombre	Descripción	Valor
descripción	Descripción de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 500
displayName	DisplayName de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 256
strongType	StrongType para que la interfaz de usuario represente una experiencia enriquecida durante la asignación del plano técnico. Los tipos seguros admitidos son resourceType, principalId y location.	cuerda Restricciones: Longitud máxima = 64

PublishedBlueprintProperties

Nombre	Descripción	Valor
blueprintName	Nombre de la definición del plano técnico publicado.	cuerda
changeNotes	Notas de cambio específicas de la versión.	cuerda Restricciones: Longitud máxima = 500
descripción	En varias líneas se explica este recurso.	cuerda Restricciones: Longitud máxima = 500
displayName	Una cadena de línea explica este recurso.	cuerda Restricciones: Longitud máxima = 256
Parámetros	Parámetros requeridos por esta definición de plano técnico.	sharedBlueprintPropertiesParameters
resourceGroups	Marcadores de posición del grupo de recursos definidos por esta definición de plano técnico.	SharedBlueprintPropertiesResourceGroups
targetScope	Ámbito en el que se puede asignar esta definición de plano técnico.	'managementGroup' 'subscription'

ResourceGroupDefinition

Nombre	Descripción	Valor
dependsOn	Artefactos que deben implementarse antes de este grupo de recursos.	string[]
ubicación	Ubicación de este resourceGroup. Deje vacío si la ubicación del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
metadatos	Propiedades fáciles de usar para este grupo de recursos.	ParameterDefinitionMetadata
nombre	Nombre de este resourceGroup. Deje vacío si el nombre del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
Etiquetas	Etiquetas que se asignarán a este grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nombre	Descripción	Valor

SharedBlueprintPropertiesParameters

Nombre	Descripción	Valor

SharedBlueprintPropertiesResourceGroups

Nombre	Descripción	Valor

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso blueprints/versions se puede implementar con operaciones que tienen como destino:

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

Formato de recurso

Para crear un recurso Microsoft.Blueprint/blueprints/versions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Blueprint/blueprints/versions@2018-11-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      blueprintName = "string"
      changeNotes = "string"
      description = "string"
      displayName = "string"
      parameters = {
        {customized property} = {
          allowedValues = [
            ?
          ]
          defaultValue = ?
          metadata = {
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          type = "string"
        }
      }
      resourceGroups = {
        {customized property} = {
          dependsOn = [
            "string"
          ]
          location = "string"
          metadata = {
            description = "string"
            displayName = "string"
            strongType = "string"
          }
          name = "string"
          tags = {
            {customized property} = "string"
          }
        }
      }
      targetScope = "string"
    }
  })
}

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

Nombre	Descripción	Valor
nombre	El nombre del recurso	string (obligatorio)
parent_id	Identificador del recurso que es el elemento primario de este recurso.	Identificador del recurso de tipo: planos técnicos
Propiedades	Propiedades detalladas del plano técnico publicado.	PublishedBlueprintProperties (obligatorio)
tipo	El tipo de recurso	"Microsoft.Blueprint/blueprints/versions@2018-11-01-preview"

ParameterDefinition

Nombre	Descripción	Valor
allowedValues	Matriz de valores permitidos para este parámetro.	any[]
defaultValue	Valor predeterminado para este parámetro.	cualquier
metadatos	Propiedades fáciles de usar para este parámetro.	ParameterDefinitionMetadata
tipo	Tipos de datos permitidos para los parámetros de plantilla de Resource Manager.	'array' 'bool' 'int' 'object' 'secureObject' "secureString" 'string' (obligatorio)

ParameterDefinitionMetadata

Nombre	Descripción	Valor
descripción	Descripción de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 500
displayName	DisplayName de este parámetro o resourceGroup.	cuerda Restricciones: Longitud máxima = 256
strongType	StrongType para que la interfaz de usuario represente una experiencia enriquecida durante la asignación del plano técnico. Los tipos seguros admitidos son resourceType, principalId y location.	cuerda Restricciones: Longitud máxima = 64

PublishedBlueprintProperties

Nombre	Descripción	Valor
blueprintName	Nombre de la definición del plano técnico publicado.	cuerda
changeNotes	Notas de cambio específicas de la versión.	cuerda Restricciones: Longitud máxima = 500
descripción	En varias líneas se explica este recurso.	cuerda Restricciones: Longitud máxima = 500
displayName	Una cadena de línea explica este recurso.	cuerda Restricciones: Longitud máxima = 256
Parámetros	Parámetros requeridos por esta definición de plano técnico.	sharedBlueprintPropertiesParameters
resourceGroups	Marcadores de posición del grupo de recursos definidos por esta definición de plano técnico.	SharedBlueprintPropertiesResourceGroups
targetScope	Ámbito en el que se puede asignar esta definición de plano técnico.	'managementGroup' 'subscription'

ResourceGroupDefinition

Nombre	Descripción	Valor
dependsOn	Artefactos que deben implementarse antes de este grupo de recursos.	string[]
ubicación	Ubicación de este resourceGroup. Deje vacío si la ubicación del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
metadatos	Propiedades fáciles de usar para este grupo de recursos.	ParameterDefinitionMetadata
nombre	Nombre de este resourceGroup. Deje vacío si el nombre del grupo de recursos se especificará durante la asignación del plano técnico.	cuerda
Etiquetas	Etiquetas que se asignarán a este grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nombre	Descripción	Valor

SharedBlueprintPropertiesParameters

Nombre	Descripción	Valor

SharedBlueprintPropertiesResourceGroups

Nombre	Descripción	Valor

Compartir a través de

Planos técnicos y versiones de Microsoft.Blueprint

Definición de recursos de Bicep

Formato de recurso

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

ParameterDefinition

ParameterDefinitionMetadata

PublishedBlueprintProperties

ResourceGroupDefinition

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Definición de recursos de plantilla de ARM

Formato de recurso

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

ParameterDefinition

ParameterDefinitionMetadata

PublishedBlueprintProperties

ResourceGroupDefinition

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Valores de propiedad

Microsoft.Blueprint/blueprints/versions

ParameterDefinition

ParameterDefinitionMetadata

PublishedBlueprintProperties

ResourceGroupDefinition

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Comentarios

Recursos adicionales