Tutoriel : Ajouter une ressource à votre modèle Azure Resource Manager

Dans le tutoriel précédent, vous avez appris à créer et déployer votre premier modèle Azure Resource Manager vide (modèle ARM). À présent, vous êtes prêt à déployer une ressource réelle sur ce modèle. Dans ce cas, un compte de stockage Azure. Cette instruction prend 9 minutes .

Prerequisites

Nous vous recommandons de suivre le didacticiel d’introduction sur les modèles, 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.

Ajouter une ressource

Pour ajouter une définition de compte de stockage Azure au modèle existant, examinez le fichier JSON dans l’exemple suivant. Au lieu d’essayer de copier des sections du modèle, copiez l’intégralité du fichier et remplacez votre modèle par son contenu.

Remplacez {provide-unique-name} et les accolades {} par un nom de compte de stockage unique.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Deviner un nom unique pour un compte de stockage n’est pas facile et ne fonctionne pas correctement pour automatiser les déploiements volumineux. Plus loin dans cette série de tutoriels, vous utilisez des fonctionnalités de modèle qui facilitent la création d’un nom unique.

Propriétés de la ressource

Vous vous demandez peut-être comment trouver les propriétés à utiliser pour chaque type de ressource. Vous pouvez utiliser la référence de modèle ARM pour rechercher les types de ressources que vous souhaitez déployer.

Chaque ressource que vous déployez possède au moins les trois propriétés suivantes :

• type: type de la ressource. Cette valeur est une combinaison de l’espace de noms du fournisseur de ressources et du type de ressource tel que Microsoft.Storage/storageAccounts.
• apiVersion: version de l’API REST à utiliser pour créer la ressource. Chaque fournisseur de ressources publie ses propres versions d’API. Cette valeur est donc spécifique au type.
• name: Nom de la ressource.

La plupart des ressources ont également une location propriété, qui définit la région où vous déployez la ressource.

Les autres propriétés varient selon le type de ressource et la version de l’API. Il est important de comprendre la connexion entre la version de l’API et les propriétés disponibles. Nous allons donc passer plus en détail.

Dans ce tutoriel, vous ajoutez un compte de stockage au modèle. Vous pouvez voir la version de l’API du compte de stockage sur storageAccounts 2021-09-01. Notez que vous n’ajoutez pas toutes les propriétés à votre modèle. La plupart des propriétés sont facultatives. Le Microsoft.Storage fournisseur de ressources peut publier une nouvelle version d’API, mais la version que vous déployez n’a pas à changer. Vous pouvez continuer à utiliser cette version et savoir que les résultats de votre déploiement sont cohérents.

Si vous affichez une ancienne version de l’API , vous pouvez voir qu’un plus petit ensemble de propriétés est disponible.

Si vous décidez de modifier la version de l’API pour une ressource, vérifiez que vous évaluez les propriétés de cette version et ajustez votre modèle de manière appropriée.

Déployer un modèle

Vous pouvez déployer le modèle pour créer le compte de stockage. Donnez à votre déploiement un autre nom pour pouvoir le trouver facilement dans l’historique.

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 addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Ces erreurs sont deux échecs de déploiement possibles que vous pouvez rencontrer :

• Error: Code=AccountNameInvalid; Message={provide-unique-name} n’est pas un nom de compte de stockage valide. Le nom du compte de stockage doit être compris entre 3 et 24 caractères et utiliser des chiffres et des lettres minuscules uniquement.

  Dans le modèle, remplacez {provide-unique-name} par un nom de compte de stockage unique. Voir Ajouter une ressource.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 est déjà pris.

  Dans le modèle, essayez un autre nom de compte de stockage.

Ce déploiement prend plus de temps que votre déploiement de modèle vide, car vous créez un compte de stockage. Ça peut prendre environ une minute.

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. Cochez la case à gauche de myResourceGroup et sélectionnez myResourceGroup
4. Sélectionnez le groupe de ressources sur lequel vous avez déployé.
5. Vous voyez qu’un compte de stockage a été déployé.
6. Notez que l’étiquette de déploiement indique maintenant : Déploiements : 2 Réussite.

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 pouvez nettoyer les ressources que vous avez déployées en supprimant le groupe de ressources.

1. Dans le portail Azure, sélectionnez Groupe de ressources dans le menu de gauche.
2. Tapez le nom du groupe de ressources dans la zone Filtrer pour n’importe quel champ...
3. Cochez la case en regard de myResourceGroup et sélectionnez myResourceGroup ou le nom du groupe de ressources que vous avez choisi.
4. Sélectionnez Supprimer le groupe de ressources dans le menu supérieur.

Étapes suivantes

Vous avez créé un modèle simple pour déployer un compte de stockage Azure. Dans les didacticiels ultérieurs, vous allez apprendre à ajouter des paramètres, des variables, des ressources et des sorties à un modèle. Ces fonctionnalités sont les blocs de construction des modèles beaucoup plus complexes.