Метод putObjectLockConfiguration
Настраивает механизм блокировок версий объектов в версионируемом бакете: включает или выключает механизм и настраивает блокировки по умолчанию.
Когда механизм блокировок включен, вы можете установить на версию объекта блокировку, то есть запрет на удаление или перезапись:
- при загрузке объекта (метод upload);
- после загрузки объекта (методы putObjectRetention и putObjectLegalHold).
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}?object-lock HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
Заголовки
Используйте в запросе только общие заголовки.
Схема данных
<ObjectLockConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<ObjectLockEnabled>string</ObjectLockEnabled>
<Rule>
<DefaultRetention>
<Mode>string</Mode>
<Days>integer</Days>
<Years>integer</Years>
</DefaultRetention>
</Rule>
</ObjectLockConfiguration>
| Элемент | Описание |
|---|---|
ObjectLockConfiguration |
Корневой элемент. Чтобы выключить механизм блокировок, передайте этот параметр с пустым значением, например Путь: |
ObjectLockEnabled |
Статус механизма блокировок:
Если элемент не указан, будет выведено сообщение об ошибке Путь: |
Rule |
Настройки блокировок. Путь: |
DefaultRetention |
Настройки блокировок по умолчанию. Путь: |
Mode |
Тип блокировки по умолчанию:
Путь: |
Days |
Срок блокировки по умолчанию в днях от момента загрузки версии объекта. Должен быть положительным целым числом. Нельзя указывать вместе с Путь: |
Years |
Срок блокировки по умолчанию в годах от момента загрузки версии объекта. Должен быть положительным целым числом. Нельзя указывать вместе с Путь: |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.