PutBucketEncryption
更新时间 2026-04-10 20:09:08
最近更新时间: 2026-04-10 20:09:08
功能说明
PutBucketEncryption请求设置存储桶默认加密功能。
注意事项
若使用KMS加密算法，需要资源池对接KMS服务，支持的线上资源池参考产品能力地图。
请求消息样式
PUT /{Bucket}?encryption HTTP/1.1
Host: xxxx.zos.ctyun.cn
Accept-Encoding: Identity
X-Amz-Content-SHA256: Content-SHA256
X-Amz-Date: Date
Content-Length: Content-Length
Content-MD5: Content-MD5
Authorization: Auth String
<?xml version="1.0" encoding="UTF-8"?>
<ServerSideEncryptionConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Rule>
<ApplyServerSideEncryptionByDefault>
<KMSMasterKeyID>string</KMSMasterKeyID>
<SSEAlgorithm>string</SSEAlgorithm>
</ApplyServerSideEncryptionByDefault>
</Rule>
</ServerSideEncryptionConfiguration>请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释： 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头，请参见如何调用API-构造请求-请求消息头。
请求消息元素
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| ServerSideEncryptionConfiguration | 参数解释： 指定默认的服务端加密配置。 | Container | 是 |
表ServerSideEncryptionConfiguration
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Rule | 参数解释： 服务端加密配置规则信息。 | Container | 是 |
表Rule
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| ApplyServerSideEncryptionByDefault | 参数解释： 指定默认的服务端加密配置，若上传对象时请求中未指定任何加密信息，则会使用该加密配置。 | Container | 否 |
表ApplyServerSideEncryptionByDefault
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| SSEAlgorithm | 参数解释： 加密算法。 取值范围： 仅支持AES256和aws:kms。 | String | 是 |
| KMSMasterKeyID | 参数解释： 加密密钥。 约束限制： - 若加密算法选用的是aws:kms，则此项必填，参数格式为"{密钥管理服务处的密钥ID}::::{userID}"，其中userId是用户的ctyun账号id。 - 若加密算法选用的是AES256，则此项可不填，若填，则字符长度需为32。 | String | 否 |
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: Request Id
Content-Type: application/xml
Content-Length: 0
Date: Date
Connection: Keep-Alive响应消息头
该请求的响应消息使用公共的响应消息头，请参见如何调用API-响应结果-响应消息头。
响应消息元素
该请求的响应中不带有响应元素。
错误码
请参见调用前必知-错误码-全局错误码。
