Tutorial: Adicionar saídas ao seu modelo do Azure Resource Manager

Neste tutorial, você aprenderá a retornar um valor do seu modelo do Azure Resource Manager (modelo ARM). Você usa saídas quando precisa de um valor para um recurso implantado. Este tutorial leva 7 minutos para ser concluído.

Pré-requisitos

Recomendamos que você conclua o tutorial sobre variáveis, 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.

Modelo de revisão

No final do tutorial anterior, seu modelo tinha o seguinte JSON:

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

Ele implanta uma conta de armazenamento, mas não retorna nenhuma informação sobre ela. Talvez seja necessário capturar propriedades do novo recurso para que elas fiquem disponíveis posteriormente para referência.

Adicionar saídas

Você pode usar saídas para retornar valores do modelo. Talvez seja útil, por exemplo, obter os pontos de extremidade para a sua nova conta de armazenamento.

O exemplo a seguir destaca a alteração no modelo para adicionar um valor de saída. Copie o arquivo inteiro e substitua seu 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
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Há alguns itens importantes a serem observados sobre o valor de saída que você adicionou.

O tipo de valor retornado é definido como object, o que significa que retorna um objeto JSON.

Ele usa a função de referência para obter o estado de tempo de execução da conta de armazenamento. Para obter o estado de tempo de execução de um recurso, passe o nome ou ID de um recurso. Nesse caso, você usa a mesma variável usada para criar o nome da conta de armazenamento.

Finalmente, ele retorna a propriedade primaryEndpoints da conta de armazenamento.

Implementar o modelo

Você está pronto para implantar o modelo e examinar o valor retornado.

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 addoutputs `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

az deployment group create \
  --name addoutputs \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Na saída do comando deployment, você verá um objeto semelhante ao exemplo a seguir somente se a saída estiver no formato JSON:

{
    "dfs": "https://storeluktbfkpjjrkm.dfs.core.windows.net/",
    "web": "https://storeluktbfkpjjrkm.z19.web.core.windows.net/",
    "blob": "https://storeluktbfkpjjrkm.blob.core.windows.net/",
    "queue": "https://storeluktbfkpjjrkm.queue.core.windows.net/",
    "table": "https://storeluktbfkpjjrkm.table.core.windows.net/",
    "file": "https://storeluktbfkpjjrkm.file.core.windows.net/"
}

Reveja o seu trabalho

Você fez muito nos últimos seis tutoriais. Vamos reservar um momento para rever o que você fez. Você criou um modelo com parâmetros que são fáceis de fornecer. O modelo é reutilizável em diferentes ambientes porque permite a personalização e cria dinamicamente os valores necessários. Ele também retorna informações sobre a conta de armazenamento que você pode usar em seu script.

Agora, vamos examinar o grupo de recursos e o histórico de implantação.

1. Inicie sessão no portal Azure.

2. No menu à esquerda, selecione Grupos de recursos.

3. Selecione o grupo de recursos no qual você implantou.

4. Dependendo das etapas executadas, você deve ter pelo menos uma e talvez várias contas de armazenamento no grupo de recursos.

5. Você também deve ter várias implantações bem-sucedidas listadas no histórico. Selecione esse link.

   

6. Step 2: Você vê todas as suas implementações no histórico de versões. Selecione a implantação chamada addoutputs.

   

7. Você pode revisar os dados de entrada.

   

8. Você pode revisar os resultados.

   

9. Você pode revisar o modelo.

   

Limpeza de recursos

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

Se estiveres a parar agora, podes querer eliminar o grupo de recursos.

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

Próximos passos

Neste tutorial, você adicionou um valor de retorno ao modelo. No próximo tutorial, você aprenderá a exportar um modelo e usar partes desse modelo exportado em seu modelo.