Метод putObjectLegalHold
Статья создана
Обновлена 6 сентября 2024 г.
Устанавливает на версию объекта бессрочную блокировку или снимает ее.
Чтобы на версии объектов можно было устанавливать блокировки, в бакете должен быть включен механизм блокировок. Включить его можно с помощью метода putObjectLockConfiguration.
Установить или снять блокировку могут пользователи с ролью storage.uploader
. Проверить блокировку можно с помощью метода getObjectLegalHold.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}/{key}?legal-hold&versionId={versionId} HTTP/2
Path-параметры
Параметр | Описание |
---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query-параметры
Параметр | Описание |
---|---|
legal-hold |
Обязательный параметр для обозначения типа операции. |
versionId |
Идентификатор версии объекта. Обязательный параметр. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Схема данных
<LegalHold xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Status>string</Status>
</LegalHold>
Элемент | Описание |
---|---|
Status |
Статус бессрочной блокировки:
Путь: |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.