跨區(qū)域復(fù)制是指跨不同區(qū)域中的桶自動、異步地復(fù)制對象。通過激活跨區(qū)域復(fù)制,OBS可將新創(chuàng)建的對象及修改的對象從一個(gè)源桶復(fù)制到不同區(qū)域中的目標(biāo)桶。
設(shè)置桶的跨區(qū)域復(fù)制,需要滿足以下兩個(gè)要求:
1.要求源桶和目標(biāo)桶多版本狀態(tài)保持一致,否則不能設(shè)置replication。如何設(shè)置桶的多版本,請參見設(shè)置桶的多版本狀態(tài)。 2.源桶的擁有者和代理人(OBS)必須要有目標(biāo)桶的寫權(quán)限(目標(biāo)桶需要配置BucketPolicy),同時(shí)代理人(OBS)還要有源桶的讀權(quán)限。這需要通過“BucketPolicy”來實(shí)現(xiàn)這個(gè)權(quán)限委托: 如何設(shè)置桶策略,請參見設(shè)置桶策略。設(shè)置桶策略后,“代理人”(obs)就有權(quán)限可以讀取源桶的對象,也有權(quán)限將對象復(fù)制到目標(biāo)桶中。
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時(shí)間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認(rèn)值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
Content-MD5
|
string | header | 是 |
按照RFC 1864標(biāo)準(zhǔn)計(jì)算出消息體的MD5摘要字符串,即消息體128-bit MD5值經(jīng)過base64編碼后得到的字符串。也支持設(shè)置Content-SHA256頭域,其值為消息體256-bit SHA256值經(jīng)過base64編碼后得到的字符串,Content-MD5和Content-SHA256二選一。 |
|
bucket_name
|
string | query | 是 |
請求的桶名稱。 |
|
replication
|
string | query | 是 |
replication表示請求桶的跨區(qū)域復(fù)制配置API。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Agency
|
string | 是 |
用戶創(chuàng)建的委托名字,最大長度為64字符。 |
|
Rule
|
Array of ReplicationConfigurationRule objects | 是 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
ID
|
string | 否 |
規(guī)則的特殊辨識符,最大長度為255字符。 |
|
Status
|
string | 是 |
如果Status為Disabled,這條規(guī)則會被忽略。 |
|
Prefix
|
string | 是 |
對象鍵值名的前綴,適配于一個(gè)或者多個(gè)對象。 最大前綴長度可達(dá)到為1024個(gè)字節(jié),不支持重疊的前綴。 |
|
Destination
|
ReplicationConfigurationRuleDestination object | 是 |
目標(biāo)桶信息的容器。 |
|
HistoricalObjectReplication
|
string | 否 |
歷史對象復(fù)制關(guān)鍵字,如果為Enabled,會復(fù)制符合這條規(guī)則的歷史對象。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Bucket
|
string | 否 |
存儲被規(guī)則標(biāo)識的對象副本的桶名稱。 如果在復(fù)制配置中有多條規(guī)則,這些規(guī)則必須都要標(biāo)識同一個(gè)桶作為目標(biāo)桶。 |
|
StorageClass
|
string | 否 |
對象的存儲類型。 |
|
DeleteData
|
string | 否 |
刪除同步復(fù)制關(guān)鍵字,如果為Enabled,源桶的對象刪除操作會復(fù)制到目標(biāo)端。 |
請求成功響應(yīng)消息。
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Content-Length
|
string | 否 |
響應(yīng)消息體的字節(jié)長度。 |
|
Connection
|
string | 否 |
指明與服務(wù)器的連接是長連接還是短連接。 |
|
Date
|
string | 否 |
OBS系統(tǒng)響應(yīng)的時(shí)間。 |
|
ETag
|
string | 否 |
對象的base64編碼的128位MD5摘要。ETag是對象內(nèi)容的唯一標(biāo)識,可以通過該值識別對象內(nèi)容是否有變化。比如上傳對象時(shí)ETag為A,下載對象時(shí)ETag為B,則說明對象內(nèi)容發(fā)生了變化。實(shí)際的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)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
請求失敗響應(yīng)消息。
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Code
|
string | 否 |
錯(cuò)誤響應(yīng)消息體XML中錯(cuò)誤響應(yīng)對應(yīng)的HTTP消息返回碼,具體的錯(cuò)誤碼請參見錯(cuò)誤碼-表2。 |
|
Message
|
string | 否 |
錯(cuò)誤響應(yīng)消息體XML中具體錯(cuò)誤更全面、詳細(xì)的英文解釋,具體的錯(cuò)誤消息請參見錯(cuò)誤碼-表2。 |
|
RequestId
|
string | 否 |
本次錯(cuò)誤請求的請求ID,用于錯(cuò)誤定位。 |
|
HostId
|
string | 否 |
返回該消息的服務(wù)端ID。 |
|
Resource
|
string | 否 |
該錯(cuò)誤相關(guān)的桶或?qū)ο筚Y源。 |
