Udostępnij przez

az tag

Zarządzanie tagami w zasobie.

Polecenia

Nazwa Opis Typ Stan
az tag add-value

Utwórz wartość tagu.

 Core ogólna dostępność
az tag create

Tworzenie tagów dla określonego zasobu.

 Core ogólna dostępność
az tag delete

Usuwanie tagów w określonym zasobie.

 Core ogólna dostępność
az tag list

Wyświetl listę całego zestawu tagów dla określonego zasobu.

 Core ogólna dostępność
az tag remove-value

Usuwa wstępnie zdefiniowaną wartość tagu dla wstępnie zdefiniowanej nazwy tagu.

 Core ogólna dostępność
az tag update

Selektywnie zaktualizuj zestaw tagów dla określonego zasobu.

 Core ogólna dostępność

az tag add-value

Edytuj

Utwórz wartość tagu.

az tag add-value --name
                 --value

Przykłady

Utwórz wartość tagu.

az tag add-value --name MyTag --value MyValue

Parametry wymagane

--name -n

Nazwa tagu.

--value

Wartość tagu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az tag create

Edytuj

Tworzenie tagów dla określonego zasobu.

Polecenie az tag create z identyfikatorem tworzy lub aktualizuje cały zestaw tagów w zasobie, grupie zasobów lub subskrypcji. Ta operacja umożliwia dodawanie lub zastępowanie całego zestawu tagów w określonym zasobie, grupie zasobów lub subskrypcji. Określona jednostka może mieć maksymalnie 50 tagów. Uwaga: "tag create" działa jak "tag init", dlatego tagi utworzone za pomocą tego polecenia są jedynymi, które są obecne po wykonaniu.

az tag create [--name]
              [--resource-id]
              [--tags]

Przykłady

Utwórz tag w subskrypcji.

az tag create --name MyTag

Utwórz lub zaktualizuj cały zestaw tagów w subskrypcji.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Utwórz lub zaktualizuj cały zestaw tagów w grupie zasobów.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Utwórz lub zaktualizuj cały zestaw tagów w zasobie.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--name -n

Nazwa tagu do utworzenia.

--resource-id

Identyfikator zasobu jednostki, która jest oznaczana. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

--tags

Tagi do zastosowania w zasobie.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAZWA_LUB_IDENTYFIKATOR.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az tag delete

Edytuj

Usuwanie tagów w określonym zasobie.

Polecenie az tag delete z identyfikatorem usuwa cały zestaw tagów w zasobie, grupie zasobów lub subskrypcji.

az tag delete [--name]
              [--resource-id]
              [--yes]

Przykłady

Usuń wstępnie zdefiniowany tag z subskrypcji, która nie jest skojarzona z zasobem lub nie ma żadnych wartości tagów.

az tag delete --name MyTag

Usuń cały zestaw tagów w subskrypcji.

az tag delete --resource-id /subscriptions/{sub-id}

Usuń cały zestaw tagów w grupie zasobów.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Usuń cały zestaw tagów w zasobie. (Nawet użycie --name wraz z --resource-id w celu określenia pojedynczego tagu)

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--name -n

Nazwa tagu do usunięcia.

--resource-id

Identyfikator zasobu jednostki, która jest oznaczana. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az tag list

Edytuj

Wyświetl listę całego zestawu tagów dla określonego zasobu.

Polecenie az tag list z identyfikatorem wyświetla cały zestaw tagów w zasobie, grupie zasobów lub subskrypcji.

az tag list [--resource-id]

Przykłady

Wyświetl cały zestaw tagów w subskrypcji.

az tag list --resource-id /subscriptions/{sub-id}

Wyświetl cały zestaw tagów w grupie zasobów.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Wyświetl cały zestaw tagów w zasobie.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--resource-id

Identyfikator zasobu jednostki, która jest oznaczana. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az tag remove-value

Edytuj

Usuwa wstępnie zdefiniowaną wartość tagu dla wstępnie zdefiniowanej nazwy tagu.

Ta operacja umożliwia usunięcie wartości z listy wstępnie zdefiniowanych wartości dla istniejącej wstępnie zdefiniowanej nazwy tagu. Usunięta wartość nie może być używana jako wartość tagu dla danej nazwy tagu dla dowolnego zasobu.

az tag remove-value --name
                    --value

Parametry wymagane

--name -n

Nazwa tagu.

--value

Wartość tagu.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az tag update

Edytuj

Selektywnie zaktualizuj zestaw tagów dla określonego zasobu.

Polecenie az tag update z identyfikatorem selektywnie aktualizuje zestaw tagów w zasobie, grupie zasobów lub subskrypcji. Ta operacja umożliwia zastępowanie, scalanie lub selektywne usuwanie tagów w określonym zasobie, grupie zasobów lub subskrypcji. Określona jednostka może mieć maksymalnie 50 tagów na końcu operacji. Opcja "replace" zastępuje cały zestaw istniejących tagów nowym zestawem. Opcja "scalanie" umożliwia dodawanie tagów z nowymi nazwami i aktualizowanie wartości tagów przy użyciu istniejących nazw. Opcja "usuń" umożliwia selektywne usuwanie tagów na podstawie podanych nazw lub par nazwa/wartość.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Przykłady

Selektywnie zaktualizuj zestaw tagów w subskrypcji za pomocą operacji "scalania".

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Selektywnie zaktualizuj zestaw tagów w grupie zasobów za pomocą operacji "replace".

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Selektywne aktualizowanie zestawu tagów w zasobie za pomocą operacji usuwania.

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Parametry wymagane

--operation

Operacja aktualizacji. Opcje to Scalanie, Zastępowanie i Usuwanie.

Właściwość Wartość
Dopuszczalne wartości: Delete, Merge, Replace
--resource-id

Identyfikator zasobu jednostki, która jest oznaczana. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

--tags

Tagi, które mają zostać zaktualizowane w zasobie.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False