Связаться с намиПодключиться

Метод putObjectLockConfiguration

Статья создана
Обновлена 15 августа 2025 г.

Настраивает механизм блокировок версий объектов в версионируемом бакете: включает или выключает механизм и настраивает блокировки по умолчанию.

Примечание

Блокировка версий объектов невозможна в бакетах с выключенным или приостановленным версионированием.

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

Когда механизм блокировок включен, вы можете установить на версию объекта блокировку, то есть запрет на удаление или перезапись:

Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.

Запрос

PUT /{bucket}?object-lock HTTP/2

Path параметры

Параметр Описание
bucket Имя бакета.

Заголовки

Используйте в запросе только общие заголовки.

Схема данных

<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>&#34;f75a361db63aa4722fb8e083********&#34;</ETag>
              <Size>103</Size>
              <StorageClass>STANDARD</StorageClass>
              <TagSet></TagSet>
          </Contents>
      </ListBucketResult>
Элемент Описание
ObjectLockConfiguration

Корневой элемент.

Чтобы выключить механизм блокировок, передайте этот параметр с пустым значением, например <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>&#34;f75a361db63aa4722fb8e083********&#34;</ETag> <Size>103</Size> <StorageClass>STANDARD</StorageClass> <TagSet></TagSet> </Contents> </ListBucketResult>.

Путь: ObjectLockConfiguration.
ObjectLockEnabled

Статус механизма блокировок:

  • Enabled — механизм блокировок включен.

Если элемент не указан, будет выведено сообщение об ошибке InvalidRequest, а механизм блокировок не включится.

Путь: ObjectLockConfiguration\ObjectLockEnabled.
Rule

Настройки блокировок.

Путь: ObjectLockConfiguration\Rule.
DefaultRetention

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

Путь: ObjectLockConfiguration\Rule\DefaultRetention.
Mode

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

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

Путь: ObjectLockConfiguration\Rule\DefaultRetention\Mode.
Days

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

Путь: ObjectLockConfiguration\Rule\DefaultRetention\Days.
Years

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

Путь: ObjectLockConfiguration\Rule\DefaultRetention\Years.

Ответ

Заголовки

Ответ может содержать только общие заголовки.

Коды ответов

Перечень возможных ответов смотрите в разделе Ответы.

См. также

Предыдущая
listObjectVersions
Следующая
getObjectLockConfiguration