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

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

Предыдущая статья

PutObjectLegalHold

Следующая статья

PutObjectRetention