Menerapkan tag dengan Azure CLI
Artikel ini menjelaskan cara menggunakan Azure CLI untuk menandai sumber daya, grup sumber daya, dan langganan. Untuk rekomendasi dan batasan tag, lihat Menggunakan tag untuk mengatur sumber daya Azure dan hierarki manajemen Anda.
Terapkan tag
Azure CLI menawarkan dua perintah untuk menerapkan tag: az tag create dan az tag update. Anda harus memiliki versi Azure CLI 2.10.0 atau yang lebih baru. Anda dapat memeriksa versi milik anda dengan az version
. Untuk pembaruan atau pemasangannya, lihat Pasang Azure CLI.
az tag create
menggantikan semua tag pada sumber daya, grup sumber daya, atau langganan. Saat Anda memanggil perintah, teruskan ID sumber daya entitas yang ingin Anda tandai.
Contoh berikut menerapkan sekumpulan tag ke akun penyimpanan:
resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag create --resource-id $resource --tags Dept=Finance Status=Normal
Ketika perintah selesai, perhatikan apakah sumber daya memiliki dua tag.
"properties": {
"tags": {
"Dept": "Finance",
"Status": "Normal"
}
},
Jika Anda menjalankan perintah lagi tetapi kali ini dengan tag yang berbeda, perhatikan apakah tag sebelumnya menghilang.
az tag create --resource-id $resource --tags Team=Compliance Environment=Production
"properties": {
"tags": {
"Environment": "Production",
"Team": "Compliance"
}
},
Untuk menambahkan tag ke sumber daya yang sudah memiliki tag, gunakan az tag update
. Set --operation
parameter ke Merge
.
az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal
Perhatikan bahwa tag yang ada tumbuh dengan penambahan dua tag baru.
"properties": {
"tags": {
"Dept": "Finance",
"Environment": "Production",
"Status": "Normal",
"Team": "Compliance"
}
},
Setiap nama tag hanya dapat memiliki satu nilai. Jika Anda memberikan nilai baru untuk tag, tag baru tersebut mengganti nilai lama meskipun Anda menggunakan operasi penggabungan. Contoh berikut mengubah Status
tag dari Normal ke Hijau.
az tag update --resource-id $resource --operation Merge --tags Status=Green
"properties": {
"tags": {
"Dept": "Finance",
"Environment": "Production",
"Status": "Green",
"Team": "Compliance"
}
},
Ketika Anda mengatur parameter --operation
ke Replace
, set tag yang baru akan menggantikan tag-tag yang ada.
az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web
Hanya tag baru yang tersisa di sumber daya.
"properties": {
"tags": {
"CostCenter": "00123",
"Project": "ECommerce",
"Team": "Web"
}
},
Perintah yang sama juga berfungsi dengan grup sumber daya atau langganan. Teruskan pengidentifikasi untuk grup sumber daya atau langganan yang ingin Anda tandai.
Untuk menambahkan sekumpulan tag baru ke grup sumber daya, gunakan:
group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal
Untuk perbarui tag untuk grup sumber daya, gunakan:
az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production
Untuk menambahkan sekumpulan tag baru ke langganan, gunakan:
sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev
Untuk perbarui tag untuk langganan, gunakan:
az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"
Daftar tag
Untuk mendapatkan tag untuk sumber daya, grup sumber daya, atau langganan, gunakan perintah daftar tag az dan berikan ID sumber daya untuk entitas.
Untuk melihat tag untuk sumber daya, gunakan:
resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource
Untuk melihat tag untuk grup sumber daya, gunakan:
group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group
Untuk melihat tag untuk langganan, gunakan:
sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub
Daftar menurut tag
Untuk mendapatkan sumber daya yang memiliki nama dan nilai tag tertentu, gunakan:
az resource list --tag CostCenter=00123 --query [].name
Untuk mendapatkan sumber daya yang memiliki nama dengan nilai tag tertentu, gunakan:
az resource list --tag Team --query [].name
Untuk mendapatkan grup sumber daya yang memiliki nama dan nilai tag tertentu, gunakan:
az group list --tag Dept=Finance
Hapus tag
Untuk menghapus tag tertentu, gunakan az tag update
dan set --operation
ke Delete
Berikan ID sumber daya tag yang ingin Anda hapus.
az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web
Anda telah menghapus tag yang ditentukan.
"properties": {
"tags": {
"CostCenter": "00123"
}
},
Untuk menghapus semua tag, gunakan perintah hapus tag az.
az tag delete --resource-id $resource
Menangani spasi
Jika nama atau nilai tag Anda menyertakan spasi, sertakan dalam tanda kutip.
az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"
Langkah berikutnya
- Tidak semua jenis sumber daya mendukung tag. Untuk menentukan apakah Anda bisa menerapkan tag ke suatu jenis sumber daya, lihat Dukungan tag untuk sumber daya Azure.
- Untuk rekomendasi tentang cara menerapkan strategi penandaan, lihat Panduan keputusan penandaan dan penamaan sumber daya.
- Untuk rekomendasi dan batasan tag, lihat Menggunakan tag untuk mengatur sumber daya Azure dan hierarki manajemen Anda.