Compartilhar via


Blueprints do Microsoft.Blueprint

Definição de recurso do Bicep

O tipo de recurso blueprints é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão no Bicep.

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

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

Formato de recurso

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

resource symbolicname 'Microsoft.Blueprint/blueprints@2018-11-01-preview' = {
  name: 'string'
  scope: resourceSymbolicName
  properties: {
    description: 'string'
    displayName: 'string'
    parameters: {}
    resourceGroups: {}
    targetScope: 'string'
    versions: any()
  }
}

Valores de propriedade

blueprints

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Recurso de destino

Para o Bicep, defina essa propriedade como o nome simbólico do recurso para aplicar o recurso de extensão.
properties Propriedades detalhadas para definição de blueprint. BlueprintProperties (obrigatório)

BlueprintProperties

Nome Descrição Valor
descrição Várias linhas explicam esse recurso. string
displayName Uma cadeia de caracteres de linha explica esse recurso. string
parameters Parâmetros exigidos por essa definição de blueprint. objeto
resourceGroups Espaços reservados do grupo de recursos definidos por essa definição de blueprint. objeto
targetScope O escopo em que essa definição de blueprint pode ser atribuída. 'managementGroup'
'subscription'
versões Versões publicadas dessa definição de blueprint. Para o Bicep, você pode usar a função any().

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Blueprints – Criar uma nova definição de blueprint

Implantar no Azure
Este 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, em seguida, implantada em grupos de gerenciamento ou assinaturas para ambientes consistentes.

Definição de recurso de modelo do ARM

O tipo de recurso blueprints é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão em modelos do ARM.

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

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

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",
  "scope": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "parameters": {},
    "resourceGroups": {},
    "targetScope": "string",
    "versions": {}
  }
}

Valores de propriedade

blueprints

Nome Descrição Valor
type O tipo de recurso 'Microsoft.Blueprint/blueprints'
apiVersion A versão da API de recursos '2018-11-01-preview'
name O nome do recurso cadeia de caracteres (obrigatório)
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Recurso de destino

Para JSON, defina o valor como o nome completo do recurso ao qual aplicar o recurso de extensão .
properties Propriedades detalhadas para definição de blueprint. BlueprintProperties (obrigatório)

BlueprintProperties

Nome Descrição Valor
descrição Várias linhas explicam esse recurso. string
displayName A cadeia de caracteres de uma linha explica esse recurso. string
parameters Parâmetros exigidos por essa definição de blueprint. objeto
resourceGroups Espaços reservados do grupo de recursos definidos por essa definição de blueprint. objeto
targetScope O escopo em que essa definição de blueprint pode ser atribuída. 'managementGroup'
'subscription'
versões Versões publicadas dessa definição de blueprint.

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Blueprints – Criar uma nova definição de blueprint

Implantar no Azure
Este 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, em seguida, implantada em grupos de gerenciamento ou assinaturas para ambientes consistentes.

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

O tipo de recurso blueprints é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a parent_id propriedade nesse recurso para definir o escopo desse recurso.

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

  • Grupos de recursos
  • Assinaturas
  • Grupos de gerenciamento

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log 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 = jsonencode({
    properties = {
      description = "string"
      displayName = "string"
      parameters = {}
      resourceGroups = {}
      targetScope = "string"
    }
  })
}

Valores de propriedade

blueprints

Nome Descrição Valor
type O tipo de recurso "Microsoft.Blueprint/blueprints@2018-11-01-preview"
name 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)
properties Propriedades detalhadas para definição de blueprint. BlueprintProperties (obrigatório)

BlueprintProperties

Nome Descrição Valor
descrição Várias linhas explicam esse recurso. string
displayName A cadeia de caracteres de uma linha explica esse recurso. string
parameters Parâmetros exigidos por essa definição de blueprint. objeto
resourceGroups Espaços reservados do grupo de recursos definidos por essa definição de blueprint. objeto
targetScope O escopo em que essa definição de blueprint pode ser atribuída. "managementGroup"
"subscription"
versões Versões publicadas dessa definição de blueprint.