Метод putBucketEncryption
Статья создана
Обновлена 6 сентября 2024 г.
Добавляет шифрование бакету. Объекты, добавляемые в этот бакет, будут по умолчанию шифроваться указанным ключом KMS. Подробнее о шифровании бакета читайте в разделе Шифрование в Object Storage.
Подробнее о подготовке к работе с API и общем виде запроса см. в разделе Как пользоваться S3 API.
Запрос
PUT /{bucket}?encryption HTTP/2
Path параметры
| Параметр | Описание |
|---|---|
bucket |
Имя бакета. |
Заголовки
Используйте в запросе только общие заголовки.
Ответ
Заголовки
Ответ может содержать только общие заголовки.
Коды ответов
Перечень возможных ответов смотрите в разделе Ответы.
Успешный ответ содержит дополнительные данные в формате XML, схема которого описана ниже.
Схема данных
<ServerSideEncryptionConfiguration>
<Rule>
<ApplyServerSideEncryptionByDefault>
<KMSMasterKeyID>string</KMSMasterKeyID>
<SSEAlgorithm>string</SSEAlgorithm>
</ApplyServerSideEncryptionByDefault>
</Rule>
...
</ServerSideEncryptionConfiguration>
| Элемент | Описание |
|---|---|
ApplyServerSideEncryptionByDefault |
Указание применить к объекту шифрование по умолчанию, если в запросе не указаны другие параметры шифрования. Путь: ServerSideEncryptionConfiguration\Rule\ApplyServerSideEncryptionByDefault. |
KMSMasterKeyID |
Идентификатор ключа KMS. Путь: ServerSideEncryptionConfiguration\Rule\ApplyServerSideEncryptionByDefault\KMSMasterKeyID. |
Rule |
Правило шифрования на стороне сервера. Шифрование определяется элементами KMSMasterKeyID и SSEAlgorithm.Путь: ServerSideEncryptionConfiguration\Rule. |
ServerSideEncryptionConfiguration |
Конфигурация шифрования, по умолчанию применяемая к новым объектам в бакете. Путь: ServerSideEncryptionConfiguration. |
SSEAlgorithm |
Алгоритм шифрования. Доступные значения: aws:kms.Путь: ServerSideEncryptionConfiguration\Rule\ApplyServerSideEncryptionByDefault\SSEAlgorithm. |