GetBucketEncryption
GetBucketEncryption接口用于获取Bucket加密规则。
请求语法
Get /?encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
响应元素
名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
ServerSideEncryptionRule | 容器 | 是 |
服务端加密规则的容器。 子元素:ApplyServerSideEncryptionByDefault |
ApplyServerSideEncryptionByDefault | 容器 | 是 |
服务端默认加密方式的容器。 子元素:SSEAlgorithm,KMSMasterKeyID |
SSEAlgorithm | 字符串 | 是 |
显示服务端默认加密方式。 取值:KMS、AES256 |
KMSMasterKeyID | 字符串 | 否 | 显示当前使用的KMS密钥ID。仅当SSEAlgorithm为KMS且指定了密钥ID时返回,其他情况下,取值为空。 |
细节分析
- 只有Bucket的拥有者及授权子账户才能查看Bucket的加密规则,否则返回403 Forbidden错误,错误码:AccessDenied。
- 如果Bucket不存在,返回404错误。错误码:NoSuchBucket。
- 如果Bucket未设置加密规则,返回404错误。错误码:NoSuchServerSideEncryptionRule。
示例
- 请求示例
Get /?encryption HTTP/1.1 Date: Tue, 20 Dec 2018 11:20:10 GMT Host: oss-example.oss-cn-hangzhou.aliyuncs.com Authorization: OSS qn6qrrqxo2oawuk53otf****:ceOEyZavKY4QcjoUWYSpYbJ3****
- 返回示例
HTTP/1.1 204 NoContent x-oss-request-id: 5C1B138A109F4E405B2D8AEF Date: Tue, 20 Dec 2018 11:22:05 GMT <?xml version="1.0" encoding="UTF-8"?> <ServerSideEncryptionRule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>KMS</SSEAlgorithm> <KMSMasterKeyID>9468da86-3509-4f8d-a61e-6eab1eac****</KMSMasterKeyID> </ApplyServerSideEncryptionByDefault> </ServerSideEncryptionRule>
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论