GetBucketEncryption
更新时间 2026-04-10 20:09:08
最近更新时间: 2026-04-10 20:09:08
功能说明
GetBucketEncryption请求可以返回存储桶默认加密配置。若是存储桶不存在默认加密配置,则返回NoSuchEncryptionSetError。
请求消息样式
GET /{Bucket}?encryption HTTP/1.1
Host: xxxx.zos.ctyun.cn
Accept-Encoding: Identity
X-Amz-Content-Sha256: Content-SHA256
X-Amz-Date: Date
Authorization: Auth String请求消息参数
| 参数名称 | 参数描述 | 类型 | 是否必须 |
|---|---|---|---|
| Bucket | 参数解释: 桶的名称。 | String | 是 |
请求消息头
该请求使用公共的请求消息头,请参见如何调用API-构造请求-请求消息头。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
HTTP/1.1 Status Code
x-amz-request-id: Request Id
Content-Type: application/xml
Content-Length: Content-Length
Date: Thu, Date
Connection: Keep-Alive
<?xml version="1.0" encoding="UTF-8"?>
<ServerSideEncryptionConfiguration>
<Rule>
<ApplyServerSideEncryptionByDefault>
<KMSMasterKeyID>string</KMSMasterKeyID>
<SSEAlgorithm>string</SSEAlgorithm>
</ApplyServerSideEncryptionByDefault>
</Rule>
</ServerSideEncryptionConfiguration>响应消息头
该请求的响应消息使用公共的响应消息头,请参见如何调用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 |
错误码
请参见调用前必知-错误码-全局错误码。