자습서: Azure Resource Manager 템플릿에 출력 추가

이 자습서에서는 ARM 템플릿(Azure Resource Manager 템플릿)에서 값을 반환하는 방법을 알아봅니다. 배포하는 리소스에 대한 값이 필요한 경우 출력을 사용합니다. 이 자습서를 완료하는 데 7분 이 걸립니다.

필수 조건

변수에 대한 자습서를 완료하는 것이 좋지만 필수는 아닙니다.

Visual Studio Code와 Azure PowerShell 또는 Azure CLI가 있어야 합니다. 자세한 내용은 템플릿 도구를 참조하세요.

템플릿 검토

이전 자습서의 끝부분에서 템플릿에는 다음 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
      }
    }
  ]
}

스토리지 계정을 배포하지만 해당 계정에 대한 정보는 반환하지 않습니다. 나중에 참조할 수 있도록 새 리소스에서 속성을 캡처해야 할 수 있습니다.

출력 추가

출력을 사용하여 템플릿에서 값을 반환할 수 있습니다. 예를 들어 새 스토리지 계정에 대한 엔드포인트를 가져오는 것이 유용할 수 있습니다.

다음 예제에서는 출력 값을 추가하기 위해 템플릿의 변경 내용을 강조 표시합니다. 전체 파일을 복사하고 템플릿을 해당 내용으로 바꿉니다.

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

추가한 출력 값에 대해 유의해야 할 몇 가지 중요한 항목이 있습니다.

반환된 값의 형식은 JSON 개체를 object반환하는 형식으로 설정됩니다.

참조 함수를 사용하여 스토리지 계정의 런타임 상태를 가져옵니다. 리소스의 런타임 상태를 가져오려면 리소스의 이름 또는 ID를 전달합니다. 이 경우 스토리지 계정의 이름을 만드는 데 사용한 것과 동일한 변수를 사용합니다.

마지막으로 스토리지 계정에서 속성을 반환 primaryEndpoints 합니다.

템플릿 배포

템플릿을 배포하고 반환된 값을 확인할 준비가 된 것입니다.

리소스 그룹을 만들지 않은 경우 리소스 그룹 만들기를 참조하세요. 이 예제에서는 templateFile와 같이 변수를 템플릿 파일의 경로로 설정한 것으로 가정합니다.

Azure PowerShell
Azure CLI

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

이 배포 명령을 실행하려면 최신 버전의 Azure CLI가 있어야 합니다.

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

배포 명령에 대한 출력에는 출력이 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/"
}

비고

배포가 실패하면 스위치를 verbose 사용하여 생성되는 리소스에 대한 정보를 가져옵니다. 스위치를 debug 사용하여 디버깅에 대한 자세한 정보를 가져옵니다.

작업 검토

지난 6개의 자습서에서 많은 작업을 수행했습니다. 잠시 시간을 내어 수행한 작업을 검토해 보겠습니다. 쉽게 제공할 수 있는 매개 변수를 사용하여 템플릿을 만들었습니다. 템플릿은 사용자 지정을 허용하고 필요한 값을 동적으로 만들기 때문에 다른 환경에서 다시 사용할 수 있습니다. 또한 스크립트에서 사용할 수 있는 스토리지 계정에 대한 정보를 반환합니다.

이제 리소스 그룹 및 배포 기록을 살펴보겠습니다.