功能描述

此接口用于为存储桶设置服务端加密。在存储桶设置服务端加密后，在该存储桶上传文件时，如果您没有指定文件的服务端加密方式，文件会默认继承存储桶的服务端加密方式。目前支持在存储桶配置 KMS 托管密钥的服务端加密（SSE-KMS）和 TOS 托管密钥的服务端加密（SSE-TOS）。

关于服务端加密的更多信息，请参见服务端加密概述。

注意事项

只能使用 HTTPS 协议调用 PutBucketEncryption 接口。

只有拥有 tos:PutBucketEncryption 权限的用户才能调用 PutBucketEncryption 接口。默认情况下，存储桶的所有者直接拥有 tos:PutBucketEncryption 权限，存储桶所有者也可以将该权限授予给其他用户。

分层桶暂不支持 PutBucketEncryption 接口。

请求消息样式

请求参数和消息头

该请求需要在消息头中设置请求元素的 Content-MD5 值，与上传的请求元素的 MD5 值进行比较，如果不相等，将返回错误。其他使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
encryption	Query	String	是	-	代表 PutBucketEncryption 请求的特殊标识。
Content-MD5	Header	String	是	XrY7u+Ae7tCTyyK7j1rNww==	消息体的 Base64MD5 摘要。

请求元素

名称	参数类型	是否必选	示例值	说明
Rule	Array	是	-	桶加密规则信息。
ApplyServerSideEncryptionByDefault	Array	是	-	服务端加密的配置信息。
SSEAlgorithm	String	是	AES256	服务端加密的默认加密方式，取值说明如下： kms：使用 SSE-KMS 加密方式。 AES256：使用 SSE-TOS 加密方式，并采用 AES256 加密算法。 SM4：使用 SSE-TOS 加密方式，并采用 SM4 加密算法。说明使用 SSE-KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，由 KMS 收取，更多信息，请参见 KMS 计费说明。仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 SSE-TOS 的 AES-256 算法；仅华北2（北京）、华东2（上海）支持 SSE-TOS 的 SM4 算法。
KMSDataEncryption	String	否	AES256	设置使用 SSE-KMS 加密方式时的加密算法，如果未设置，默认为 AES256 加密算法，取值说明如下： AES256： AES256 加密算法。 SM4: SM4 加密算法。说明仅华北2（北京）、华东2（上海）、亚太东南（柔佛）和亚太东南（雅加达）地域支持 SSE-KMS 的 AES-256 算法；仅华北2（北京）、华东2（上海）支持 SSE-KMS 的 SM4 算法。
KMSMasterKeyID	String	否	trn:kms:cn-beijing:200000*****:keyrings/ring-test/keys/key-test	指定 SSE-KMS 加密使用的主密钥，格式为 trn:kms:<region>:<accountID>:keyrings/<keyring>/keys/<key>，即 KMS 主密钥的 TRN，参数说明如下： region ：使用密钥所属 Region ID。 accountID ：密钥所属账号的 ID。 keyring ：密钥环别名。 key ：主密钥别名。说明您也可以在 KMS 控制台创建主密钥，然后单击密钥的名称，在密钥环详情页面密钥 TRN 及别名列下获取 KMSMasterKeyID。关于 KMS 密钥的详细介绍，请参见 KMS 快速入门。当 SSEAlgorithm 值为 kms 时，才需要设置 KMSMasterKeyID 参数。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

响应示例

对象存储