VK Object Storage logo
Помощь
Обновлена 17 июля 2026 г. в 15:35

Encryption

Методы для работы с шифрованием объектов:

  • GetBucketEncryption — получить конфигурацию шифрования, установленную на бакет.
  • PutBucketEncryption — установить шифрование объектов на бакет.
  • DeleteBucketEncryption — удалить шифрование объектов.

GetBucketEncryption

Метод GetBucketEncryption возвращает конфигурацию шифрования, установленную на бакет.

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

GET /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-expected-bucket-owner: ExpectedBucketOwner

Пример успешного ответа:

HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><ServerSideEncryptionConfiguration>   <Rule>      <ApplyServerSideEncryptionByDefault>         <KMSMasterKeyID>string</KMSMasterKeyID>         <SSEAlgorithm>string</SSEAlgorithm>      </ApplyServerSideEncryptionByDefault>      <BucketKeyEnabled>boolean</BucketKeyEnabled>   </Rule>   ...</ServerSideEncryptionConfiguration>

Код ошибки

HTTP: 400. Ошибка ServerSideEncryptionConfigurationNotFoundError — отсутствие конфигурации по умолчанию.

PutBucketEncryption

Метод PutBucketEncryption устанавливает шифрование для бакета по умолчанию. Если шифрование не устанавливало, новые объекты при загрузке в бакет не шифруются. Генерация и расшифровка ключей производится KMS. Используемый алгоритм шифрования AES256.

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

PUT /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comContent-MD5: ContentMD5x-amz-sdk-checksum-algorithm: ChecksumAlgorithmx-amz-expected-bucket-owner: ExpectedBucketOwner<?xml version="1.0" encoding="UTF-8"?><ServerSideEncryptionConfiguration xmlns="<http://hb.bizmrg.com/doc/2006-03-01/>">					      <Rule>                  <ApplyServerSideEncryptionByDefault>                     <SSEAlgorithm>AES256</SSEAlgorithm>                  </ApplyServerSideEncryptionByDefault>               </Rule>            </ServerSideEncryptionConfiguration>

Path параметры

Параметр

Обязательный

Тип данных

Значение

Описание

Bucket

Да

bucket-name

 

 

SSEAlgorithm

Да

enum

AES256

Алгоритм шифрования на стороне сервера, используемый при хранении. При добавлении заголовка объект, сохраненный в бакете, должен быть зашифрован на стороне сервера

Код ответа

HTTP: 200 OK.

DeleteBucketEncryption

Метод DeleteBucketEncryption удаляет установленную на бакет конфигурацию шифрования объектов, если она задана.

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

DELETE /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-expected-bucket-owner: ExpectedBucketOwner

Код ответа

HTTP: 204 No Content — сервер успешно обработал запрос.