歸檔對象直讀是指用戶可以不用取回歸檔對象,便能直接對其進行操作。
默認情況下,桶沒有開啟歸檔對象直讀功能。
本接口主要用來開啟或關閉桶的歸檔對象直讀功能。
設置桶的歸檔對象直讀狀態(tài)為Enabled,開啟桶的歸檔對象直讀功能: 桶內存在歸檔對象時,不管該歸檔對象是否已經(jīng)取回,均可以直接操作該歸檔對象。 如果歸檔對象沒有取回,操作該歸檔對象時會增加單獨計費。 設置桶的歸檔對象直讀狀態(tài)為Disabled,關閉桶的歸檔對象直讀功能: 歸檔對象無法直接操作,需要先取回。 要正確執(zhí)行此操作,需要確保執(zhí)行者有PutDirectColdAccessConfiguration權限。默認情況下只有桶的所有者可以執(zhí)行此操作,也可以通過設置桶策略或用戶策略授權給其他用戶。
說明: 當前歸檔數(shù)據(jù)直讀功能僅在以下區(qū)域開放:華北-北京一、華北-北京四、華東-上海二、華南-廣州、西南-貴陽一。
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
Content-MD5
|
string | header | 是 |
按照RFC 1864標準計算出消息體的MD5摘要字符串,即消息體128-bit MD5值經(jīng)過base64編碼后得到的字符串。也支持設置Content-SHA256頭域,其值為消息體256-bit SHA256值經(jīng)過base64編碼后得到的字符串,Content-MD5和Content-SHA256二選一。 示例:n58IG6hfM7vqI4K0vnWpog== |
|
bucket_name
|
string | query | 是 |
請求的桶名稱。 |
|
directcoldaccess
|
string | query | 是 |
directcoldaccess表示請求桶歸檔對象直讀策略API。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Status
|
string | 是 |
標識桶的歸檔對象直讀狀態(tài)。 |
請求成功響應消息。
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Content-Length
|
string | 否 |
響應消息體的字節(jié)長度。 |
|
Connection
|
string | 否 |
指明與服務器的連接是長連接還是短連接。 |
|
Date
|
string | 否 |
OBS系統(tǒng)響應的時間。 |
|
ETag
|
string | 否 |
對象的base64編碼的128位MD5摘要。ETag是對象內容的唯一標識,可以通過該值識別對象內容是否有變化。比如上傳對象時ETag為A,下載對象時ETag為B,則說明對象內容發(fā)生了變化。實際的ETag是對象的哈希值。ETag只反映變化的內容,而不是其元數(shù)據(jù)。上傳的對象或拷貝操作創(chuàng)建的對象,通過MD5加密后都有唯一的ETag。如果通過多段上傳對象,則無論加密方法如何,MD5會拆分ETag,此類情況ETag就不是MD5的摘要。 |
|
x-obs-id-2
|
string | 否 |
幫助定位問題的特殊符號。 |
|
x-obs-request-id
|
string | 否 |
由OBS創(chuàng)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
