Tagging
Методы для работы с маркировкой объектов тегами:
- PutObjectTagging — Добавить или изменить тег объекта.
- GetObjectTagging — Получить тег объекта.
- DeleteObjectTagging — Удалить все теги объекта.
Добавляет теги к существующему объекту. Если у объекта есть теги, они заменяются указанными новыми тегами. Тег — это пара ключ/значение.
Тело запроса:
<?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>
Параметры запроса:
Параметр | Тип | Описание |
|---|---|---|
| ||
| repeating complex element | Тег, состоящий из ключа |
| xs:string (string) | Ключ тега |
| xs:string (string) | Значение тега |
Код успешного ответа
HTTP: 200 OK.
Коды ошибок
Код ошибки | Описание | HTTP-код статуса |
|---|---|---|
InternalError | Внутренняя ошибка | 500 Internal Error |
AccessDenied | Доступ запрещен. ID учетной записи не соответствует владельцу бакета | 400 Bad Request |
MalformedXML | XML запроса не соответствует схеме | 400 Bad Request |
MissingRequestBodyError | Пустое тело запроса | 400 Bad Request |
BadRequest | В запросе количество тегов больше установленного лимита | 400 Bad Request |
Возвращает набор тегов объекта.
Пример запроса:
GET /{Key+}?tagging HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com
Пример ответа:
HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><Tagging><TagSet><Tag><Key>key-object1</Key><Value>value-object1</Value></Tag><Key>key-object2</Key><Value>value-object2</Value></Tag></TagSet></Tagging>
Удаляет весь набор тегов из указанного объекта.
Пример запроса:
DELETE /{Key+}?tagging HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com
Код успешного ответа
HTTP: 204.