Freigeben über


Microsoft.Blueprint-Blaupausen

Bicep-Ressourcendefinition

Der Blaupausenressourcentyp ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in Bicep.

Der Blaupausenressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Blueprint/blueprints-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

blueprints

Name Beschreibung Wert
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem bereich, der sich vom Bereitstellungsbereich unterscheidet. Zielressource

Legen Sie für Bicep diese Eigenschaft auf den symbolischen Namen der Ressource fest, um die Erweiterungsressource anzuwenden.
properties Detaillierte Eigenschaften für die Blaupausendefinition. BlueprintProperties (erforderlich)

BlueprintProperties

Name BESCHREIBUNG Wert
description Mehrzeilige Erläuterungen zu dieser Ressource. Zeichenfolge
displayName Eine einzeilige Zeichenfolge erklärt diese Ressource. Zeichenfolge
parameters Parameter, die für diese Blaupausendefinition erforderlich sind. Objekt (object)
resourceGroups Durch diese Blaupausendefinition definierte Ressourcengruppenplatzhalter. Objekt (object)
targetScope Der Bereich, in dem diese Blaupausendefinition zugewiesen werden kann. "managementGroup"
"Abonnement"
versions Veröffentlichte Versionen dieser Blaupausendefinition. Für Bicep können Sie die Funktion any() verwenden.

Schnellstartvorlagen

Mit den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Blaupausen: Erstellen einer neuen Blaupausendefinition

In Azure bereitstellen
Mit dieser Vorlage wird eine Azure Blueprint-Blaupausendefinition erstellt. Die Blaupausendefinition enthält ein Richtlinienzuweisungsartefakt und kann geändert und dann in Verwaltungsgruppen oder Abonnements für konsistente Umgebungen bereitgestellt werden.

Ressourcendefinition mit einer ARM-Vorlage

Der Blaupausenressourcentyp ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in ARM-Vorlagen.

Der Blaupausenressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Blueprint/blueprints-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.Blueprint/blueprints",
  "apiVersion": "2018-11-01-preview",
  "name": "string",
  "scope": "string",
  "properties": {
    "description": "string",
    "displayName": "string",
    "parameters": {},
    "resourceGroups": {},
    "targetScope": "string",
    "versions": {}
  }
}

Eigenschaftswerte

blueprints

Name Beschreibung Wert
type Ressourcentyp "Microsoft.Blueprint/Blueprints"
apiVersion Die Version der Ressourcen-API "2018-11-01-preview"
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem bereich, der sich vom Bereitstellungsbereich unterscheidet. Zielressource

Legen Sie für JSON den Wert auf den vollständigen Namen der Ressource fest, auf die die Erweiterungsressource angewendet werden soll.
properties Detaillierte Eigenschaften für die Blaupausendefinition. BlueprintProperties (erforderlich)

BlueprintProperties

Name Beschreibung Wert
description Mehrzeilige Erläuterungen zu dieser Ressource. Zeichenfolge
displayName Eine einzeilige Zeichenfolge erklärt diese Ressource. Zeichenfolge
parameters Parameter, die für diese Blaupausendefinition erforderlich sind. Objekt (object)
resourceGroups Durch diese Blaupausendefinition definierte Ressourcengruppenplatzhalter. Objekt (object)
targetScope Der Bereich, in dem diese Blaupausendefinition zugewiesen werden kann. "managementGroup"
"Abonnement"
versions Veröffentlichte Versionen dieser Blaupausendefinition.

Schnellstartvorlagen

Mit den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Blaupausen: Erstellen einer neuen Blaupausendefinition

Bereitstellen in Azure
Mit dieser Vorlage wird eine Azure Blueprint-Blaupausendefinition erstellt. Die Blaupausendefinition enthält ein Richtlinienzuweisungsartefakt und kann geändert und dann in Verwaltungsgruppen oder Abonnements für konsistente Umgebungen bereitgestellt werden.

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Blaupausenressourcentyp ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die parent_id -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen.

Der Blaupausenressourcentyp kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • Ressourcengruppen
  • Abonnements
  • Verwaltungsgruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Blueprint/blueprints-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

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"
    }
  })
}

Eigenschaftswerte

blueprints

Name Beschreibung Wert
type Ressourcentyp "Microsoft.Blueprint/blueprints@2018-11-01-preview"
name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
properties Detaillierte Eigenschaften für die Blaupausendefinition. BlueprintProperties (erforderlich)

BlueprintProperties

Name BESCHREIBUNG Wert
description Mehrzeilige Erläuterungen zu dieser Ressource. Zeichenfolge
displayName Eine einzeilige Zeichenfolge erklärt diese Ressource. Zeichenfolge
parameters Parameter, die für diese Blaupausendefinition erforderlich sind. Objekt (object)
resourceGroups Durch diese Blaupausendefinition definierte Ressourcengruppenplatzhalter. Objekt (object)
targetScope Der Bereich, in dem diese Blaupausendefinition zugewiesen werden kann. "managementGroup"
„subscription“
versions Veröffentlichte Versionen dieser Blaupausendefinition.