如果要獲取歸檔存儲對象的內(nèi)容,需要先將對象取回,然后再執(zhí)行下載數(shù)據(jù)的操作。對象取回后,會產(chǎn)生一個標準存儲類型的對象副本,也就是說會同時存在標準存儲類型的對象副本和歸檔存儲類型的對象,在取回對象的保存時間到期后標準存儲類型的對象副本會自動刪除。
多版本 #### 默認情況下,取回的是最新版本的對象。如果最新版本的對象是刪除標記,則返回404。如果要取回指定版本的對象,請求可攜帶versionId消息參數(shù)。
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
object_key
|
string | path | 是 |
獲取歸檔存儲對象的內(nèi)容 |
|
bucket_name
|
string | query | 是 |
桶名稱 |
|
versionId
|
string | query | 否 |
待取回歸檔存儲對象的版本號。 |
|
restore
|
string | query | 是 |
restore表示請求取回歸檔對象API。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Days
|
integer | 是 |
取回對象的保存時間,最小值為1,最大值為30。 |
|
RestoreJob
|
RestoreJob object | 否 |
取回選項的容器 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Tier
|
string | 否 |
取回選項,支持兩種取值:[Expedited|Standard]。 Expedited表示快速取回對象,取回耗時1~5 min, Standard表示標準取回對象,取回耗時3~5 h, 默認取值為Standard。 |
成功響應(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)容的唯一標識,可以通過該值識別對象內(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)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
請求失敗響應(yīng)消息。 除了公共的錯誤碼外,此接口還會返回一些其他的錯誤碼。下面列出本接口的一些常見錯誤,以及可能原因。
| 錯誤碼 | 描述 | HTTP狀態(tài)碼 |
|---|---|---|
| MalformedXML | Days字段不合法(不為整數(shù))ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema | 400 Bad Request |
| InvalidArgument | Days字段取值超出范圍(1<=days<=30)。ErrorMessage: restoration days should be at least 1 and at most 30 | 400 Bad Request |
請求失敗響應(yīng)消息。 除了公共的錯誤碼外,此接口還會返回一些其他的錯誤碼。下面列出本接口的一些常見錯誤,以及可能原因。
| 錯誤碼 | 描述 | HTTP狀態(tài)碼 |
|---|---|---|
| InvalidObjectState | 取回對象不是歸檔存儲對象。ErrorMessage: Restore is not allowed, as object's storage class is not COLD | 403 Forbidden |
請求失敗響應(yīng)消息。 除了公共的錯誤碼外,此接口還會返回一些其他的錯誤碼。下面列出本接口的一些常見錯誤,以及可能原因。
| 錯誤碼 | 描述 | HTTP狀態(tài)碼 |
|---|---|---|
| RestoreAlreadyInProgress | 對象正在取回,請求沖突。ErrorMessage: Object restore is already in progress | 409 Conflict |
| ObjectHasAlreadyRestored | 已經(jīng)取回的對象,禁止縮短取回保存時間。ErrorMessage:After restoring an archived object, you cannot shorten the restoration period of the archived object | 409 Conflict |
