Object Lock
Методы для работы с блокировкой объектов:
- GetObjectLegalHold — Получить статус бессрочной блокировки.
- PutObjectLegalHold — Установить или снять бессрочную блокировку.
- GetObjectRetention — Получить статус временной блокировки.
- PutObjectRetention — Установить, настроить или снять временную блокировку.
- GetObjectLockConfiguration — Получить статус временной блокировки по умолчанию.
- PutObjectLockConfiguration — Установить, настроить или снять временную блокировку по умолчанию.
Возвращает статус бессрочной блокировки, установленной на объект.
Пример запроса:
GET /{Key+}?legal-hold HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com
Пример ответа:
HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><LegalHold><Status>string</Status></LegalHold>
Метод PutObjectLegalHold устанавливает или снимает бессрочную блокировку на объект.
Тело запроса:
<LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Status>string</Status></LegalHold>
Параметры запроса:
Параметр | Тип | Описание |
|---|---|---|
| complex element | Настройки бессрочной блокировки объекта |
| xs:string (enum) | Статус бессрочной блокировки:
|
Пример запроса:
PUT /{Key+}?legal-hold HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com<?xml version="1.0" encoding="UTF-8"?><LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Status>string</Status></LegalHold>
Получить статус временной блокировки, установленной на объект.
Пример запроса:
GET /{Key+}?retention HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com
Пример ответа:
HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><Retention><Mode>string</Mode><RetainUntilDate>timestamp</RetainUntilDate></Retention>
Метод PutObjectRetention устанавливает, настраивает или снимает временную блокировку на объект.
При выполнении метода для обхода временной управляемой блокировки укажите в запросе заголовок со значением x-amz-bypass-governance-retention.
Тело запроса:
<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Mode>string</Mode><RetainUntilDate>timestamp</RetainUntilDate></Retention>
Параметры запроса:
Параметр | Тип | Описание |
|---|---|---|
| complex element | Настройки временной блокировки объекта |
| xs:string (enum) | Тип блокировки:
|
| xs:dateTime | Дата и время истечения срока действия блокировки объекта в формате ISO8601 |
Пример запроса:
PUT /{Key+}?retention HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-bypass-governance-retention: BypassGovernanceRetention<?xml version="1.0" encoding="UTF-8"?>
Получить статус временной блокировки по умолчанию.
Пример запроса:
GET /?object-lock HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com
Пример ответа:
HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><ObjectLockConfiguration><ObjectLockEnabled>string</ObjectLockEnabled><Rule><DefaultRetention><Days>integer</Days><Mode>string</Mode><Years>integer</Years></DefaultRetention></Rule></ObjectLockConfiguration>
Метод PutObjectLockConfiguration используется для установки, настройки и снятия временной блокировки по умолчанию.
Тело запроса:
<ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><ObjectLockEnabled>string</ObjectLockEnabled><Rule><DefaultRetention><Days>integer</Days><Mode>string</Mode><Years>integer</Years></DefaultRetention></Rule></ObjectLockConfiguration>
Параметры запроса:
Параметр | Тип | Описание |
|---|---|---|
| ||
|
| Статус блокировки. |
|
| Правило блокировки по умолчанию |
|
| Параметр блокировки по умолчанию |
|
| Тип блокировки:
|
|
| Срок блокировки в днях от момента загрузки объекта. Нельзя указывать одновременно с |
|
| Срок блокировки в годах от момента загрузки объекта. Нельзя указывать одновременно с |
Пример запроса:
PUT /?object-lock HTTP/1.1Host: my-test-bucket1.hb.bizmrg.com<?xml version="1.0" encoding="UTF-8"?><ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><ObjectLockEnabled>string</ObjectLockEnabled><Rule><DefaultRetention><Days>integer</Days><Mode>string</Mode><Years>integer</Years></DefaultRetention></Rule></ObjectLockConfiguration>