put-bucket-tagging

Описание

Устанавливает метки для ведра.

Используйте метки, чтобы структурировать ваш счёт Amazon Web Services, отразив вашу собственную структуру затрат. Для этого зарегистрируйтесь, чтобы получить счёт вашего аккаунта Amazon Web Services с включёнными значениями ключей меток. Затем, чтобы увидеть стоимость объединённых ресурсов, организуйте вашу платёжную информацию по ресурсам с одинаковыми значениями ключей меток. Например, вы можете пометить несколько ресурсов определённым именем приложения, а затем организовать платёжную информацию, чтобы увидеть общую стоимость этого приложения по нескольким сервисам. Для получения дополнительной информации см. Раздел «Распределение затрат и метки» и «Использование распределения затрат в метках ведёр Amazon S3» .

Для использования этой операции, у вас должны быть разрешения на выполнение действия s3:PutBucketTagging. Владелец ведра имеет это разрешение по умолчанию и может предоставить его другим. Для получения дополнительной информации о разрешениях см. Раздел «Разрешения, относящиеся к операциям с подресурсами ведра» и «Управление разрешениями доступа к вашим ресурсам Amazon S3» .

• InvalidTag - Предоставленная метка не является допустимой меткой. Эта ошибка может возникнуть, если метка не прошла проверку входных данных. Для получения дополнительной информации см. «Использование распределения затрат в метках ведёр Amazon S3» .
• MalformedXML - Предоставленный XML не соответствует схеме.
• OperationAborted - В настоящее время выполняется конфликтная условная операция с этим ресурсом. Пожалуйста, повторите попытку.
• InternalError - Сервис не смог применить предоставленную метку к ведру.

Следующие операции связаны с PutBucketTagging :

• GetBucketTagging
• DeleteBucketTagging

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

Синопсис

  put-bucket-tagging
--bucket <value>
[--content-md5 <value>]
[--checksum-algorithm <value>]
--tagging <value>
[--expected-bucket-owner <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]

Параметры

--bucket (строка)

--content-md5 (строка)

--checksum-algorithm (строка)

--tagging (структура)

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

TagSet=[{Key=string,Value=string},{Key=string,Value=string}]

Синтаксис JSON:

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

--expected-bucket-owner (строка)

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

Примеры

Следующая команда применяет конфигурацию меток к ведру с именем amzn-s3-demo-bucket:

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging file://tagging.json

Файл tagging.json — это JSON-документ в текущей папке, который определяет метки:

{
   "TagSet": [
     {
       "Key": "organization",
       "Value": "marketing"
     }
   ]
}

Или примените конфигурацию меток к amzn-s3-demo-bucket непосредственно с командной строки:

aws s3api put-bucket-tagging --bucket amzn-s3-demo-bucket --tagging 'TagSet=[{Key=organization,Value=marketing}]'

Вывод

Отсутствует