Compartilhar via


Início Rápido: criar modelos do ARM com o Visual Studio Code

Neste Início Rápido, você usará o Visual Studio Code para criar modelos do ARM (Azure Resource Manager). Para obter um tutorial mais focado na sintaxe, confira Tutorial: criar e implementar seu primeiro modelo do ARM.

Importante

A extensão ferramentas do ARM (Azure Resource Manager) para Visual Studio Code foi preterida e não terá mais suporte após 1º de outubro de 2025. Para o desenvolvimento do Bicep, recomendamos usar a extensão Bicep para Visual Studio Code. Para saber mais, consulte Início Rápido: criar arquivos Bicep com o Visual Studio Code. Observe que métodos de "instalação transitória", como os Codespaces do GitHub, continuarão funcionando mesmo após a substituição. Para instalar manualmente a extensão, você pode obtê-la aqui."

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Para concluir este início rápido, você precisa do Visual Studio Code. Você também precisa da CLI do Azure ou do módulo do Azure PowerShell instalado e autenticado.

Criar um modelo do Resource Manager

Crie e abra com um novo arquivo chamado azuredeploy.json com o Visual Studio Code.

Adicione o seguinte snippet JSON ao arquivo para estruturar um modelo do ARM:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "functions": [],
  "variables": {},
  "resources": [],
  "outputs": {}
}

O modelo tem as seguintes seções: parameters, , functions, variables, resourcese outputs. Cada seção está vazia no momento.

Adicionar um recurso do Azure

Atualize a seção de recursos com o snippet a seguir para incluir uma conta de armazenamento.

"resources": [{
  "name": "storageaccount1",
  "type": "Microsoft.Storage/storageAccounts",
  "apiVersion": "2025-06-01",
  "tags": {
    "displayName": "storageaccount1"
  },
  "___location": "[resourceGroup().___location]",
  "kind": "StorageV2",
  "sku": {
    "name": "Premium_LRS",
    "tier": "Premium"
  }
}],

Use [ALT] + [SHIFT] + [F] para formatar o documento para melhor legibilidade.

Adicionar parâmetros do modelo

Atualize a seção de parâmetros para incluir um parâmetro para o nome da conta de armazenamento.

"parameters": {
  "storageAccountName": {
    "type": "string",
    "metadata": {
      "description": "Storage account name"
    },
    "defaultValue": "[format('storage{0}', uniqueString(resourceGroup().id))]"
  }
},

Os nomes das contas de armazenamento do Azure têm no mínimo três caracteres e no máximo 24. Adicione minLength e maxLength ao parâmetro e forneça os valores apropriados.

  "parameters": {
    "storageAccountName": {
      "type": "string",
      "metadata": {
        "description": "Storage account name"
      },
      "defaultValue": "[format('storage{0}', uniqueString(resourceGroup().id))]",
      "minLength": 3,
      "maxLength": 24
    }
  },

Agora, no recurso de armazenamento, atualize a propriedade nome para usar o parâmetro.

  "resources": [
    {
      "name": "[parameters('storageAccountName')]",
      "type": "Microsoft.Storage/storageAccounts",
      ...

Após a conclusão, seu modelo se parece com:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountName": {
      "type": "string",
      "metadata": {
        "description": "Storage account name"
      },
      "defaultValue": "[format('storage{0}', uniqueString(resourceGroup().id))]",
      "minLength": 3,
      "maxLength": 24
    }
  },
  "functions": [],
  "variables": {},
  "resources": [
    {
      "name": "[parameters('storageAccountName')]",
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "tags": {
        "displayName": "storageaccount1"
      },
      "___location": "[resourceGroup().___location]",
      "kind": "StorageV2",
      "sku": {
        "name": "Premium_LRS",
        "tier": "Premium"
      }
    }
  ],
  "outputs": {}
}

Implantar o modelo

Abra o terminal integrado do Visual Studio Code usando a combinação de teclas ctrl + ` e use o módulo da CLI do Azure ou do Azure PowerShell para implantar o modelo.

az group create --name arm-vscode --___location eastus

az deployment group create --resource-group arm-vscode --template-file azuredeploy.json 

Limpar os recursos

Quando os recursos do Azure não forem mais necessários, use o módulo da CLI do Azure ou do Azure PowerShell para excluir o grupo de recursos de início rápido.

az group delete --name arm-vscode

Próximas etapas