GetBucketEncryption -

GetBucketEncryption介面用於擷取儲存空間（Bucket）的加密規則。

說明

只有Bucket的擁有者及授權的RAM使用者才能擷取Bucket的加密規則，否則返回403錯誤。有關Bucket加密的更多資訊，請參見伺服器端加密。

請求文法

Get /?encryption HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	描述
ServerSideEncryptionRule	容器	不涉及	服務端加密規則的容器。子項目：ApplyServerSideEncryptionByDefault
ApplyServerSideEncryptionByDefault	容器	不涉及	服務端預設加密方式的容器。子項目：SSEAlgorithm，KMSMasterKeyID
SSEAlgorithm	字串	KMS	顯示服務端預設加密方式。取值：KMS、AES256
KMSMasterKeyID	字串	9468da86-3509-4f8d-a61e-6eab1eac****	顯示當前使用的KMS密鑰ID。僅當SSEAlgorithm為KMS且指定了密鑰ID時返回，其他情況下，此項為空白。

樣本

請求樣本

Get /?encryption HTTP/1.1
Date: Tue, 20 Dec 2018 11:20:10 GMT
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************

返回樣本

以下返回樣本表明Bucket設定了SSE-KMS加密。

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>

SDK

GetBucketEncryption介面對應的各語言SDK如下：

錯誤碼

錯誤碼	HTTP狀態代碼	說明
AccessDenied	403	無擷取Bucket加密規則的許可權。
NoSuchBucket	400	指定擷取加密規則對應的Bucket不存在。
NoSuchServerSideEncryptionRule	400	Bucket未設定加密規則。