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:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
- Abonnements : Siehe Befehle zur Abonnementbereitstellung
- Verwaltungsgruppen : Siehe Verwaltungsgruppenbereitstellungsbefehle
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 |
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:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
- Abonnements : Siehe Befehle zur Abonnementbereitstellung
- Verwaltungsgruppen : Siehe Verwaltungsgruppenbereitstellungsbefehle
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 |
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. |