Tutorial: Adicionar um recurso ao seu modelo do Azure Resource Manager

No tutorial anterior, você aprendeu como criar e implantar seu primeiro modelo em branco do Azure Resource Manager (modelo ARM). 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 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.

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 chavetas {} 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 grandes implantações. Mais adiante nesta série de tutoriais, você usa recursos de modelo que facilitam a criação de um nome exclusivo.

Propriedades do recurso

Você pode estar se perguntando como encontrar as propriedades a serem usadas para cada tipo de recurso. Você pode usar a referência de modelo 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 onde 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, então vamos entrar em mais detalhes.

Neste tutorial, você adiciona uma conta de armazenamento ao modelo. Você pode ver a versão da API da conta de armazenamento em storageAccounts 2021-09-01. Observe que você não adiciona todas as propriedades ao seu 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 sua implantação são consistentes.

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

Se você decidir alterar a versão da API para um recurso, certifique-se de avaliar as propriedades dessa versão e ajustar seu modelo adequadamente.

Implementar o modelo

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

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 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 e usar apenas números e letras minúsculas.

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

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

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

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

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

Limpeza de recursos

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

Se você estiver parando agora, convém 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. Selecione Excluir grupo de recursos no menu superior.

Próximos passos

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.