Sdílet prostřednictvím

Použití značek pomocí Azure CLI

  • Článek

Tento článek popisuje, jak používat Azure CLI k označování prostředků, skupin prostředků a předplatných. Doporučení a omezení značek najdete v tématu Použití značek k uspořádání prostředků Azure a hierarchie správy.

Použití značek

Azure CLI nabízí dva příkazy pro použití značek: az tag create a az tag update. Musíte mít Azure CLI verze 2.10.0 nebo novější. Verzi můžete zkontrolovat pomocí příkazu az version. Pokud ho chcete aktualizovat nebo nainstalovat, přečtěte si téma Instalace Azure CLI.

Nahradí az tag create všechny značky prostředku, skupiny prostředků nebo předplatného. Při volání příkazu předejte ID prostředku entity, kterou chcete označit.

Následující příklad použije sadu značek na účet úložiště:

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

Po dokončení příkazu si všimněte, že prostředek má dvě značky.

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

Pokud příkaz spustíte znovu, ale tentokrát s jinými značkami, všimněte si, že dřívější značky zmizí.

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

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

Pokud chcete přidat značky k prostředku, který už značky obsahuje, použijte az tag update. Nastavte --operation parametr na Merge.

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

Všimněte si, že stávající značky se zvětšují s přidáním dvou nových značek.

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

Každý název značky může mít jenom jednu hodnotu. Pokud pro značku zadáte novou hodnotu, nahradí nová značka starou hodnotu, i když použijete operaci sloučení. Následující příklad změní Status značku z Normální na Zelenou.

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

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

Když nastavíte --operation parametr na Replace, nahradí nová sada značek stávající značky.

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

Na prostředku zůstanou jenom nové značky.

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

Stejné příkazy fungují také se skupinami prostředků nebo předplatnými. Předejte je v identifikátoru skupiny prostředků nebo předplatného, které chcete označit.

Pokud chcete do skupiny prostředků přidat novou sadu značek, použijte:

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

Pokud chcete aktualizovat značky pro skupinu prostředků, použijte:

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

Pokud chcete do předplatného přidat novou sadu značek, použijte:

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

Pokud chcete aktualizovat značky pro předplatné, použijte:

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

Výpis značek

Pokud chcete získat značky pro prostředek, skupinu prostředků nebo předplatné, použijte příkaz az tag list a předejte ID prostředku entity.

Pokud chcete zobrazit značky prostředku, použijte:

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

Pokud chcete zobrazit značky pro skupinu prostředků, použijte:

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

Pokud chcete zobrazit značky předplatného, použijte:

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

Vypsat podle značky

Pokud chcete získat prostředky, které mají konkrétní název a hodnotu značky, použijte:

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

Pokud chcete získat prostředky, které mají konkrétní název značky s libovolnou hodnotou značky, použijte:

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

Pokud chcete získat skupiny prostředků, které mají konkrétní název a hodnotu značky, použijte:

az group list --tag Dept=Finance

Odebrání značek

Pokud chcete odebrat konkrétní značky, použijte az tag update a nastavte --operation na Delete. Předejte ID prostředku značek, které chcete odstranit.

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

Odebrali jste zadané značky.

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

Pokud chcete odebrat všechny značky, použijte příkaz az tag delete .

az tag delete --resource-id $resource

Manipulace s prostory

Pokud názvy značek nebo hodnoty obsahují mezery, uzavřete je do uvozovek.

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

Další kroky