Bagikan melalui

Tutorial: Menambahkan variabel ke templat Azure Resource Manager Anda

Dalam tutorial ini, Anda mempelajari cara menambahkan variabel ke templat Azure Resource Manager (templat ARM). Variabel menyederhanakan templat Anda. Mereka memungkinkan Anda menulis ekspresi sekali dan menggunakannya kembali di seluruh templat. Tutorial ini membutuhkan waktu 7 menit untuk diselesaikan.

Prasyarat

Kami menyarankan agar Anda menyelesaikan tutorial tentang fungsi, tetapi tidak diperlukan.

Anda harus memiliki Visual Studio Code, dan Azure PowerShell atau Azure CLI. Untuk informasi selengkapnya, lihat alat templat.

Meninjau templat

Di akhir tutorial sebelumnya, templat Anda memiliki file JSON berikut:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 24
    },
    "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]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[parameters('storageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Nama akun penyimpanan Azure Anda harus unik untuk terus membangun templat ARM Anda dengan mudah. Jika Anda telah menyelesaikan tutorial sebelumnya dalam seri ini, Anda mungkin merasa lelah mencari nama yang unik. Anda menyelesaikan masalah ini dengan menambahkan variabel yang membuat nama unik untuk akun penyimpanan Anda.

Gunakan variabel

Contoh berikut menunjukkan perubahan untuk menambahkan variabel ke templat Anda yang membuat nama akun penyimpanan unik. Salin seluruh file, dan ganti templat Anda dengan kontennya:

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

Perhatikan bahwa itu termasuk variabel bernama uniqueStorageName. Variabel ini menggunakan empat fungsi untuk membuat nilai string.

Anda sudah terbiasa dengan fungsi parameter , jadi kami tidak akan memeriksanya.

Anda juga terbiasa dengan fungsi resourceGroup . Dalam hal ini, Anda mendapatkan properti id alih-alih properti location, seperti yang ditunjukkan dalam tutorial sebelumnya. Properti id mengembalikan pengidentifikasi lengkap grup sumber daya, termasuk ID langganan dan nama grup sumber daya.

Fungsi uniqueString membuat nilai hash 13 karakter. Parameter yang Anda masukkan menentukan nilai yang dikembalikan. Untuk tutorial ini, Anda menggunakan ID grup sumber daya sebagai input untuk nilai hash. Itu berarti Anda dapat menyebarkan templat ini ke grup sumber daya yang berbeda dan mendapatkan nilai string unik yang berbeda. Namun, Anda mendapatkan nilai yang sama jika Anda menyebarkan ke grup sumber daya yang sama.

Fungsi concat mengambil nilai dan menggabungkannya. Untuk variabel ini, mengambil string dari parameter dan string dari fungsi uniqueString dan digabungkan menjadi satu string.

Parameter storagePrefix ini memungkinkan Anda meneruskan awalan yang membantu Anda mengidentifikasi akun penyimpanan. Anda dapat membuat konvensi penamaan Anda sendiri yang memudahkan untuk mengidentifikasi akun penyimpanan setelah penyebaran dari daftar sumber daya yang luas.

Terakhir, perhatikan bahwa nama akun penyimpanan sekarang diatur ke variabel alih-alih parameter.

Menyebarkan templat

Mari kita terapkan template. Menyebarkan templat ini lebih mudah daripada templat sebelumnya karena Anda hanya memberikan awalan untuk nama akun penyimpanan.

Jika Anda belum membuat grup sumber daya, lihat Membuat grup sumber daya. Contoh mengasumsikan Anda telah mengatur templateFile variabel ke jalur ke file templat, seperti yang ditunjukkan dalam tutorial pertama.

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

Nota

Jika penyebaran gagal, gunakan sakelar verbose untuk mendapatkan informasi tentang sumber daya yang dibuat. Gunakan tombol debug untuk mendapatkan informasi selengkapnya untuk penelusuran kesalahan.

Verifikasi implementasi

Anda dapat memverifikasi penyebaran dengan menjelajahi grup sumber daya dari portal Microsoft Azure.

  1. Masuk ke portal Azure.
  2. Dari menu sebelah kiri, pilih Grup sumber daya.
  3. Pilih grup sumber daya Anda.
  4. Perhatikan bahwa nama akun penyimpanan yang telah diterapkan adalah store, ditambah serangkaian karakter acak.

Membersihkan sumber daya

Jika Anda melanjutkan ke tutorial berikutnya, Anda tidak perlu menghapus grup sumber daya.

Jika berhenti sekarang, Anda mungkin ingin menghapus grup sumber daya.

  1. Dari portal Microsoft Azure, pilih Grup sumber daya dari menu sebelah kiri.
  2. Ketik nama grup sumber daya di kotak teks Filter untuk bidang apa pun....
  3. Centang kotak di samping myResourceGroup dan pilih myResourceGroup atau nama grup sumber daya Anda.
  4. Pilih Hapus grup sumber daya dari menu atas.

Langkah selanjutnya

Dalam tutorial ini, Anda menambahkan variabel yang membuat nama akun penyimpanan unik. Dalam tutorial berikutnya, Anda akan mengembalikan nilai dari akun penyimpanan yang telah diterapkan.

Tambahkan beberapa output

  • Last updated on