create-tags

Описание

Добавляет или перезаписывает только указанные метки для указанного ресурса или ресурсов Amazon EC2. При указании существующего ключа метки значение перезаписывается новым значением. Каждый ресурс может иметь не более 50 меток. Каждая метка состоит из ключа и необязательного значения. Ключи меток должны быть уникальными для каждого ресурса.

Дополнительную информацию о метках см. в руководстве пользователя Amazon Elastic Compute Cloud (Amazon Elastic Compute Cloud User Guide) в разделе Определение меток ресурсов Amazon EC2. Дополнительную информацию о создании политик IAM, которые контролируют доступ пользователей к ресурсам на основе меток, см. в разделе Поддерживаемые разрешения на уровне ресурсов для действий API Amazon EC2 в руководстве пользователя Amazon Elastic Compute Cloud (Amazon Elastic Compute Cloud User Guide).

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

Синтаксис

  create-tags
[--dry-run | --no-dry-run]
--resources <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]

Параметры

--dry-run | --no-dry-run (boolean)

--resources (список)

Синтаксис:

"string" "string" ...

--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 (boolean)

Включает отладку.

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

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (строка)

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

• json
• текст
• таблица
• yaml
• yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

Отображение версии этого инструмента.

--color (строка)

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

• включено
• выключено
• автоматически

--no-sign-request (boolean)

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

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

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 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 (boolean)

Отключить кли-пэджер для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Пример 1: Добавление метки к ресурсу

Следующий create-tags пример добавляет метку Stack=production к указанному изображению или перезаписывает существующую метку для AMI, где ключ метки — Stack.

aws ec2 create-tags \
    --resources ami-1234567890abcdef0 \
    --tags Key=Stack,Value=production

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

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

Следующий create-tags пример добавляет (или перезаписывает) две метки для AMI и экземпляра. Одна из меток имеет ключ (webserver), но без значения (значение установлено в пустую строку). Другая метка имеет ключ (stack) и значение (Production).

aws ec2 create-tags \
    --resources ami-1a2b3c4d i-1234567890abcdef0 \
    --tags Key=webserver,Value=   Key=stack,Value=Production

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

Пример 3: Добавление меток, содержащих специальные символы

В следующих create-tags примерах добавляется метка [Group]=test для экземпляра. Квадратные скобки ([ и ]) — специальные символы и должны быть экранированы. В следующих примерах также используется символ перевода строки, соответствующий каждой среде.

Если вы используете Windows, заключите элемент, содержащий специальные символы, в двойные кавычки («), а затем предваряйте каждый символ двойной кавычки обратной косой чертой (\) следующим образом.

aws ec2 create-tags ^
    --resources i-1234567890abcdef0 ^
    --tags Key=\"[Group]\",Value=test

Если вы используете Windows PowerShell, заключите элемент со значением, содержащим специальные символы, в двойные кавычки («), предваряйте каждый символ двойной кавычки обратной косой чертой (\), а затем заключите всю структуру ключа и значения в одинарные кавычки (’) следующим образом.

aws ec2 create-tags `
    --resources i-1234567890abcdef0 `
    --tags 'Key=\"[Group]\",Value=test'

Если вы используете Linux или OS X, заключите элемент, содержащий специальные символы, в двойные кавычки («), а затем заключите всю структуру ключа и значения в одинарные кавычки (’) следующим образом.

aws ec2 create-tags \
    --resources i-1234567890abcdef0 \
    --tags 'Key="[Group]",Value=test'

Дополнительную информацию см. в руководстве пользователя Amazon EC2 (Amazon EC2 User Guide) в разделе Определение меток ресурсов Amazon EC2.

Вывод

Нет