Självstudie: Lägga till utdata i din Azure Resource Manager-mall

2025-10-29

I den här självstudien får du lära dig hur du returnerar ett värde från din Azure Resource Manager-mall (ARM-mall). Du använder utdata när du behöver ett värde för en resurs som du distribuerar. Den här tutorialen tar 7 minuter att slutföra.

Förutsättningar

Vi rekommenderar att du slutför självstudien om variabler, men det krävs inte.

Du måste ha Visual Studio Code och antingen Azure PowerShell eller Azure CLI. Mer information finns i mallverktyg.

Granskningsmall

I slutet av den föregående självstudien hade mallen följande 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": "2021-09-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Det distribuerar ett lagringskonto, men det returnerar ingen information om det. Du kan behöva samla in egenskaper från den nya resursen så att de blir tillgängliga senare som referens.

Lägga till utdata

Du kan använda utdata för att returnera värden från mallen. Det kan till exempel vara bra att hämta slutpunkterna för ditt nya lagringskonto.

I följande exempel visas ändringen av mallen för att lägga till ett utdatavärde. Kopiera hela filen och ersätt mallen med dess innehåll:

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

Det finns några viktiga objekt att notera om utdatavärdet som du har lagt till.

Typen av returnerat värde är inställt på object, vilket innebär att det returnerar ett JSON-objekt.

Använder referensfunktionen för att hämta körtillståndet för lagringskontot. För att hämta körningstillstånd för en resurs, skicka namnet eller ID:t på resursen. I det här fallet använder du samma variabel som du använde för att skapa namnet på lagringskontot.

Slutligen returnerar den egenskapen primaryEndpoints från lagringskontot.

Distribuera mallen

Du är redo att distribuera mallen och titta på det returnerade värdet.

Om du inte har skapat resursgruppen kan du läsa Skapa resursgrupp. Exemplet förutsätter att du har angett variabeln templateFile till sökvägen till mallfilen, som du ser i den första självstudien.

Azure PowerShell
Azure CLI

New-AzResourceGroupDeployment `
  -Name addoutputs `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Om du vill köra det här distributionskommandot måste du ha den senaste versionen av Azure CLI.

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

I utdata för distributionskommandot ser du ett objekt som liknar följande exempel endast om utdata är i JSON-format:

{
    "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/"
}

Anmärkning

Om distributionen misslyckas använder du växeln verbose för att hämta information om de resurser som skapas. Använd växeln debug för att få mer information om felsökning.

Granska ditt arbete

Du har gjort mycket i de senaste sex självstudierna. Låt oss ta en stund att granska vad du har gjort. Du har skapat en mall med parametrar som är enkla att tillhandahålla. Mallen kan återanvändas i olika miljöer eftersom den möjliggör anpassning och dynamiskt skapar nödvändiga värden. Den returnerar också information om lagringskontot som du kan använda i skriptet.

Nu ska vi titta på resursgruppen och distributionshistoriken.

Logga in på Azure-portalen.
Välj Resursgrupper på den vänstra menyn.
Välj den resursgrupp som du distribuerade till.
Beroende på vilka steg du gjorde bör du ha minst ett och kanske flera lagringskonton i resursgruppen.
Du bör också ha flera lyckade installationer i historiken. Välj länken.
Du ser alla dina utplaceringar i historiken. Välj distributionen med namnet addoutputs.
Du kan granska indata.
Du kan granska utdata.
Du kan granska mallen.

Rensa resurser

Om du går vidare till nästa självstudie behöver du inte ta bort resursgruppen.

Om du slutar nu kanske du vill ta bort resursgruppen.

I Azure-portalen väljer du Resursgrupper på den vänstra menyn.
Skriv resursgruppens namn i fältet Filter för alla fält... textfält.
Markera kryssrutan bredvid myResourceGroup och välj myResourceGroup eller resursgruppens namn.
Välj Ta bort resursgrupp på den översta menyn.

Nästa steg

I den här självstudien har du lagt till ett returvärde i mallen. I nästa handledning får du lära dig hur du exporterar en mall och använder delar av den exporterade mallen i din egen mall.

Använda exporterad mall

Feedback

Var den här sidan till hjälp?