Guia de início rápido: criar modelos ARM com o Visual Studio Code

Neste Guia de início rápido, você usa o Visual Studio Code para criar modelos do Azure Resource Manager (modelos ARM). Para obter um tutorial mais focado na sintaxe, consulte Tutorial: Criar e implantar seu primeiro modelo ARM.

Se não tiver uma subscrição 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 ARM

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

Adicione o seguinte trecho JSON ao arquivo para estruturar um modelo 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, resources, e outputs. Cada seção está vazia no momento.

Adicionar um recurso do Azure

Atualize a seção de recursos com o seguinte trecho para incluir uma conta de armazenamento.

"resources": [{
  "name": "storageaccount1",
  "type": "Microsoft.Storage/storageAccounts",
  "apiVersion": "2025-01-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 de 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 de conta de armazenamento do Azure têm um comprimento mínimo de três caracteres e um máximo de 24. Adicione ambos minLength e maxLength ao parâmetro e forneça 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 name 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-01-01",
      "tags": {
        "displayName": "storageaccount1"
      },
      "___location": "[resourceGroup().___location]",
      "kind": "StorageV2",
      "sku": {
        "name": "Premium_LRS",
        "tier": "Premium"
      }
    }
  ],
  "outputs": {}
}

Implementar o modelo

Abra o terminal integrado do Visual Studio Code usando a combinação de ctrl + ` teclas e use a CLI do Azure ou o módulo 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 

New-AzResourceGroup -Name arm-vscode -Location eastus

New-AzResourceGroupDeployment -ResourceGroupName arm-vscode -TemplateFile ./azuredeploy.json 

Clean up resources (Limpar recursos)

Quando não precisar mais dos recursos do Azure, use a CLI do Azure ou o módulo do Azure PowerShell para excluir o grupo de recursos de início rápido.

az group delete --name arm-vscode

Remove-AzResourceGroup -Name arm-vscode

Próximos passos