華為云計算 云知識 獲取桶的加密配置GetBucketEncryption
獲取桶的加密配置GetBucketEncryption
時間: 2023-08-16 14:20:16
猜你想看：
實時語音識別 云服務器配置 CDN是什么意思 視頻點播加速 什么是云桌面

 

接口說明

OBS使用GET操作來獲取指定桶的加密配置。

要正確執(zhí)行此操作,需要確保執(zhí)行者有GetEncryptionConfiguration權限。缺省情況下只有桶的所有者可以執(zhí)行此操作,也可以通過設置桶策略或用戶策略授權給其他用戶。

有關權限控制的更多信息請參考《 對象存儲服務 權限配置指南》的OBS權限控制概述章節(jié)。

URL
GET  https://obs.cn-north-4.myhuaweicloud.com/ 
請求參數(shù)
名稱 類型 IN 必選 描述
Authorization
 
 string header 是

請求消息中可帶的簽名信息。
Date
 
 string header 否

請求發(fā)起端的日期和時間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。
bucket_name
 
 string query 是

請求的桶名稱。
encryption
 
 string query 是

encryption表示請求桶的加密配置API。
返回參數(shù)
返回碼: 200

請求成功響應消息。

名稱 類型 必選 描述
Content-Length
 
 string 否

響應消息體的字節(jié)長度。
Connection
 
 string 否

指明與服務器的連接是長連接還是短連接。
Date
 
 string 否

OBS系統(tǒng)響應的時間。
ETag
 
 string 否

對象的base64編碼的128位MD5摘要。ETag是對象內(nèi)容的唯一標識,可以通過該值識別對象內(nèi)容是否有變化。比如上傳對象時ETag為A,下載對象時ETag為B,則說明對象內(nèi)容發(fā)生了變化。實際的ETag是對象的哈希值。ETag只反映變化的內(nèi)容,而不是其元數(shù)據(jù)。上傳的對象或拷貝操作創(chuàng)建的對象,通過MD5加密后都有唯一的ETag。如果通過多段上傳對象,則無論加密方法如何,MD5會拆分ETag,此類情況ETag就不是MD5的摘要。
x-obs-id-2
 
 string 否

幫助定位問題的特殊符號。
x-obs-request-id
 
 string 否

由OBS創(chuàng)建來唯一確定本次請求的值,可以通過該值來定位問題。
名稱 類型 必選 描述
ServerSideEncryptionConfiguration
 
 SetBucketEncryptionRequestBody object 否

桶的默認加密配置的根元素。
200 ServerSideEncryptionConfiguration
名稱 類型 必選 描述
Rule
 
 ServerSideEncryptionConfigurationRule object 是

桶的默認加密配置的子元素。
200 ServerSideEncryptionConfiguration.Rule
名稱 類型 必選 描述
ApplyServerSideEncryptionByDefault
 
 ApplyServerSideEncryptionByDefault object 是

桶的默認加密配置的子元素。
200 ServerSideEncryptionConfiguration.Rule.ApplyServerSideEncryptionByDefault
名稱 類型 必選 描述
SSEAlgorithm
 
 string 是

桶的默認加密配置要使用的服務端加密算法。
KMSMasterKeyID
 
 string 否

SSE-KMS加密方式下使用的KMS主密鑰,如果用戶沒有提供該頭域,那么默認的主密鑰將會被使用。

類型:字符串

有效值支持兩種格式:

regionID:domainID(帳號ID):key/key_id key_id 其中:

regionID是使用密鑰所屬region的ID,可在地區(qū)和終端節(jié)點頁面獲取; domainID是使用密鑰所屬帳號的帳號ID,獲取方法參見獲取帳號ID和用戶ID; key_id是從 數(shù)據(jù)加密 服務創(chuàng)建的密鑰ID,獲取方法請參見查看密鑰。
ProjectID
 
 string 否

SSE-KMS加密方式下KMS主秘鑰所屬的項目ID。 有效值:

與KMSMasterKeyID相匹配的項目ID。 在未設置KMSMasterKeyID的情況下,不可設置項目ID。 父元素:ApplyServerSideEncryptionByDefault
返回碼: 400

請求失敗響應消息。

名稱 類型 必選 描述
Code
 
 string 否

錯誤響應消息體XML中錯誤響應對應的HTTP消息返回碼,具體的錯誤碼請參見錯誤碼-表2。
Message
 
 string 否

錯誤響應消息體XML中具體錯誤更全面、詳細的英文解釋,具體的錯誤消息請參見錯誤碼-表2。
RequestId
 
 string 否

本次錯誤請求的請求ID,用于錯誤定位。
HostId
 
 string 否

返回該消息的服務端ID。
Resource
 
 string 否

該錯誤相關的桶或?qū)ο筚Y源。
返回碼: 404

請求失敗響應消息。 除了公共的錯誤碼外,此接口還會返回一些其他的錯誤碼。下面列出本接口的一些常見錯誤,以及可能原因。

錯誤碼 描述 HTTP狀態(tài)碼
NoSuchEncryptionConfiguration 指定的桶沒有設置加密配置。 404 Not Found
名稱 類型 必選 描述
Code
 
 string 否

錯誤響應消息體XML中錯誤響應對應的HTTP消息返回碼,具體的錯誤碼請參見錯誤碼-表2。
Message
 
 string 否

錯誤響應消息體XML中具體錯誤更全面、詳細的英文解釋,具體的錯誤消息請參見錯誤碼-表2。
RequestId
 
 string 否

本次錯誤請求的請求ID,用于錯誤定位。
HostId
 
 string 否

返回該消息的服務端ID。
Resource
 
 string 否

該錯誤相關的桶或?qū)ο筚Y源。
請求示例
示例 1
 
"/?encryption"
 
"GET /?encryption HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: Thu, 21 Feb 2019 03:05:34 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:DpSAlmLX/BTdjxU5HOEwflhM0WI=\n"
返回示例
返回碼：200

請求成功響應消息。

示例 1
 
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF26000001643670AC06E7B9A7767921 x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAA BCS vK6z8HV6nrJh49gsB5vqzpgtohkiFm Date: Thu, 21 Feb 2019 03:05:34 GMT Content-Length: 788 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ServerSideEncryptionConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <Rule> <ApplyServerSideEncryptionByDefault> <SSEAlgorithm>kms</SSEAlgorithm> <KMSMasterKeyID>4f1cd4de-ab64-4807-920a-47fc42e7f0d0</KMSMasterKeyID> </ApplyServerSideEncryptionByDefault> </Rule> </ServerSideEncryptionConfiguration>
錯誤碼
請參考 錯誤碼說明。

 

獲取桶的加密配置GetBucketEncryption

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失?。≌埳院笾卦?！