Partager via


Blueprints Microsoft.Blueprint

Définition de ressource Bicep

Le type de ressource blueprints est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans Bicep.

Le type de ressource blueprints peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Blueprint/blueprints, ajoutez le Bicep suivant à votre modèle.

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

Valeurs de propriétés

blueprints

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Ressource cible

Pour Bicep, définissez cette propriété sur le nom symbolique de la ressource pour appliquer la ressource d’extension.
properties Propriétés détaillées pour la définition de blueprint. BlueprintProperties (obligatoire)

BlueprintProperties

Nom Description Valeur
description Explication multiligne de cette ressource. string
displayName Une chaîne à une ligne explique cette ressource. string
parameters Paramètres requis par cette définition de blueprint. object
resourceGroups Espaces réservés de groupe de ressources définis par cette définition de blueprint. object
targetScope Étendue dans laquelle cette définition de blueprint peut être affectée. 'managementGroup'
'abonnement'
versions Versions publiées de cette définition de blueprint. Pour Bicep, vous pouvez utiliser la fonction any().

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Blueprints - Créer une définition de blueprint

Déployer sur Azure
Ce modèle crée une définition de blueprint Azure Blueprint. La définition du blueprint comprend un artefact d’affectation de stratégie et peut être modifiée, puis déployée dans des groupes d’administration ou des abonnements pour des environnements cohérents.

Définition de ressources de modèle ARM

Le type de ressource blueprints est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans les modèles ARM.

Le type de ressource blueprints peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Blueprint/blueprints, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriétés

blueprints

Nom Description Valeur
type Type de ressource « Microsoft.Blueprint/blueprints »
apiVersion Version de l’API de ressource « 2018-11-01-preview »
name Nom de la ressource chaîne (obligatoire)
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Ressource cible

Pour JSON, définissez la valeur sur le nom complet de la ressource à laquelle appliquer la ressource d’extension .
properties Propriétés détaillées pour la définition de blueprint. BlueprintProperties (obligatoire)

BlueprintProperties

Nom Description Valeur
description Expliquez cette ressource sur plusieurs lignes. string
displayName Une chaîne à une ligne explique cette ressource. string
parameters Paramètres requis par cette définition de blueprint. object
resourceGroups Espaces réservés de groupe de ressources définis par cette définition de blueprint. object
targetScope Étendue dans laquelle cette définition de blueprint peut être affectée. 'managementGroup'
'subscription'
versions Versions publiées de cette définition de blueprint.

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Blueprints - Créer une définition de blueprint

Déployer sur Azure
Ce modèle crée une définition de blueprint Azure Blueprint. La définition du blueprint inclut un artefact d’affectation de stratégie et peut être modifiée, puis déployée sur des groupes d’administration ou des abonnements pour des environnements cohérents.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource blueprints est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la parent_id propriété sur cette ressource pour définir l’étendue de cette ressource.

Le type de ressource blueprints peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources
  • Abonnements
  • Groupes d’administration

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Blueprint/blueprints, ajoutez le Terraform suivant à votre modèle.

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

Valeurs de propriétés

blueprints

Nom Description Valeur
type Type de ressource « Microsoft.Blueprint/blueprints@2018-11-01-preview »
name Nom de la ressource string (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. string (obligatoire)
properties Propriétés détaillées pour la définition de blueprint. BlueprintProperties (obligatoire)

BlueprintProperties

Nom Description Valeur
description Expliquez cette ressource sur plusieurs lignes. string
displayName Une chaîne à une ligne explique cette ressource. string
parameters Paramètres requis par cette définition de blueprint. object
resourceGroups Espaces réservés de groupe de ressources définis par cette définition de blueprint. object
targetScope Étendue dans laquelle cette définition de blueprint peut être affectée. « managementGroup »
"subscription"
versions Versions publiées de cette définition de blueprint.