Stosowanie tagów za pomocą interfejsu wiersza polecenia platformy Azure

  • Artykuł

W tym artykule opisano sposób używania interfejsu wiersza polecenia platformy Azure do tagowania zasobów, grup zasobów i subskrypcji. Aby uzyskać zalecenia i ograniczenia dotyczące tagów, zobacz Organizowanie zasobów platformy Azure i hierarchii zarządzania przy użyciu tagów.

Stosowanie tagów

Interfejs wiersza polecenia platformy Azure oferuje dwa polecenia do stosowania tagów: az tag create i az tag update. Musisz mieć interfejs wiersza polecenia platformy Azure w wersji 2.10.0 lub nowszej. Możesz sprawdzić wersję za pomocą polecenia az version. Aby ją zaktualizować lub zainstalować, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.

Element az tag create zastępuje wszystkie tagi w zasobie, grupie zasobów lub subskrypcji. Po wywołaniu polecenia przekaż identyfikator zasobu jednostki, którą chcesz oznaczyć.

Poniższy przykład stosuje zestaw tagów do konta magazynu:

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 zakończeniu polecenia zwróć uwagę, że zasób ma dwa tagi.

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

Jeśli ponownie uruchomisz polecenie, ale tym razem z różnymi tagami, zwróć uwagę, że wcześniejsze tagi znikną.

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

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

Aby dodać tagi do zasobu, który ma już tagi, użyj polecenia az tag update. --operation Ustaw parametr na Merge.

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

Zwróć uwagę, że istniejące tagi rosną wraz z dodawaniem dwóch nowych tagów.

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

Każda nazwa tagu może mieć tylko jedną wartość. Jeśli podasz nową wartość tagu, nowy tag zastępuje starą wartość, nawet jeśli używasz operacji scalania. Poniższy przykład zmienia Status tag z Normalny na Zielony.

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

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

Po ustawieniu parametru --operation na Replacewartość , nowy zestaw tagów zastępuje istniejące tagi.

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

Tylko nowe tagi pozostają w zasobie.

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

Te same polecenia działają również z grupami zasobów lub subskrypcjami. Przekaż je w identyfikatorze grupy zasobów lub subskrypcji, którą chcesz oznaczyć.

Aby dodać nowy zestaw tagów do grupy zasobów, użyj:

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

Aby zaktualizować tagi dla grupy zasobów, użyj:

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

Aby dodać nowy zestaw tagów do subskrypcji, użyj:

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

Aby zaktualizować tagi dla subskrypcji, użyj:

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

Tworzenie listy tagów

Aby pobrać tagi zasobu, grupy zasobów lub subskrypcji, użyj polecenia az tag list i przekaż identyfikator zasobu jednostki.

Aby wyświetlić tagi zasobu, użyj:

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

Aby wyświetlić tagi dla grupy zasobów, użyj:

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

Aby wyświetlić tagi subskrypcji, użyj:

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

Wyświetlanie listy według tagu

Aby uzyskać zasoby o określonej nazwie i wartości tagu, użyj:

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

Aby uzyskać zasoby o określonej nazwie tagu z dowolną wartością tagu, użyj:

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

Aby uzyskać grupy zasobów, które mają określoną nazwę i wartość tagu, użyj:

az group list --tag Dept=Finance

Usuwanie tagów

Aby usunąć określone tagi, użyj az tag update polecenia i ustaw wartość --operationDelete. Przekaż identyfikator zasobu tagów, które chcesz usunąć.

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

Usunięto określone tagi.

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

Aby usunąć wszystkie tagi, użyj polecenia az tag delete .

az tag delete --resource-id $resource

Obsługa spacji

Jeśli nazwy tagów lub wartości zawierają spacje, należy je ująć w cudzysłów.

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

Następne kroki