Tutorial: Adicionar um recurso ao modelo do Azure Resource Manager

No tutorial anterior, você aprendeu a criar e implantar seu primeiro modelo em branco do ARM (Azure Resource Manager). Agora, você está pronto para implantar um recurso real nesse modelo. Nesse caso, uma conta de armazenamento do Azure. Esta instrução leva 9 minutos para ser concluída.

Pré-requisitos

Recomendamos que você conclua o tutorial introdutório sobre modelos, 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.

Adicionar recurso

Para adicionar uma definição de conta de armazenamento do Azure ao modelo existente, examine o arquivo JSON no exemplo a seguir. Em vez de tentar copiar seções do modelo, copie o arquivo inteiro e substitua o modelo pelo conteúdo.

Substitua {provide-unique-name} e as chaves {} por um nome de conta de armazenamento exclusivo.

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

Adivinhar um nome exclusivo para uma conta de armazenamento não é fácil e não funciona bem para automatizar implantações grandes. Posteriormente nesta série de tutoriais, você usará recursos de modelo que facilitam a criação de um nome exclusivo.

Propriedades de recurso

Talvez você esteja se perguntando como encontrar as propriedades a serem usadas para cada tipo de recurso. Você pode usar a referência de modelo do ARM para localizar os tipos de recursos que deseja implantar.

Cada recurso implantado tem pelo menos as três propriedades a seguir:

• type: tipo do recurso. Esse valor é uma combinação do namespace do provedor de recursos e do tipo de recurso, como Microsoft.Storage/storageAccounts.
• apiVersion: versão da API REST a ser usada para criar o recurso. Cada provedor de recursos publica suas próprias versões de API, portanto, esse valor é específico para o tipo.
• name: nome do recurso.

A maioria dos recursos também tem uma location propriedade, que define a região em que você implanta o recurso.

As outras propriedades variam de acordo com o tipo de recurso e a versão da API. É importante entender a conexão entre a versão da API e as propriedades disponíveis, portanto, vamos entrar em mais detalhes.

Neste tutorial, você adicionará uma conta de armazenamento ao modelo. Você pode ver a versão da API da conta de armazenamento no storageAccounts 2021-09-01. Observe que você não adiciona todas as propriedades ao modelo. Muitas das propriedades são opcionais. O Microsoft.Storage provedor de recursos pode lançar uma nova versão da API, mas a versão que você está implantando não precisa ser alterada. Você pode continuar usando essa versão e saber que os resultados da implantação são consistentes.

Se você exibir uma versão de API mais antiga, poderá ver que um conjunto menor de propriedades está disponível.

Se você decidir alterar a versão da API para um recurso, avalie as propriedades dessa versão e ajuste o modelo adequadamente.

Implantar modelo

Você pode implantar o modelo para criar a conta de armazenamento. Dê à sua implementação um nome diferente para que você possa encontrá-la facilmente no histórico.

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

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

Esses erros são duas possíveis falhas de implantação que você pode encontrar:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} não é um nome de conta de armazenamento válido. O nome da conta de armazenamento precisa ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

  No modelo, substitua por {provide-unique-name} um nome de conta de armazenamento exclusivo. Consulte Adicionar recurso.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 já está em uso.

  No modelo, experimente um nome de conta de armazenamento diferente.

Essa implantação leva mais tempo do que sua implantação de modelo em branco porque você está criando uma conta de armazenamento. Pode levar cerca de um minuto.

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. Marque a caixa à esquerda de myResourceGroup e selecione myResourceGroup
4. Selecione o grupo de recursos no qual você implantou.
5. Você verá que uma conta de armazenamento foi implantada.
6. Observe que o rótulo de implantação agora diz: Implantações: 2 Bem-sucedido.

Limpar os recursos

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

Se estiver parando agora, o ideal será limpar os recursos implantados excluindo o grupo de recursos.

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

Próximas etapas

Você criou um modelo simples para implantar uma conta de armazenamento do Azure. Nos tutoriais posteriores, você aprenderá a adicionar parâmetros, variáveis, recursos e saídas a um modelo. Esses recursos são os blocos de construção para modelos muito mais complexos.