Object Lock

Методы для работы с блокировкой объектов:

  • GetObjectLegalHold — Получить статус бессрочной блокировки.
  • PutObjectLegalHold — Установить или снять бессрочную блокировку.
  • GetObjectRetention — Получить статус временной блокировки.
  • PutObjectRetention — Установить, настроить или снять временную блокировку.
  • GetObjectLockConfiguration — Получить статус временной блокировки по умолчанию.
  • PutObjectLockConfiguration — Установить, настроить или снять временную блокировку по умолчанию.

GetObjectLegalHold

Возвращает статус бессрочной блокировки, установленной на объект.

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

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

Метод PutObjectLegalHold устанавливает или снимает бессрочную блокировку на объект.

Тело запроса:

<LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Status>string</Status></LegalHold>

Параметры запроса:

Параметр

Тип

Описание

LegalHold

complex element

Настройки бессрочной блокировки объекта

LegalHold.Status

xs:string (enum)

Статус бессрочной блокировки:

  • ON — блокировка установлена
  • OFF — блокировка снят

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

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>

GetObjectRetention

Получить статус временной блокировки, установленной на объект.

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

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

Метод PutObjectRetention устанавливает, настраивает или снимает временную блокировку на объект.

При выполнении метода для обхода временной управляемой блокировки укажите в запросе заголовок со значением x-amz-bypass-governance-retention.

Тело запроса:

<Retention xmlns="http://s3.amazonaws.com/doc/2006-03-01/">   <Mode>string</Mode>   <RetainUntilDate>timestamp</RetainUntilDate></Retention>

Параметры запроса:

Параметр

Тип

Описание

Retention

complex element

Настройки временной блокировки объекта

Retention.Mode

xs:string (enum)

Тип блокировки:

  • GOVERNANCE — временная управляемая блокировка
  • COMPLIANCE — временная строгая блокировка

Retention.RetainUntilDate

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"?>

GetObjectLockConfiguration

Получить статус временной блокировки по умолчанию.

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

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

Метод 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>

Параметры запроса:

Параметр

Тип

Описание

ObjectLockConfiguration

ObjectLockEnabled

xs\:string (enum)

Статус блокировки. Enabled — включена

Rule

complex element

Правило блокировки по умолчанию

Rule.DefaultRetention

complex element

Параметр блокировки по умолчанию

Rule.DefaultRetention.Mode

xs\:string (enum)

Тип блокировки:

  • GOVERNANCE — временная управляемая блокировка
  • COMPLIANCE — временная строгая блокировка

Rule.DefaultRetention.Days

xs\:integer

Срок блокировки в днях от момента загрузки объекта. Нельзя указывать одновременно с Years

Rule.DefaultRetention.Years

xs\:integer

Срок блокировки в годах от момента загрузки объекта. Нельзя указывать одновременно с Days

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

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>