Tutorial: Menambahkan sumber daya ke templat Azure Resource Manager Anda

Dalam tutorial sebelumnya, Anda mempelajari cara membuat dan menyebarkan templat Azure Resource Manager (templat ARM) kosong pertama Anda. Sekarang, Anda siap untuk menyebarkan sumber daya aktual ke templat tersebut. Dalam hal ini, akun penyimpanan Azure. Instruksi ini membutuhkan waktu 9 menit untuk diselesaikan.

Prasyarat

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

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

Menambahkan sumber daya

Untuk menambahkan definisi akun penyimpanan Azure ke templat yang sudah ada, lihat file JSON dalam contoh berikut. Alih-alih mencoba menyalin bagian templat, salin seluruh file dan ganti templat Anda dengan kontennya.

Ganti {provide-unique-name} dan kurung kurawal {} dengan nama akun penyimpanan yang unik.

Penting

Nama akun penyimpanan harus unik di seluruh Azure. Ini hanya huruf kecil atau angka dan memiliki batas 24 karakter. Anda dapat menggunakan nama seperti store1 sebagai awalan lalu menambahkan inisial Anda dan tanggal hari ini. Nama, misalnya, dapat toko1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Menentukan nama yang unik untuk akun penyimpanan tidak mudah dan tidak berfungsi dengan baik untuk otomatisasi penyebaran berskala besar. Nantinya dalam seri tutorial ini, Anda menggunakan fitur templat yang memudahkan untuk membuat nama yang unik.

Karakteristik sumber daya

Anda mungkin bertanya-tanya cara menemukan properti yang akan digunakan untuk setiap jenis sumber daya. Anda dapat menggunakan referensi templat ARM untuk menemukan jenis sumber daya yang ingin Anda sebarkan.

Setiap sumber daya yang Anda sebarkan memiliki setidaknya tiga properti berikut:

• type: Jenis sumber daya. Nilai ini adalah kombinasi namespace penyedia sumber daya dan jenis sumber daya seperti Microsoft.Storage/storageAccounts.
• apiVersion: Versi REST API yang digunakan untuk membuat sumber daya. Setiap penyedia sumber daya menerbitkan versi API-nya sendiri, sehingga nilai ini khusus untuk jenisnya.
• name: Nama sumber daya.

Sebagian besar sumber daya juga memiliki location properti, yang mengatur wilayah tempat Anda menyebarkan sumber daya.

Properti lain bervariasi menurut jenis sumber daya dan versi API. Penting untuk memahami koneksi antara versi API dan properti yang tersedia, jadi mari kita langsung ke detail selengkapnya.

Dalam tutorial ini, Anda menambahkan akun penyimpanan ke templat. Anda dapat melihat versi API akun penyimpanan di storageAccounts 2021-09-01. Perhatikan bahwa Anda tidak menambahkan semua properti ke templat Anda. Banyak properti bersifat opsional. Penyedia Microsoft.Storage sumber daya dapat merilis versi API baru, tetapi versi yang Anda sebarkan tidak perlu berubah. Anda dapat terus menggunakan versi tersebut dan mengetahui bahwa hasil penyebaran Anda konsisten.

Jika Anda melihat versi API yang lebih lama, Anda mungkin melihat bahwa sekumpulan properti yang lebih kecil tersedia.

Jika Anda memutuskan untuk mengubah versi API untuk sumber daya, pastikan Anda mengevaluasi properti untuk versi tersebut dan menyesuaikan templat Anda dengan tepat.

Menyebarkan templat

Anda dapat menyebarkan templat untuk membuat akun penyimpanan. Berikan penyebaran Anda nama lain sehingga Anda dapat dengan mudah menemukannya dalam riwayat.

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.

Azure PowerShell

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Azure CLI

Untuk menjalankan perintah penyebaran ini, Anda harus memiliki versi terbaru Azure CLI.

az deployment group create \
  --name addstorage \
  --resource-group myResourceGroup \
  --template-file $templateFile

Nota

Jika penyebaran gagal, gunakan tombol verbose untuk mendapatkan informasi tentang sumber daya yang Anda buat. Gunakan saklar debug untuk mendapatkan informasi selengkapnya untuk pemecahan masalah.

Kesalahan ini adalah dua kemungkinan kegagalan penyebaran yang mungkin Anda temui:

• Error: Code=AccountNameInvalid; Message={provide-unique-name} bukan nama akun penyimpanan yang valid. Panjang nama akun penyimpanan harus antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil.

  Dalam templat, ganti {provide-unique-name} dengan nama akun penyimpanan yang unik. Lihat Menambahkan sumber daya.

• Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 sudah diambil.

  Dalam templat, coba nama akun penyimpanan yang berbeda.

Penyebaran ini membutuhkan waktu lebih lama dari penyebaran templat kosong Anda karena Anda membuat akun penyimpanan. Butuh waktu sekitar satu menit.

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. Centang kotak di sebelah kiri myResourceGroup dan pilih myResourceGroup
4. Pilih grup sumber daya yang Anda sebarkan.
5. Anda melihat bahwa akun penyimpanan telah berhasil diterapkan.
6. Perhatikan bahwa label penyebaran sekarang mengatakan: Penyebaran: 2 Berhasil.

Membersihkan sumber daya

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

Jika berhenti sekarang, Anda mungkin ingin membersihkan sumber daya yang Anda sebarkan dengan 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 Filter untuk bidang apa pun ... .
3. Centang kotak di samping myResourceGroup dan pilih myResourceGroup atau nama grup sumber daya yang Anda pilih.
4. Pilih Hapus grup sumber daya dari menu atas.

Langkah selanjutnya

Anda membuat templat sederhana untuk menyebarkan akun penyimpanan Azure. Dalam tutorial selanjutnya, Anda mempelajari cara menambahkan parameter, variabel, sumber daya, dan output ke templat. Fitur-fitur ini adalah blok penyusun untuk templat yang jauh lebih kompleks.

Tambahkan parameter