文档中心

对象存储

服务端加密

GetBucketEncryption

GetBucketEncryption

功能描述

此接口用于获取指定存储桶的服务端加密配置。

注意事项

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

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

分层桶暂不支持 GetBucketEncryption 接口。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
encryption	Query	String	是	-	代表 GetBucketEncryption 请求的特殊标识。

请求元素

该请求不使用消息元素。

响应消息头

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

响应元素

名称	参数类型	示例值	说明
Rule	Array	-	桶加密规则信息。
ApplyServerSideEncryptionByDefault	Array	-	服务端加密的配置信息。
SSEAlgorithm	String	AES256	服务端加密的默认加密方式，取值说明如下： kms：使用 SSE-KMS 加密方式。 AES256：使用 SSE-TOS 加密方式，并采用 AES256 加密算法。 SM4：使用 SSE-TOS 加密方式，并采用 SM4 加密算法。说明使用 SSE-KMS 进行服务端加密会产生 API 调用费用，创建 KMS 密钥会产生密钥托管费用，由 KMS 收取，更多信息，请参见 KMS 计费说明。
KMSDataEncryption	String	AES256	使用 SSE-KMS 加密方式时的加密算法，取值说明如下： AES256： AES256 加密算法。 SM4: SM4 加密算法。
KMSMasterKeyID	String	trn:kms:cn-beijing:200000*****:keyrings/ring-test/keys/key-test	SSE-KMS 加密使用的主密钥。说明当 SSEAlgorithm 值为 kms 时，才会返回 KMSMasterKeyID 参数。

请求示例

响应示例

最近更新时间：2025.09.05 15:47:27

这个页面对您有帮助吗？

有用

有用

无用

无用