華為云計(jì)算 云知識(shí) 獲取桶的跨區(qū)域復(fù)制配置GetBucketReplication
獲取桶的跨區(qū)域復(fù)制配置GetBucketReplication

 

接口說(shuō)明

獲取指定桶的復(fù)制配置信息。執(zhí)行該配置操作前需要確保執(zhí)行者擁有GetReplicationConfiguration權(quán)限。

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

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

Date
 
string header

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

bucket_name
 
string query

請(qǐng)求的桶名稱。

replication
 
string query

replication表示請(qǐng)求桶的跨區(qū)域復(fù)制配置API。

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

請(qǐng)求成功響應(yīng)消息。

名稱 類(lèi)型 必選 描述
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í),可以通過(guò)該值識(shí)別對(duì)象內(nèi)容是否有變化。比如上傳對(duì)象時(shí)ETag為A,下載對(duì)象時(shí)ETag為B,則說(shuō)明對(duì)象內(nèi)容發(fā)生了變化。實(shí)際的ETag是對(duì)象的哈希值。ETag只反映變化的內(nèi)容,而不是其元數(shù)據(jù)。上傳的對(duì)象或拷貝操作創(chuàng)建的對(duì)象,通過(guò)MD5加密后都有唯一的ETag。如果通過(guò)多段上傳對(duì)象,則無(wú)論加密方法如何,MD5會(huì)拆分ETag,此類(lèi)情況ETag就不是MD5的摘要。

x-obs-id-2
 
string

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

x-obs-request-id
 
string

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

名稱 類(lèi)型 必選 描述
ReplicationConfiguration
 
SetBucketReplicationRequestBody object

復(fù)制規(guī)則的容器,最多可以達(dá)到100條規(guī)則,所有的復(fù)制配置大小可達(dá)到50KB。

200 ReplicationConfiguration
名稱 類(lèi)型 必選 描述
Agency
 
string

用戶創(chuàng)建的委托名字,最大長(zhǎng)度為64字符。

Rule
 
Array of ReplicationConfigurationRule objects  
200 ReplicationConfiguration.Rule
名稱 類(lèi)型 必選 描述
ID
 
string

規(guī)則的特殊辨識(shí)符,最大長(zhǎng)度為255字符。

Status
 
string

如果Status為Disabled,這條規(guī)則會(huì)被忽略。

Prefix
 
string

對(duì)象鍵值名的前綴,適配于一個(gè)或者多個(gè)對(duì)象。

最大前綴長(zhǎng)度可達(dá)到為1024個(gè)字節(jié),不支持重疊的前綴。

Destination
 
ReplicationConfigurationRuleDestination object

目標(biāo)桶信息的容器。

HistoricalObjectReplication
 
string

歷史對(duì)象復(fù)制關(guān)鍵字,如果為Enabled,會(huì)復(fù)制符合這條規(guī)則的歷史對(duì)象。

200 ReplicationConfiguration.Rule.Destination
名稱 類(lèi)型 必選 描述
Bucket
 
string

存儲(chǔ)被規(guī)則標(biāo)識(shí)的對(duì)象副本的桶名稱。

如果在復(fù)制配置中有多條規(guī)則,這些規(guī)則必須都要標(biāo)識(shí)同一個(gè)桶作為目標(biāo)桶。

StorageClass
 
string

對(duì)象的存儲(chǔ)類(lèi)型。

DeleteData
 
string

刪除同步復(fù)制關(guān)鍵字,如果為Enabled,源桶的對(duì)象刪除操作會(huì)復(fù)制到目標(biāo)端。

返回碼: 400

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

名稱 類(lèi)型 必選 描述
Code
 
string

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

Message
 
string

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

RequestId
 
string

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

HostId
 
string

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

Resource
 
string

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

返回碼: 404

請(qǐng)求失敗響應(yīng)消息。 除了公共的錯(cuò)誤碼外,此接口還會(huì)返回一些其他的錯(cuò)誤碼。下面列出本接口的一些常見(jiàn)錯(cuò)誤,以及可能原因。

錯(cuò)誤碼 描述 HTTP狀態(tài)碼 SOAP錯(cuò)誤碼前綴
NoSuchReplicationConfiguration 跨region復(fù)制配置不存在。 404 Not Found Client
名稱 類(lèi)型 必選 描述
Code
 
string

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

Message
 
string

錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請(qǐng)參見(jiàn)錯(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
 
"/?replication"
 
"GET /?replication HTTP/1.1\nUser-Agent: curl/7.29.0\nHost: examplebucket.obs.cn-north-4.myhuaweicloud.com\nAccept: */*\nDate: Wed, 27 Jun 2018 13:42:40 +0000\nAuthorization: OBS H4IPJX0TQTHTHEBQQCEC:jGHviInfRyOkT/EpySpua1hlBuY=\n"
返回示例
返回碼:200

請(qǐng)求成功響應(yīng)消息。

示例 1
 
HTTP/1.1 200 OK Server: OBS x-obs-request-id: B59500000164417B57D02F7EF8823152 x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAA BCS Hu6lz4vgk5G3E32OFcIPEZZgdOEYE/ Content-Type: application/xml Date: Wed, 27 Jun 2018 13:42:39 GMT Content-Length: 337 <?xml version="1.0" encoding="utf-8"?> <ReplicationConfiguration xmlns="http://obs.cn-north-4.myhuaweicloud.com/doc/2006-03-01/"> <Rule> <ID>Rule-1</ID> <Status>Enabled</Status> <Prefix></Prefix> <Destination> <Bucket>dstbucket</Bucket> <StorageClass>STANDARD</StorageClass> <DeleteData>Enabled</DeleteData> </Destination> <HistoricalObjectReplication>Enabled</HistoricalObjectReplication> </Rule> <Agency>testAcy</Agency> </ReplicationConfiguration>
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說(shuō)明。