tocdepth

2

PutObjectRetention

Позволяет установить или изменить временную блокировку объекта в версионируемом бакете.

Запрос

PUT /{bucket}/{key}?retention&versionId=VersionId HTTP/1.1

Path-параметры

Параметр

Описание

bucket

Название бакета.

key

Ключ объекта.

Query-параметры

Параметр

Описание

retention

Обязательный параметр для обозначения типа операции.

versionId

Идентификатор версии объекта.

Заголовки

Список поддерживаемых заголовков приведен в разделе Заголовки запросов.

Пример запроса

Запрос позволяет установить или изменить временную блокировку объекта.

PUT /my-bucket/my-file.txt?versionId=000625C32E65A0BF&retention=null HTTP/1.1
Host: s3.cloud.ru
Content-Type: application/xml
X-Amz-Content-Sha256: beaead3198f7da1e70d03ab969765e0821b24fc913697e929e726aeaebf0eba3
X-Amz-Date: 20241031T112716Z
Authorization: authorization string
Content-Length: 161
<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
   <Mode>GOVERNANCE</Mode>
   <RetainUntilDate>2024-10-31T11:30:00Z</RetainUntilDate>
</Retention>

Ответ

Коды ответа

Список возможных ответов собран в разделе Ответы.

Пример ответа

Пример ответа на запрос.

HTTP/1.1 200 OK
Response Headers
Server: nginx
Date: Thu, 31 Oct 2024 11:38:26 GMT
Content-Type: application/xml; charset=UTF-8
Content-Length: 270
Connection: keep-alive
Keep-Alive: timeout=60
X-Amz-Request-Id: 369b35aaae25529f

См.также

GetObjectRetention

Запустили Evolution free tier
для Dev & Test
Получить