Menerapkan tag dengan Azure CLI

  • Artikel

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