Partager via

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

Dans ce tutoriel, vous allez apprendre à ajouter des fonctions de modèle à votre modèle Azure Resource Manager (modèle ARM). Vous utilisez des fonctions pour construire dynamiquement des valeurs. Outre ces fonctions de modèle fournies par le système, vous pouvez également créer des fonctions définies par l’utilisateur. Ce tutoriel prend 7 minutes .

Prerequisites

Nous vous recommandons de suivre le didacticiel sur les paramètres, 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"
      ]
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "eastus",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Supposons que vous avez codé en dur l’emplacement du compte de stockage Azure vers eastus, mais que vous devez le déployer dans une autre région. Vous devez ajouter un paramètre pour ajouter une flexibilité à votre modèle et lui permettre d’avoir un autre emplacement.

Utiliser la fonction

Si vous avez terminé le didacticiel des paramètres, vous avez utilisé une fonction. Lorsque vous avez ajouté "[parameters('storageName')]", vous avez utilisé la fonction de paramètres . Les crochets indiquent que la syntaxe à l’intérieur des crochets est une expression de modèle. Resource Manager résout la syntaxe au lieu de la traiter comme une valeur littérale.

Les fonctions ajoutent de la flexibilité à votre modèle en obtenant dynamiquement des valeurs pendant le déploiement. Dans ce tutoriel, vous utilisez une fonction pour obtenir l’emplacement de déploiement du groupe de ressources.

L’exemple suivant met en évidence les modifications pour ajouter un paramètre appelé location. La valeur par défaut du paramètre appelle la fonction resourceGroup . Cette fonction retourne un objet avec des informations sur le groupe de ressources déployé. L’une des propriétés de l’objet est une propriété d’emplacement. Lorsque vous utilisez la valeur par défaut, le compte de stockage et le groupe de ressources ont le même emplacement. Les ressources à l’intérieur d’un groupe ont des emplacements différents.

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": {
    "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
      }
    }
  ]
}

Déployer un modèle

Dans les didacticiels précédents, vous avez créé un compte de stockage dans la région USA Est, mais votre groupe de ressources est créé dans la région USA Centre. Pour ce tutoriel, vous créez un compte de stockage dans la même région que le groupe de ressources. Utilisez la valeur par défaut pour l’emplacement. Vous n’avez donc pas besoin de fournir cette valeur de paramètre. Vous devez fournir un nouveau nom pour le compte de stockage, car vous créez un compte de stockage dans un autre emplacement. Utilisez store2, par exemple, comme préfixe au lieu de store1.

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 addlocationparameter `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storageName "{new-unique-name}"

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. Cochez la case à gauche de myResourceGroup et sélectionnez myResourceGroup.
  4. Sélectionnez le groupe de ressources que vous avez créé. Le nom par défaut est myResourceGroup.
  5. Notez que votre compte de stockage déployé et votre groupe de ressources ont le même emplacement.

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 utilisez une fonction pour définir la valeur par défaut d’un paramètre. Dans cette série de tutoriels, vous continuez à utiliser des fonctions. À la fin de la série, vous ajoutez des fonctions à chaque section de modèle.

Ajouter des variables

  • Last updated on