華為云計算 云知識 獲取桶列表ListBuckets
獲取桶列表ListBuckets

 

接口說明

OBS用戶可以通過請求查詢自己創(chuàng)建的桶列表。

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。 默認(rèn)值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。

x-obs-bucket-type
 
string header

通過此消息頭明確獲取的列表內(nèi)容。 取值: OBJECT:獲取所有桶列表。 POSIX:獲取所有并行文件系統(tǒng)列表。 不帶此消息頭則獲取所有桶和并行文件系統(tǒng)列表。

返回參數(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)容的唯一標(biāo)識,可以通過該值識別對象內(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)建來唯一確定本次請求的值,可以通過該值來定位問題。

x-obs-bucket-type
 
string

通過此消息頭明確獲取的列表內(nèi)容。

取值: OBJECT:獲取所有桶列表。 POSIX:獲取所有并行文件系統(tǒng)列表。 不帶此消息頭則獲取所有桶和并行文件系統(tǒng)列表。

名稱 類型 必選 描述
Owner
 
Owner object

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

Buckets
 
Array of Bucket objects

用戶所擁有的桶列表。

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

用戶的DomainID(帳號ID)。

200 Buckets
名稱 類型 必選 描述
Name
 
string

桶名稱。

CreationDate
 
string

桶的創(chuàng)建時間。

Location
 
string

桶的位置信息。

ClusterType
 
string

桶所在的集群類型,當(dāng)桶創(chuàng)建在專屬集群上時,會返回此字段。其他場景不返回。

IESLocation
 
string

如果桶創(chuàng)建在IES站點集群中,返回IES站點ID。如果桶創(chuàng)建在IES站點集群中,返回IES站點ID。其他場景下不返回此頭域。

返回碼: 400

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

名稱 類型 必選 描述
Code
 
string

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

Message
 
string

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

RequestId
 
string

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

HostId
 
string

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

Resource
 
string

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

請求示例
示例 1
 
"/"
 
"GET / HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: Mon, 25 Jun 2018 05:37:12 +0000\nAuthorization: OBS GKDF4C7Q6SI0IPGTXTJN:9HXkVQIiQKw33UEmyBI4rWrzmic=\n"
返回示例
返回碼:200

成功響應(yīng)消息

示例 1
 
HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016435722C11379647A8A00A x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS GGDRUM62QZi3hGP8Fz3gOloYCfZ39U Content-Type: application/xml Date: Mon, 25 Jun 2018 05:37:12 GMT Content-Length: 460 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <ListAllMyBucketsResult xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2015-06-30/"> <Owner> <ID>783fc6652cf246c096ea836694f71855</ID> </Owner> <Buckets> <Bucket> <Name>examplebucket01</Name> <CreationDate>2018-06-21T09:15:01.032Z</CreationDate> <Location>cn-north-4</Location> <BucketType>OBJECT</BucketType> </Bucket> <Bucket> <Name>examplebucket02</Name> <CreationDate>2018-06-22T03:56:33.700Z</CreationDate> <Location>cn-east-3</Location> <BucketType>OBJECT</BucketType> </Bucket> </Buckets> </ListAllMyBucketsResult>
錯誤碼
請參考 錯誤碼說明