Blueprints do Microsoft.Blueprint

Definição de recurso do Bicep

O tipo de recurso blueprints pode ser implantado com operações direcionadas:

Locatário - Veja comandos de implantação de locatário Grupos* de gerenciamento - Veja comandos de implantação de grupo de gerenciamento* - Veja comandos de implantação por assinatura* - Veja comandos de implantação de grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Blueprint/blueprints, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Blueprint/blueprints@2018-11-01-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    description: 'string'
    displayName: 'string'
    parameters: {
      {customized property}: {
        allowedValues: [
          any(...)
        ]
        defaultValue: any(...)
        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'
    versions: any(...)
  }
}

Valores de propriedade

Microsoft.Blueprint/blueprints

Nome	Descrição	Valor
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades detalhadas para definição de blueprint.	BlueprintProperties (obrigatório)
escopo	Use ao criar um recurso em um escopo diferente do escopo de implantação.	Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

Propriedades do Blueprint

Nome	Descrição	Valor
descrição	Várias linhas explicam esse recurso.	corda Restrições: Comprimento máximo = 500
nome de exibição	Uma cadeia de caracteres de linha explica esse recurso.	corda Restrições: Comprimento máximo = 256
Parâmetros	Parâmetros exigidos por essa definição de blueprint.	SharedBlueprintPropertiesParameters
resourceGroups	Espaços reservados do grupo de recursos definidos por essa definição de blueprint.	SharedBlueprintPropertiesResourceGroups
targetScope	O escopo em que essa definição de blueprint pode ser atribuída.	'Grupo de gestão' 'assinatura'
Versões	Versões publicadas dessa definição de blueprint.	qualquer

Definição de parâmetro

Nome	Descrição	Valor
allowedValues	Matriz de valores permitidos para esse parâmetro.	qualquer
valor padrão	Valor padrão para esse parâmetro.	qualquer
metadados	Propriedades amigáveis para esse parâmetro.	ParameterDefinitionMetadata
tipo	Tipos de dados permitidos para parâmetros de modelo do Resource Manager.	'matriz' 'bool' 'int' 'objeto' 'secureObject' 'secureString' 'string' (obrigatório)

ParameterDefinitionMetadata

Nome	Descrição	Valor
descrição	Descrição desse parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 500
nome de exibição	DisplayName deste parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 256
tipo forte	StrongType para interface do usuário para renderizar experiência avançada durante a atribuição de blueprint. Tipos fortes com suporte são resourceType, principalId e localização.	corda Restrições: Comprimento máximo = 64

Definição de Grupo de Recursos

Nome	Descrição	Valor
depende	Artefatos que precisam ser implantados antes desse grupo de recursos.	cadeia de caracteres[]
local	Local deste resourceGroup. Deixe vazio se o local do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
metadados	Propriedades amigáveis para esse grupo de recursos.	ParameterDefinitionMetadata
nome	Nome desse resourceGroup. Deixe vazio se o nome do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
Tags	Marcas a serem atribuídas a esse grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nome	Descrição	Valor

SharedBlueprintPropertiesParameters

Nome	Descrição	Valor

SharedBlueprintPropertiesResourceGroups

Nome	Descrição	Valor

Definição de recurso de modelo do ARM

O tipo de recurso blueprints pode ser implantado com operações direcionadas:

Locatário - Veja comandos de implantação de tenant Grupos* de gerenciamento - Veja comandos de implantação de grupo de gerenciamento* - Veja comandos de implantação por assinatura* - Veja comandos de implantação de grupos de recursos Para uma lista de propriedades alteradas em cada versão da API, veja registro de alterações.

Exemplos de uso

Modelos de Início Rápido do Azure

Os modelos de Início Rápido do Azure a seguir implantar esse tipo de recurso.

Modelo	Descrição
Blueprints – Criar uma nova definição de blueprint	Esse modelo cria uma definição de blueprint do Azure Blueprint. A definição de blueprint inclui um artefato de atribuição de política e pode ser modificada e implantada em grupos de gerenciamento ou assinaturas para ambientes consistentes.

Formato de recurso

Para criar um recurso Microsoft.Blueprint/blueprints, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.Blueprint/blueprints",
  "apiVersion": "2018-11-01-preview",
  "name": "string",
  "properties": {
    "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",
    "versions": {}
  }
}

Valores de propriedade

Microsoft.Blueprint/blueprints

Nome	Descrição	Valor
apiVersion	A versão da API	'2018-11-01-preview'
nome	O nome do recurso	cadeia de caracteres (obrigatório)
Propriedades	Propriedades detalhadas para definição de blueprint.	BlueprintProperties (obrigatório)
tipo	O tipo de recurso	'Microsoft.Blueprint/blueprints'

Propriedades do Blueprint

Nome	Descrição	Valor
descrição	Várias linhas explicam esse recurso.	corda Restrições: Comprimento máximo = 500
nome de exibição	Uma cadeia de caracteres de linha explica esse recurso.	corda Restrições: Comprimento máximo = 256
Parâmetros	Parâmetros exigidos por essa definição de blueprint.	SharedBlueprintPropertiesParameters
resourceGroups	Espaços reservados do grupo de recursos definidos por essa definição de blueprint.	SharedBlueprintPropertiesResourceGroups
targetScope	O escopo em que essa definição de blueprint pode ser atribuída.	'Grupo de gestão' 'assinatura'
Versões	Versões publicadas dessa definição de blueprint.	qualquer

Definição de parâmetro

Nome	Descrição	Valor
allowedValues	Matriz de valores permitidos para esse parâmetro.	qualquer
valor padrão	Valor padrão para esse parâmetro.	qualquer
metadados	Propriedades amigáveis para esse parâmetro.	ParameterDefinitionMetadata
tipo	Tipos de dados permitidos para parâmetros de modelo do Resource Manager.	'matriz' 'bool' 'int' 'objeto' 'secureObject' 'secureString' 'string' (obrigatório)

ParameterDefinitionMetadata

Nome	Descrição	Valor
descrição	Descrição desse parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 500
nome de exibição	DisplayName deste parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 256
tipo forte	StrongType para interface do usuário para renderizar experiência avançada durante a atribuição de blueprint. Tipos fortes com suporte são resourceType, principalId e localização.	corda Restrições: Comprimento máximo = 64

Definição de Grupo de Recursos

Nome	Descrição	Valor
depende	Artefatos que precisam ser implantados antes desse grupo de recursos.	cadeia de caracteres[]
local	Local deste resourceGroup. Deixe vazio se o local do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
metadados	Propriedades amigáveis para esse grupo de recursos.	ParameterDefinitionMetadata
nome	Nome desse resourceGroup. Deixe vazio se o nome do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
Tags	Marcas a serem atribuídas a esse grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nome	Descrição	Valor

SharedBlueprintPropertiesParameters

Nome	Descrição	Valor

SharedBlueprintPropertiesResourceGroups

Nome	Descrição	Valor

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso blueprints pode ser implantado com operações direcionadas:

Inquilino* Grupos * Assinatura* Grupos de recursos Para uma lista das propriedades alteradas em cada versão da API, veja o registro de alterações.

Formato de recurso

Para criar um recurso Microsoft.Blueprint/blueprints, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Blueprint/blueprints@2018-11-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      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"
      versions = ?
    }
  }
}

Valores de propriedade

Microsoft.Blueprint/blueprints

Nome	Descrição	Valor
nome	O nome do recurso	cadeia de caracteres (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	cadeia de caracteres (obrigatório)
Propriedades	Propriedades detalhadas para definição de blueprint.	BlueprintProperties (obrigatório)
tipo	O tipo de recurso	"Microsoft.Blueprint/blueprints@2018-11-01-preview"

Propriedades do Blueprint

Nome	Descrição	Valor
descrição	Várias linhas explicam esse recurso.	corda Restrições: Comprimento máximo = 500
nome de exibição	Uma cadeia de caracteres de linha explica esse recurso.	corda Restrições: Comprimento máximo = 256
Parâmetros	Parâmetros exigidos por essa definição de blueprint.	SharedBlueprintPropertiesParameters
resourceGroups	Espaços reservados do grupo de recursos definidos por essa definição de blueprint.	SharedBlueprintPropertiesResourceGroups
targetScope	O escopo em que essa definição de blueprint pode ser atribuída.	'Grupo de gestão' 'assinatura'
Versões	Versões publicadas dessa definição de blueprint.	qualquer

Definição de parâmetro

Nome	Descrição	Valor
allowedValues	Matriz de valores permitidos para esse parâmetro.	qualquer
valor padrão	Valor padrão para esse parâmetro.	qualquer
metadados	Propriedades amigáveis para esse parâmetro.	ParameterDefinitionMetadata
tipo	Tipos de dados permitidos para parâmetros de modelo do Resource Manager.	'matriz' 'bool' 'int' 'objeto' 'secureObject' 'secureString' 'string' (obrigatório)

ParameterDefinitionMetadata

Nome	Descrição	Valor
descrição	Descrição desse parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 500
nome de exibição	DisplayName deste parâmetro/resourceGroup.	corda Restrições: Comprimento máximo = 256
tipo forte	StrongType para interface do usuário para renderizar experiência avançada durante a atribuição de blueprint. Tipos fortes com suporte são resourceType, principalId e localização.	corda Restrições: Comprimento máximo = 64

Definição de Grupo de Recursos

Nome	Descrição	Valor
depende	Artefatos que precisam ser implantados antes desse grupo de recursos.	cadeia de caracteres[]
local	Local deste resourceGroup. Deixe vazio se o local do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
metadados	Propriedades amigáveis para esse grupo de recursos.	ParameterDefinitionMetadata
nome	Nome desse resourceGroup. Deixe vazio se o nome do grupo de recursos for especificado durante a atribuição de blueprint.	cadeia
Tags	Marcas a serem atribuídas a esse grupo de recursos.	ResourceGroupDefinitionTags

ResourceGroupDefinitionTags

Nome	Descrição	Valor

SharedBlueprintPropertiesParameters

Nome	Descrição	Valor

SharedBlueprintPropertiesResourceGroups

Nome	Descrição	Valor

Comentários

Esta página foi útil?

Last updated on 2026-01-21

Blueprints do Microsoft.Blueprint

Definição de recurso do Bicep

Formato de recurso

Valores de propriedade

Microsoft.Blueprint/blueprints

Propriedades do Blueprint

Definição de parâmetro

ParameterDefinitionMetadata

Definição de Grupo de Recursos

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Definição de recurso de modelo do ARM

Exemplos de uso

Modelos de Início Rápido do Azure

Formato de recurso

Valores de propriedade

Microsoft.Blueprint/blueprints

Propriedades do Blueprint

Definição de parâmetro

ParameterDefinitionMetadata

Definição de Grupo de Recursos

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Definição de recurso do Terraform (provedor de AzAPI)

Formato de recurso

Valores de propriedade

Microsoft.Blueprint/blueprints

Propriedades do Blueprint

Definição de parâmetro

ParameterDefinitionMetadata

Definição de Grupo de Recursos

ResourceGroupDefinitionTags

SharedBlueprintPropertiesParameters

SharedBlueprintPropertiesResourceGroups

Comentários

Recursos adicionais