華為云計(jì)算 云知識(shí) 獲取桶元數(shù)據(jù)GetBucketMetadata
獲取桶元數(shù)據(jù)GetBucketMetadata

 

接口說明

對(duì)桶擁有讀權(quán)限的用戶可以執(zhí)行查詢桶元數(shù)據(jù)是否存在的操作。

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

請(qǐng)求消息中可帶的簽名信息。

Date
 
string header

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

Origin
 
string header

預(yù)請(qǐng)求指定的跨域請(qǐng)求Origin(通常為域名)。 如果想要獲取CORS配置信息,必添加該消息頭。

Access-Control-Request-Headers
 
string header

實(shí)際請(qǐng)求可以帶的HTTP頭域,可以帶多個(gè)頭域。 如果想要獲取CORS配置信息,可選添加該消息頭。

bucket_name
 
string query

桶名稱。

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

成功響應(yīng)消息

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

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

Connection
 
string

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

Date
 
string

OBS系統(tǒng)響應(yīng)的時(shí)間。

ETag
 
string

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

x-obs-id-2
 
string

幫助定位問題的特殊符號(hào)。

x-obs-request-id
 
string

由OBS創(chuàng)建來唯一確定本次請(qǐng)求的值,可以通過該值來定位問題。

x-obs-bucket-location
 
string

桶的區(qū)域位置信息

x-obs-storage-class
 
string

桶的默認(rèn)存儲(chǔ)類型。包含:STANDARD(標(biāo)準(zhǔn)存儲(chǔ))、WARM(低頻訪問存儲(chǔ))、COLD(歸檔存儲(chǔ))、HIGH_PERFORMANCE(高性能存儲(chǔ),只有并行文件系統(tǒng)支持)

x-obs-version
 
string

桶所在的OBS服務(wù)版本號(hào)

x-obs-fs-file-interface
 
string

是否為并行文件系統(tǒng)。取值包含Enabled(并行文件系統(tǒng))。不攜帶此頭域表示不屬于并行文件系統(tǒng)。

x-obs-epid
 
string

當(dāng)前桶的企業(yè)項(xiàng)目id

x-obs-az-redundancy
 
string

桶的數(shù)據(jù)冗余存儲(chǔ)策略屬性,決定數(shù)據(jù)是單AZ存儲(chǔ)還是多AZ存儲(chǔ)。取值為3az,表示數(shù)據(jù)冗余存儲(chǔ)在同一區(qū)域的多個(gè)可用區(qū)。不攜帶此頭域表示為單az存儲(chǔ),僅使用1個(gè)可用區(qū)存儲(chǔ)。

Access-Control-Allow-Origin
 
string

當(dāng)桶設(shè)置了CORS配置,如果請(qǐng)求的Origin滿足服務(wù)端的CORS配置,則在響應(yīng)中包含這個(gè)Origin

Access-Control-Allow-Headers
 
string

當(dāng)桶設(shè)置了CORS配置,如果請(qǐng)求的headers滿足服務(wù)端的CORS配置,則在響應(yīng)中包含這個(gè)headers。

Access-Control-Max-Age
 
integer

當(dāng)桶設(shè)置了CORS配置,服務(wù)端CORS配置中的MaxAgeSeconds

Access-Control-Allow-Methods
 
string

當(dāng)桶設(shè)置了CORS配置,如果請(qǐng)求的Access-Control-Request-Method滿足服務(wù)端的CORS配置,則在響應(yīng)中包含這條rule中的Methods

Access-Control-Expose-Headers
 
string

當(dāng)桶設(shè)置了CORS配置,服務(wù)端CORS配置中的ExposeHeader

x-obs-ies-location
 
string

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

返回碼: 400

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

名稱 類型 必選 描述
Code
 
string

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

Message
 
string

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

RequestId
 
string

本次錯(cuò)誤請(qǐng)求的請(qǐng)求ID,用于錯(cuò)誤定位。

HostId
 
string

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

Resource
 
string

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

請(qǐng)求示例
示例 1

獲取桶元數(shù)據(jù),未攜帶獲取CORS配置

 
"HEAD / HTTP/1.1"
 
"HEAD / HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 02:30:25 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1dttxHZyYlk="
示例 2

桶設(shè)置了CORS后,獲取桶元數(shù)據(jù)和CORS配置

 
"HEAD / HTTP/1.1"
 
"HEAD / HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: WED, 01 Jul 2015 02:30:25 GMT\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1datxHZyYlk=\nOrigin:www.example.com\nAccess-Control-Request-Headers:AllowedHeader_1"
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說明。