Compartilhar via

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

Neste tutorial, você aprenderá a adicionar uma variável ao modelo do ARM (Azure Resource Manager). As variáveis simplificam seus modelos. Eles permitem que você escreva uma expressão uma vez e reutilize-a 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 isso 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 as 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
      }
    }
  ]
}

O nome da conta de armazenamento do Azure precisa ser exclusivo para continuar a criar facilmente o modelo do 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 uma variável

O exemplo a seguir mostra as alterações para adicionar uma variável ao modelo que cria um nome de conta de armazenamento exclusivo. Copie o arquivo inteiro e substitua o 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 , portanto, não a examinaremos.

Você também está familiarizado com a função resourceGroup . Nesse caso, você obtém a id propriedade em vez da location propriedade, conforme 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 que você passa determinam o valor retornado. Para este tutorial, você usará a 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 usa valores e os combina. Para essa variável, ela usa a cadeia de caracteres do parâmetro e da cadeia de caracteres da uniqueString função e as combina em uma cadeia de caracteres.

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 de uma extensa lista de recursos.

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

Implantar modelo

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

Se você ainda não criou o grupo de recursos, consulte Criar grupo de recursos. O exemplo pressupõe que você definiu a templateFile variável para 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

Observação

Se a implantação falhar, use a opção verbose para obter informações sobre os recursos que estão sendo criados. Use a opção debug para obter mais informações de depuração.

Verificar a implantação

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

  1. Entre no portal do 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 implantado é store, além de uma cadeia de caracteres aleatórios.

Limpar os recursos

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

Se você estiver parando agora, talvez queira excluir o grupo de recursos.

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

Próximas etapas

Neste tutorial, você adicionará 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.

Adicionar saídas

  • Last updated on