Поделиться через

az tag

Управление тегами в ресурсе.

Команды

Имя Описание Тип Состояние
az tag add-value

Создайте значение тега.

 Core GA
az tag create

Создайте теги для определенного ресурса.

 Core GA
az tag delete

Удаление тегов в определенном ресурсе.

 Core GA
az tag list

Перечислите весь набор тегов в определенном ресурсе.

 Core GA
az tag remove-value

Удаляет предопределенное значение тега для предопределенного имени тега.

 Core GA
az tag update

Выборочно обновите набор тегов в определенном ресурсе.

 Core GA

az tag add-value

Изменить

Создайте значение тега.

az tag add-value --name
                 --value

Примеры

Создайте значение тега.

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

Обязательные параметры

--name -n

Имя тега.

--value

Значение тега.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az tag create

Изменить

Создайте теги для определенного ресурса.

Команда az tag create с идентификатором создает или обновляет весь набор тегов в ресурсе, группе ресурсов или подписке. Эта операция позволяет добавлять или заменять весь набор тегов на указанный ресурс, группу ресурсов или подписку. Указанная сущность может содержать не более 50 тегов. Обратите внимание: "создание тега" действует как "tag init", поэтому теги, созданные с помощью этой команды, являются единственными, которые присутствуют после выполнения.

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

Примеры

Создайте тег в подписке.

az tag create --name MyTag

Создайте или обновите весь набор тегов в подписке.

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

Создайте или обновите весь набор тегов в группе ресурсов.

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

Создайте или обновите весь набор тегов в ресурсе.

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Имя создаваемого тега.

--resource-id

Идентификатор ресурса для сущности, помеченной тегом. Ресурс, группа ресурсов или подписка могут быть помечены.

--tags

Теги, применяемые к ресурсу.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Вы можете настроить подписку по умолчанию с помощью команды az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az tag delete

Изменить

Удаление тегов в определенном ресурсе.

Команда az tag delete с идентификатором удаляет весь набор тегов в ресурсе, группе ресурсов или подписке.

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

Примеры

Удалите предопределенный тег из подписки, не связанной с ресурсом или не имея значений тегов.

az tag delete --name MyTag

Удалите весь набор тегов в подписке.

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

Удалите весь набор тегов в группе ресурсов.

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

Удалите весь набор тегов в ресурсе. (Даже при использовании --name вместе с --resource-id для указания одного тега)

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Имя тега, который необходимо удалить.

--resource-id

Идентификатор ресурса для сущности, помеченной тегом. Ресурс, группа ресурсов или подписка могут быть помечены.

--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az tag list

Изменить

Перечислите весь набор тегов в определенном ресурсе.

Команда az tag list с идентификатором содержит весь набор тегов в ресурсе, группе ресурсов или подписке.

az tag list [--resource-id]

Примеры

Перечислите весь набор тегов в подписке.

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

Перечислите весь набор тегов в группе ресурсов.

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

Перечислите весь набор тегов в ресурсе.

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-id

Идентификатор ресурса для сущности, помеченной тегом. Ресурс, группа ресурсов или подписка могут быть помечены.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az tag remove-value

Изменить

Удаляет предопределенное значение тега для предопределенного имени тега.

Эта операция позволяет удалить значение из списка предопределенных значений для существующего предопределенного имени тега. Удаляемое значение не должно использоваться в качестве значения тега для заданного имени тега для любого ресурса.

az tag remove-value --name
                    --value

Обязательные параметры

--name -n

Имя тега.

--value

Значение тега.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az tag update

Изменить

Выборочно обновите набор тегов в определенном ресурсе.

Команда az tag update с идентификатором выборочно обновляет набор тегов в ресурсе, группе ресурсов или подписке. Эта операция позволяет заменить, объединить или выборочно удалить теги на указанный ресурс, группу ресурсов или подписку. Указанная сущность может иметь не более 50 тегов в конце операции. Параметр "replace" заменяет весь набор существующих тегов новым набором. Параметр merge позволяет добавлять теги с новыми именами и обновлять значения тегов с существующими именами. Параметр delete позволяет выборочно удалять теги на основе заданных имен или пар "имя-значение".

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

Примеры

Выборочно обновите набор тегов в подписке с помощью операции слияния.

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

Выборочно обновите набор тегов в группе ресурсов с помощью операции "Replace".

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

Выборочно обновите набор тегов в ресурсе с помощью операции delete.

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

Обязательные параметры

--operation

Операция обновления. Параметры слияния, замены и удаления.

Свойство Значение
Допустимые значения: Delete, Merge, Replace
--resource-id

Идентификатор ресурса для сущности, помеченной тегом. Ресурс, группа ресурсов или подписка могут быть помечены.

--tags

Теги, которые необходимо обновить в ресурсе.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False