Spec-Zone.ru › AWS CLI v2

[ aws . sesv2 ]

tag-resource

Описание

Добавить один или несколько тегов (ключей и значений) к указанному ресурсу. Тег — это метка, которую вы можете необязательно определить и связать с ресурсом. Теги помогают вам категоризировать и управлять ресурсами различными способами, например, по назначению, владельцу, среде или другим критериям. Один ресурс может иметь до 50 тегов.

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

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

Синтаксис

  tag-resource
--resource-arn <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-arn (строка)

Amazon Resource Name (ARN) ресурса, к которому вы хотите добавить один или несколько тегов.

--tags (список)

Список тегов, которые вы хотите добавить к ресурсу. Тег состоит из обязательного ключа тега (Key ) и связанного с ним значения тега (Value ). Максимальная длина ключа тега составляет 128 символов. Максимальная длина значения тега — 256 символов.

(структура)

Объект, определяющий теги, связанные с ресурсом. Тег — это метка, которую вы можете необязательно определить и связать с ресурсом. Теги помогают вам категоризировать и управлять ресурсами различными способами, например, по назначению, владельцу, среде или другим критериям. Один ресурс может иметь до 50 тегов.

Каждый тег состоит из обязательного ключа тега и связанного с ним значения тега, оба из которых вы определяете. Ключ тега — это общая метка, которая служит категорией для более конкретного значения тега. Значение тега служит описателем в рамках ключа тега. Ключ тега может содержать до 128 символов. Значение тега может содержать до 256 символов. Символы могут быть буквами, цифрами, пробелами Unicode или одним из следующих символов: _ . : / = + -. К тегам применяются следующие дополнительные ограничения:

  • Ключи и значения тегов чувствительны к регистру.
  • Для каждого связанного ресурса ключ каждого тега должен быть уникальным, и он может иметь только одно значение.
  • Префикс aws: зарезервирован для использования Amazon Web Services; вы не можете использовать его в ключах или значениях тегов, которые вы определяете. Кроме того, вы не можете редактировать или удалять ключи или значения тегов, использующих этот префикс. Теги, использующие этот префикс, не учитываются при подсчете лимита в 50 тегов на ресурс.
  • Вы можете связать теги с общедоступными или совместно используемыми ресурсами, но теги доступны только для вашей учетной записи Amazon Web Services, а не для других учетных записей, которые совместно используют ресурс. Кроме того, теги доступны только для ресурсов, которые находятся в указанной области Amazon Web Services для вашей учетной записи Amazon Web Services.

Ключ -> (строка)

Одна часть пары «ключ-значение», которая определяет тег. Максимальная длина ключа тега — 128 символов. Минимальная длина — 1 символ.

Значение -> (строка)

Необязательная часть пары «ключ-значение», которая определяет тег. Максимальная длина значения тега — 256 символов. Минимальная длина — 0 символов. Если вы не хотите, чтобы ресурс имел определённое значение тега, не указывайте значение для этого параметра. Если вы не укажете значение, Amazon SES установит значение в пустую строку.

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

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
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

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

--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.

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API