tocdepth: 2

GetObjectRetention

Позволяет получить информацию о текущей настройке временной блокировки объекта в версионируемом бакете.

Запрос
Ответ
- Коды ответа
- Пример ответа

Запрос 

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

Path-параметры 

Параметр	Описание
`bucket`	Название бакета.
`key`	Ключ объекта.

Query-параметры 

Параметр	Описание
`retention`	Обязательный параметр для обозначения типа операции.
`versionId`	Идентификатор версии объекта.

Заголовки 

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

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

Запрос получает информацию о текущей настройке временной блокировки объекта в формате XML.

GET /my-bucket/my-file.txt?versionId=000625C32E65A0BF&retention=null HTTP/1.1
Host: s3.cloud.ru
X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
X-Amz-Date: 20241031T113941Z
Authorization: authorization string

Ответ 

Коды ответа 

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

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

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

HTTP/1.1 200 OK
Response Headers
Server: nginx
Date: Thu, 31 Oct 2024 11:39:41 GMT
Content-Type: application/xml; charset=UTF-8
Transfer-Encoding: chunkedConnection: keep-alive
Keep-Alive: timeout=60
X-Amz-Request-Id: 9c52983ef85fbd1c
X-Amz-Version-Id: 000625C32E65A0BF
Content-Encoding: gzip
<?xml version="1.0" encoding="UTF-8"?>
<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
 <Mode>GOVERNANCE</Mode>
 <RetainUntilDate>2024-10-31T11:40:00Z</RetainUntilDate>
</Retention>

См.также

PutObjectRetention

Была ли статья полезной?

Спасибо за отзыв! Что можно улучшить?

GetObjectRetention