華為云計算 云知識 獲取桶ACLGetBucketAcl
獲取桶ACLGetBucketAcl

 

接口說明

用戶執(zhí)行獲取桶ACL的操作,返回信息包含指定桶的權(quán)限控制列表信息。用戶必須擁有對指定桶READ_ACP的權(quán)限或FULL_CONTROL權(quán)限,才能執(zhí)行獲取桶ACL的操作。

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

請求的桶名稱。

acl
 
string query

acl表示請求訪問控制列表API。

返回參數(shù)
返回碼: 200

成功響應(yīng)消息。

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

響應(yīng)消息體的字節(jié)長度。

Connection
 
string

指明與服務(wù)器的連接是長連接還是短連接。

Date
 
string

OBS系統(tǒng)響應(yī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)建來唯一確定本次請求的值,可以通過該值來定位問題。

名稱 類型 必選 描述
AccessControlPolicy
 
SetBucketAclRequestBody object  
200 AccessControlPolicy
名稱 類型 必選 描述
Owner
 
Owner object

桶擁有者信息,包含租戶ID。

AccessControlList
 
Array of Grant objects

訪問控制列表,包含Grant、 Grantee、Permission三個元素

200 AccessControlPolicy.Owner
名稱 類型 必選 描述
ID
 
string

用戶的DomainID(帳號ID)。

200 AccessControlPolicy.AccessControlList
名稱 類型 必選 描述
Grantee
 
Grantee object

用于標記用戶及用戶的權(quán)限。單個桶的ACL,Grant元素不能超過100個

Permission
 
string

授予的權(quán)限

Delivered
 
boolean

桶的ACL是否向桶內(nèi)對象傳遞

200 AccessControlPolicy.AccessControlList.Grantee
名稱 類型 必選 描述
ID
 
string

被授權(quán)用戶的租戶Id

返回碼: 400

請求失敗響應(yīng)消息。

名稱 類型 必選 描述
Code
 
string

錯誤響應(yīng)消息體XML中錯誤響應(yīng)對應(yīng)的HTTP消息返回碼,具體的錯誤碼請參見錯誤碼-表2。

Message
 
string

錯誤響應(yīng)消息體XML中具體錯誤更全面、詳細的英文解釋,具體的錯誤消息請參見錯誤碼-表2。

RequestId
 
string

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

HostId
 
string

返回該消息的服務(wù)端ID。

Resource
 
string

該錯誤相關(guān)的桶或?qū)ο筚Y源。

請求示例
示例 1
 
"GET /?acl HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 02:39:28 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:X7HtzGsIEkzJbd8vo1DRu30vVrs=\n"
返回示例
返回碼:200

成功響應(yīng)消息。

示例 1
 
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016436B69D82F14E93528658 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS jTh8661+HF5y8uAnTOBIpNO133hji+ Content-Type: application/xml Date: WED, 01 Jul 2015 02:39:28 GMT Content-Length: 784 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <AccessControlPolicy xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <Owner> <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID> </Owner> <AccessControlList> <Grant> <Grantee> <ID>b4bf1b36d9ca43d984fbcb9491b6fce9</ID> </Grantee> <Permission>FULL_CONTROL</Permission> </Grant> <Grant> <Grantee> <ID>783fc6652cf246c096ea836694f71855</ID> </Grantee> <Permission>READ</Permission> <Delivered>false</Delivered> </Grant> <Grant> <Grantee> <Canned>Everyone</Canned> </Grantee> <Permission>READ_ACP</Permission> </Grant> </AccessControlList> </AccessControlPolicy>
錯誤碼
請參考 錯誤碼說明。