Метод getObjectRetention
Статья создана
Обновлена 6 сентября 2024 г.
Возвращает настройки временной блокировки, установленной на версию объекта.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
GET /{bucket}/{key}?retention&versionId={versionId} HTTP/2
Path-параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query-параметры
| Параметр | Описание |
|---|---|
retention |
Обязательный параметр для обозначения типа операции. |
versionId |
Идентификатор версии объекта. Обязательный параметр. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Схема данных
<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Mode>string</Mode>
<RetainUntilDate>timestamp</RetainUntilDate>
</Retention>
| Элемент | Описание |
|---|---|
Mode |
Тип блокировки:
Путь: |
RetainUntilDate |
Дата и время окончания блокировки в формате RFC3339. Например, Путь: |