Метод putObjectLegalHold
Статья создана
Обновлена 15 августа 2025 г.
Устанавливает на версию объекта бессрочную блокировку или снимает ее.
Чтобы на версии объектов можно было устанавливать блокировки, в бакете должен быть включен механизм блокировок. Включить его можно с помощью метода putObjectLockConfiguration.
Установить или снять блокировку могут пользователи с ролью storage.uploader. Проверить блокировку можно с помощью метода getObjectLegalHold.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}/{key}?legal-hold&versionId={versionId} HTTP/2
Path-параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
key |
Ключ объекта. |
Query-параметры
| Параметр | Описание |
|---|---|
legal-hold |
Обязательный параметр для обозначения типа операции. |
versionId |
Идентификатор версии объекта. Обязательный параметр. |
Заголовки
Используйте в запросе необходимые общие заголовки.
Схема данных
<ListBucketResult
xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<KeyCount>1</KeyCount>
<Name>my-sample-bucket</Name>
<Prefix></Prefix>
<MaxKeys>1000</MaxKeys>
<IsTruncated>false</IsTruncated>
<Contents>
<Key>text.txt</Key>
<LastModified>2025-05-15T07:23:08.030Z</LastModified>
<Owner>
<ID>ajegtlf2q28a********</ID>
<DisplayName>ajegtlf2q28a********</DisplayName>
</Owner>
<ETag>"f75a361db63aa4722fb8e083********"</ETag>
<Size>103</Size>
<StorageClass>STANDARD</StorageClass>
<TagSet></TagSet>
</Contents>
</ListBucketResult>
| Элемент | Описание |
|---|---|
Status |
Статус бессрочной блокировки:
Путь: |
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.