最近更新时间:2025-04-02 10:57:57
此接口用于为存储桶设置服务端加密。在存储桶设置服务端加密后,上传文件时,若没有指定文件的服务端加密方式,文件会默认继承存储桶的服务端加密方式。
创建桶加密必须是桶所有者(BucketOwner
)或者拥有PutBucketEncryption
权限。
关于服务端加密的更多信息,请参见加密。
请求语法
PUT /?encryption HTTP/1.1
Host: {Bucketname}.{endpoint}
Authorization: {SignatureValue}
Content-Type: application/xml
Content-Length: {length}
Date: {date}
<ServerSideEncryptionConfiguration>
<Rule>
<ApplyServerSideEncryptionByDefault>
<SSEAlgorithm>AES256</SSEAlgorithm>
</ApplyServerSideEncryptionByDefault>
</Rule>
</ServerSideEncryptionConfiguration>
请求参数
该请求消息中不使用消息参数。
请求消息头
该请求使用公共消息头。
请求体(XML)
<ServerSideEncryptionConfiguration>
<Rule>
<ApplyServerSideEncryptionByDefault>
<SSEAlgorithm>AES256</SSEAlgorithm>
</ApplyServerSideEncryptionByDefault>
</Rule>
</ServerSideEncryptionConfiguration>
参数名称 | 是否必选 | 参数描述 |
---|---|---|
ServerSideEncryptionConfiguration | 是 | 桶的默认加密配置的根元素。 |
Rule | 是 | 桶的默认加密配置的子元素。 |
ApplyServerSideEncryptionByDefault | 是 | 桶的默认加密配置的子元素。 |
SSEAlgorithm | 是 | 桶的默认加密配置要使用的服务端加密算法。 |
响应示例
HTTP/1.1 200 Ok
Server: ks3
Date: Tue, 07 Jul 2020 07:29:13 GMT
Content-Length: 11
报错信息
状态码 | 报错信息 | 错误原因 |
403 Forbidden | Access Denied | 没有权限/缺少权限。 |
403 Forbidden | SignatureDoesNotMatch | 签名计算有误;AK/SK填写错误。 |
400 BadRequest | MalformedXML | 设置的桶加密的XML格式有误。 |
400 BadParameter | InvalidArgument | 参数写错,例如AES256写成AES255。 |
纯净模式