Partager via

Tutoriel : Ajouter des variables à votre modèle Azure Resource Manager

Dans ce tutoriel, vous allez apprendre à ajouter une variable à votre modèle Azure Resource Manager (modèle ARM). Les variables simplifient vos modèles. Ils vous permettent d’écrire une expression une fois et de la réutiliser tout au long du modèle. Ce tutoriel prend 7 minutes .

Prerequisites

Nous vous recommandons de suivre le didacticiel sur les fonctions, mais il n’est pas nécessaire.

Vous devez disposer de Visual Studio Code et d’Azure PowerShell ou d’Azure CLI. Pour plus d’informations, consultez les outils de modèle.

Vérifier le modèle

À la fin du didacticiel précédent, votre modèle comportait le fichier JSON suivant :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Votre nom de compte de stockage Azure doit être unique pour continuer facilement à créer votre modèle ARM. Si vous avez terminé les didacticiels précédents de cette série, vous êtes fatigué de trouver un nom unique. Vous résolvez ce problème en ajoutant une variable qui crée un nom unique pour votre compte de stockage.

Utiliser une variable

L’exemple suivant montre les modifications permettant d’ajouter une variable à votre modèle qui crée un nom de compte de stockage unique. Copiez l’intégralité du fichier et remplacez votre modèle par son contenu :

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Notez qu’il inclut une variable nommée uniqueStorageName. Cette variable utilise quatre fonctions pour créer une valeur de chaîne.

Vous connaissez déjà la fonction de paramètres . Nous ne l’examinerons donc pas.

Vous êtes également familiarisé avec la fonction resourceGroup . Dans ce cas, vous obtenez la id propriété au lieu de la location propriété, comme indiqué dans le didacticiel précédent. La id propriété retourne l’identificateur complet du groupe de ressources, y compris l’ID d’abonnement et le nom du groupe de ressources.

La fonction uniqueString crée une valeur de hachage de 13 caractères. Les paramètres que vous passez déterminent la valeur retournée. Pour ce tutoriel, vous utilisez l’ID de groupe de ressources comme entrée pour la valeur de hachage. Cela signifie que vous pouvez déployer ce modèle sur différents groupes de ressources et obtenir une valeur de chaîne unique différente. Toutefois, si vous déployez sur le même groupe de ressources, vous obtenez la même valeur.

La fonction concat prend des valeurs et les combine. Pour cette variable, elle prend la chaîne du paramètre et la chaîne de la uniqueString fonction et les combine en une seule chaîne.

Le storagePrefix paramètre vous permet de transmettre un préfixe qui vous aide à identifier les comptes de stockage. Vous pouvez créer votre propre convention d’affectation de noms qui facilite l’identification des comptes de stockage après le déploiement à partir d’une liste complète de ressources.

Enfin, notez que le nom du compte de stockage est maintenant défini sur la variable au lieu d’un paramètre.

Déployer un modèle

Déployons le modèle. Le déploiement de ce modèle est plus facile que les modèles précédents, car vous fournissez simplement le préfixe du nom du compte de stockage.

Si vous n’avez pas créé le groupe de ressources, consultez Créer un groupe de ressources. L’exemple suppose que vous avez défini la templateFile variable sur le chemin d’accès au fichier de modèle, comme indiqué dans le premier tutoriel.

New-AzResourceGroupDeployment `
  -Name addnamevariable `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Note

Si le déploiement échoue, utilisez le verbose commutateur pour obtenir des informations sur les ressources en cours de création. Utilisez ce commutateur debug pour obtenir plus d'informations pour le débogage.

Vérifier le déploiement

Vous pouvez vérifier le déploiement en explorant le groupe de ressources à partir du portail Azure.

  1. Connectez-vous au portail Azure.
  2. Dans le menu de gauche, sélectionnez Groupes de ressources.
  3. Sélectionnez votre groupe de ressources.
  4. Notez que le nom de votre compte de stockage déployé est store, plus une chaîne de caractères aléatoires.

Nettoyer les ressources

Si vous passez au didacticiel suivant, vous n’avez pas besoin de supprimer le groupe de ressources.

Si vous arrêtez maintenant, vous souhaiterez peut-être supprimer le groupe de ressources.

  1. Dans le portail Azure, sélectionnez Groupes de ressources dans le menu de gauche.
  2. Tapez le nom du groupe de ressources dans le champ de texte filtre pour n’importe quel champ....
  3. Cochez la case en regard de myResourceGroup et sélectionnez myResourceGroup ou votre nom de groupe de ressources.
  4. Sélectionnez Supprimer le groupe de ressources dans le menu supérieur.

Étapes suivantes

Dans ce tutoriel, vous ajoutez une variable qui crée un nom de compte de stockage unique. Dans le tutoriel suivant, vous retournez une valeur à partir du compte de stockage déployé.

Ajouter des sorties

  • Last updated on