add-tags-to-resource

Описание

Добавляет или перезаписывает один или несколько тегов для указанного ресурса. Теги — это метаданные, которые можно назначить своим автоматизациям, документам, управляемым узлам, окнам технического обслуживания, параметрам хранилища параметров и эталонным образцам исправления. Теги позволяют категоризировать ресурсы по-разному, например, по назначению, владельцу или среде. Каждый тег состоит из ключа и необязательного значения, которые вы определяете. Например, можно определить набор тегов для управляемых узлов вашей учетной записи, что поможет отслеживать владельца и уровень стека каждого узла. Например:

• Key=Owner,Value=DbAdmin
• Key=Owner,Value=SysAdmin
• Key=Owner,Value=Dev
• Key=Stack,Value=Production
• Key=Stack,Value=Pre-Production
• Key=Stack,Value=Test

У большинства ресурсов может быть не более 50 тегов. У автоматизаций может быть не более 5 тегов.

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

Дополнительную информацию об использовании тегов с экземплярами Amazon Elastic Compute Cloud (Amazon EC2) см. в руководстве пользователя Amazon EC2 по тегированию ресурсов Amazon EC2.

См. также: Документацию API AWS

Синтаксис

  add-tags-to-resource
--resource-type <value>
--resource-id <value>
--tags <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--resource-type (строка)

--resource-id (строка)

--tags (список)

Сокращенный синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные JSON. Невозможно передать произвольные двоичные значения, используя значение, предоставленное JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод, не отправляя запрос API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, будет напечатан пример входного YAML, который можно использовать с --cli-input-yaml. Если указано со значением output, проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не является стабильным между версиями AWS CLI, и нет гарантии обратной совместимости в сгенерированном каркасе JSON.

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

--debug (булево)

Включить отладку.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команд.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/окружения.

--version (строка)

Показать версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

• on
• off
• auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/окружения.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, сопоставленного с двоичным блоком, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла непосредственно независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного формата cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (булево)

Отключить вывод страницы cli.

--cli-auto-prompt (булево)

Автоматически запрашивать входные данные CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы входных данных CLI.

Примеры

Пример 1: Добавление тегов к окну технического обслуживания

Следующий пример add-tags-to-resource добавляет тег к указанному окну технического обслуживания.

aws ssm add-tags-to-resource \
    --resource-type "MaintenanceWindow" \
    --resource-id "mw-03eb9db428EXAMPLE" \
    --tags "Key=Stack,Value=Production"

Эта команда не производит вывод.

Пример 2: Добавление тегов к параметру

Следующий пример add-tags-to-resource добавляет два тега к указанному параметру.

aws ssm add-tags-to-resource \
    --resource-type "Parameter" \
    --resource-id "My-Parameter" \
    --tags '[{"Key":"Region","Value":"East"},{"Key":"Environment", "Value":"Production"}]'

Эта команда не производит вывод.

Пример 3: Добавление тегов к документу SSM

Следующий пример add-tags-to-resource добавляет тег к указанному документу.

aws ssm add-tags-to-resource \
    --resource-type "Document" \
    --resource-id "My-Document" \
    --tags "Key=Quarter,Value=Q322"

Эта команда не производит вывод.

Дополнительная информация приведена в разделе «Назначение тегов ресурсам Systems Manager» в руководстве пользователя AWS Systems Manager.

Вывод

Нет