跨區(qū)域復(fù)制是指跨不同區(qū)域中的桶自動(dòng)、異步地復(fù)制對(duì)象。通過(guò)激活跨區(qū)域復(fù)制,OBS可將新創(chuàng)建的對(duì)象及修改的對(duì)象從一個(gè)源桶復(fù)制到不同區(qū)域中的目標(biāo)桶。
設(shè)置桶的跨區(qū)域復(fù)制,需要滿足以下兩個(gè)要求:
1.要求源桶和目標(biāo)桶多版本狀態(tài)保持一致,否則不能設(shè)置replication。如何設(shè)置桶的多版本,請(qǐng)參見設(shè)置桶的多版本狀態(tài)。 2.源桶的擁有者和代理人(OBS)必須要有目標(biāo)桶的寫權(quán)限(目標(biāo)桶需要配置BucketPolicy),同時(shí)代理人(OBS)還要有源桶的讀權(quán)限。這需要通過(guò)“BucketPolicy”來(lái)實(shí)現(xiàn)這個(gè)權(quán)限委托: 如何設(shè)置桶策略,請(qǐng)參見設(shè)置桶策略。設(shè)置桶策略后,“代理人”(obs)就有權(quán)限可以讀取源桶的對(duì)象,也有權(quán)限將對(duì)象復(fù)制到目標(biāo)桶中。
| 名稱 | 類型 | 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字段,則可以不帶該字段,其他情況下必選。 |
|
Content-MD5
|
string | header | 是 |
按照RFC 1864標(biāo)準(zhǔn)計(jì)算出消息體的MD5摘要字符串,即消息體128-bit MD5值經(jīng)過(guò)base64編碼后得到的字符串。也支持設(shè)置Content-SHA256頭域,其值為消息體256-bit SHA256值經(jīng)過(guò)base64編碼后得到的字符串,Content-MD5和Content-SHA256二選一。 |
|
bucket_name
|
string | query | 是 |
請(qǐng)求的桶名稱。 |
|
replication
|
string | query | 是 |
replication表示請(qǐng)求桶的跨區(qū)域復(fù)制配置API。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Agency
|
string | 是 |
用戶創(chuàng)建的委托名字,最大長(zhǎng)度為64字符。 |
|
Rule
|
Array of ReplicationConfigurationRule objects | 是 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
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ì)象。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Bucket
|
string | 否 |
存儲(chǔ)被規(guī)則標(biāo)識(shí)的對(duì)象副本的桶名稱。 如果在復(fù)制配置中有多條規(guī)則,這些規(guī)則必須都要標(biāo)識(shí)同一個(gè)桶作為目標(biāo)桶。 |
|
StorageClass
|
string | 否 |
對(duì)象的存儲(chǔ)類型。 |
|
DeleteData
|
string | 否 |
刪除同步復(fù)制關(guān)鍵字,如果為Enabled,源桶的對(duì)象刪除操作會(huì)復(fù)制到目標(biāo)端。 |
請(qǐng)求成功響應(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í),可以通過(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,此類情況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)題。 |
請(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源。 |
