Метод putObjectTagging
Статья создана
Обновлена 6 сентября 2024 г.
Добавляет метки объекту в бакете. При этом перезаписываются все имеющиеся у объекта метки.
Примечание
В терминологии Yandex Cloud для логической маркировки ресурсов используется понятие метка (label). Object Storage поддерживает совместимость с Amazon S3 API, поэтому в командах для AWS CLI и в параметрах API применяется термин AWS — тег (tag).
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}/{key}?tagging&versionId={versionId} HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query-параметры
| Параметр | Описание |
|---|---|
tagging |
Тип операции. Обязательный параметр. |
versionId |
Идентификатор версии объекта. Обязательный параметр. |
Схема данных
<?xml version="1.0" encoding="UTF-8" ?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<TagSet>
<Tag>
<Key>string</Key>
<Value>string</Value>
</Tag>
</TagSet>
</Tagging>
| Элемент | Описание |
|---|---|
Tagging |
Корневой элемент. |
TagSet |
Массив меток. |
Tag |
Контейнер для метки. |
Key |
Ключ метки. Тип: string. |
Value |
Значение метки. Тип: string. |
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Кроме общих заголовков, ответ может содержать:
| Заголовок | Описание |
|---|---|
x-amz-version-id |
Идентификатор версии объекта. |
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ не содержит дополнительных данных.