Tutorial: Adicionar variáveis ao seu modelo do Azure Resource Manager

Neste tutorial, você aprenderá a adicionar uma variável ao seu modelo do Azure Resource Manager (modelo ARM). As variáveis simplificam seus modelos. Eles permitem que você escreva uma expressão uma vez e a reutilize em todo o modelo. Este tutorial leva 7 minutos para ser concluído.

Pré-requisitos

Recomendamos que você conclua o tutorial sobre funções, mas não é necessário.

Você precisa ter o Visual Studio Code e o Azure PowerShell ou a CLI do Azure. Para obter mais informações, consulte Ferramentas de modelo.

Modelo de revisão

No final do tutorial anterior, seu modelo tinha o seguinte arquivo JSON:

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

Seu nome de conta de armazenamento do Azure precisa ser exclusivo para continuar a criar facilmente seu modelo ARM. Se você concluiu os tutoriais anteriores desta série, está cansado de criar um nome exclusivo. Você resolve esse problema adicionando uma variável que cria um nome exclusivo para sua conta de armazenamento.

Usar variável

O exemplo a seguir mostra as alterações para adicionar uma variável ao seu modelo que cria um nome de conta de armazenamento exclusivo. Copie o arquivo inteiro e substitua seu modelo pelo conteúdo:

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

Observe que ele inclui uma variável chamada uniqueStorageName. Essa variável usa quatro funções para criar um valor de cadeia de caracteres.

Você já está familiarizado com a função de parâmetros , então não vamos examiná-la.

Você também está familiarizado com a função resourceGroup . Nesse caso, você obtém a id propriedade em vez da location propriedade, como mostrado no tutorial anterior. A id propriedade retorna o identificador completo do grupo de recursos, incluindo a ID da assinatura e o nome do grupo de recursos.

A função uniqueString cria um valor de hash de 13 caracteres. Os parâmetros passados determinam o valor retornado. Para este tutorial, use o ID do grupo de recursos como a entrada para o valor de hash. Isso significa que você pode implantar esse modelo em diferentes grupos de recursos e obter um valor de cadeia de caracteres exclusivo diferente. No entanto, você obterá o mesmo valor se implantar no mesmo grupo de recursos.

A função concat pega valores e os combina. Para esta variável, ele captura a string do parâmetro e a string da função uniqueString e as combina em uma única string.

O storagePrefix parâmetro permite que você passe um prefixo que ajuda a identificar contas de armazenamento. Você pode criar sua própria convenção de nomenclatura que facilita a identificação de contas de armazenamento após a implantação a partir de uma extensa lista de recursos.

Finalmente, observe que o nome da conta de armazenamento agora está definido como a variável em vez de um parâmetro.

Implementar o modelo

Vamos implantar o modelo. Implantar esse modelo é mais fácil do que os modelos anteriores porque você fornece apenas o prefixo para o nome da conta de armazenamento.

Se você não criou o grupo de recursos, consulte Criar grupo de recursos. O exemplo pressupõe que você tenha definido a templateFile variável como o caminho para o arquivo de modelo, conforme mostrado no primeiro tutorial.

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

az deployment group create \
  --name addnamevariable \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Verificar a implementação

Você pode verificar a implantação explorando o grupo de recursos no portal do Azure.

1. Inicie sessão no portal Azure.
2. No menu à esquerda, selecione Grupos de recursos.
3. Selecione o seu grupo de recursos.
4. Observe que o nome da conta de armazenamento implantada é armazenado, além de uma sequência de caracteres aleatórios.

Limpeza de recursos

Se você estiver passando para o próximo tutorial, não precisará excluir o grupo de recursos.

Se estiveres a parar agora, podes querer eliminar o grupo de recursos.

1. No portal do Azure, selecione Grupos de recursos no menu à esquerda.
2. Escreva o nome do grupo de recursos no campo Filtrar por qualquer campo... .
3. Marque a caixa ao lado de myResourceGroup e selecione myResourceGroup ou o nome do seu grupo de recursos.
4. Selecione Excluir grupo de recursos no menu superior.

Próximos passos

Neste tutorial, você adiciona uma variável que cria um nome de conta de armazenamento exclusivo. No próximo tutorial, você retorna um valor da conta de armazenamento implantada.