Azure CLI ile etiket uygulama

  • Makale

Bu makalede kaynakları, kaynak gruplarını ve abonelikleri etiketlemek için Azure CLI'nin nasıl kullanılacağı açıklanmaktadır. Etiket önerileri ve sınırlamaları için bkz. Azure kaynaklarınızı ve yönetim hiyerarşinizi düzenlemek için etiketleri kullanma.

Etiketleri uygulama

Azure CLI, etiketleri uygulamak için iki komut sunar: az tag create ve az tag update. Azure CLI 2.10.0 veya sonraki bir sürümüne sahip olmanız gerekir. sürümünüzü ile az versionde kontrol edebilirsiniz. Güncelleştirmek veya yüklemek için bkz. Azure CLI'yi yükleme.

, az tag create kaynak, kaynak grubu veya abonelik üzerindeki tüm etiketlerin yerini alır. komutunu çağırdığınızda, etiketlemek istediğiniz varlığın kaynak kimliğini geçirin.

Aşağıdaki örnek bir depolama hesabına bir etiket kümesi uygular:

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

Komut tamamlandığında kaynağın iki etiketi olduğuna dikkat edin.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Status": "Normal"
  }
},

Komutu yeniden çalıştırırsanız ancak bu kez farklı etiketlerle karşılaşırsanız, önceki etiketlerin kaybolduğuna dikkat edin.

az tag create --resource-id $resource --tags Team=Compliance Environment=Production

"properties": {
  "tags": {
    "Environment": "Production",
    "Team": "Compliance"
  }
},

Zaten etiketleri olan bir kaynağa etiket eklemek için kullanın az tag update. parametresini --operation olarak Mergeayarlayın.

az tag update --resource-id $resource --operation Merge --tags Dept=Finance Status=Normal

Mevcut etiketlerin iki yeni etiketin eklenmesiyle büyüdüğünü fark edin.

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Normal",
    "Team": "Compliance"
  }
},

Her etiket adının yalnızca bir değeri olabilir. Bir etiket için yeni bir değer sağlarsanız, birleştirme işlemini kullansanız bile yeni etiket eski değerin yerini alır. Aşağıdaki örnek, etiketi Normal'denYeşil'e değiştirirStatus.

az tag update --resource-id $resource --operation Merge --tags Status=Green

"properties": {
  "tags": {
    "Dept": "Finance",
    "Environment": "Production",
    "Status": "Green",
    "Team": "Compliance"
  }
},

parametresini --operation olarak Replaceayarladığınızda, yeni etiket kümesi mevcut etiketlerin yerini alır.

az tag update --resource-id $resource --operation Replace --tags Project=ECommerce CostCenter=00123 Team=Web

Kaynakta yalnızca yeni etiketler kalır.

"properties": {
  "tags": {
    "CostCenter": "00123",
    "Project": "ECommerce",
    "Team": "Web"
  }
},

Aynı komutlar kaynak grupları veya aboneliklerle de çalışır. Bunları etiketlemek istediğiniz kaynak grubunun veya aboneliğin tanımlayıcısına geçirin.

Kaynak grubuna yeni bir etiket kümesi eklemek için şunu kullanın:

group=$(az group show -n demoGroup --query id --output tsv)
az tag create --resource-id $group --tags Dept=Finance Status=Normal

Bir kaynak grubunun etiketlerini güncelleştirmek için şunu kullanın:

az tag update --resource-id $group --operation Merge --tags CostCenter=00123 Environment=Production

Aboneliğe yeni bir etiket kümesi eklemek için şunu kullanın:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag create --resource-id /subscriptions/$sub --tags CostCenter=00123 Environment=Dev

Aboneliğin etiketlerini güncelleştirmek için şunu kullanın:

az tag update --resource-id /subscriptions/$sub --operation Merge --tags Team="Web Apps"

Etiketleri listeleme

Bir kaynağın, kaynak grubunun veya aboneliğin etiketlerini almak için az tag list komutunu kullanın ve varlığın kaynak kimliğini geçirin.

Bir kaynağın etiketlerini görmek için şunu kullanın:

resource=$(az resource show -g demoGroup -n demostorage --resource-type Microsoft.Storage/storageAccounts --query "id" --output tsv)
az tag list --resource-id $resource

Bir kaynak grubunun etiketlerini görmek için şunu kullanın:

group=$(az group show -n demoGroup --query id --output tsv)
az tag list --resource-id $group

Aboneliğin etiketlerini görmek için şunu kullanın:

sub=$(az account show --subscription "Demo Subscription" --query id --output tsv)
az tag list --resource-id /subscriptions/$sub

Etikete göre listele

Belirli bir etiket adına ve değerine sahip kaynakları almak için şunu kullanın:

az resource list --tag CostCenter=00123 --query [].name

Herhangi bir etiket değerine sahip belirli bir etiket adına sahip kaynakları almak için şunu kullanın:

az resource list --tag Team --query [].name

Belirli bir etiket adına ve değerine sahip kaynak gruplarını almak için şunu kullanın:

az group list --tag Dept=Finance

Etiketleri kaldırma

Belirli etiketleri kaldırmak için kullanın az tag update ve olarak Deleteayarlayın--operation. Silmek istediğiniz etiketlerin kaynak kimliğini geçirin.

az tag update --resource-id $resource --operation Delete --tags Project=ECommerce Team=Web

Belirtilen etiketleri kaldırdınız.

"properties": {
  "tags": {
    "CostCenter": "00123"
  }
},

Tüm etiketleri kaldırmak için az tag delete komutunu kullanın.

az tag delete --resource-id $resource

Alanları işleme

Etiket adlarınız veya değerleriniz boşluk içeriyorsa, bunları tırnak içine alın.

az tag update --resource-id $group --operation Merge --tags "Cost Center"=Finance-1222 Location="West US"

Sonraki adımlar