用戶可以通過本接口添加、修改或刪除桶中已經(jīng)上傳的對象的元數(shù)據(jù)。
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
versionId
|
string | header | 否 |
對象的版本號。 |
|
x-obs-metadata-directive
|
string | header | 是 |
元數(shù)據(jù)操作指示符。 取值為REPLACE_NEW或REPLACE。 REPLACE_NEW表示:對于已經(jīng)存在值的元數(shù)據(jù)進行替換,不存在值的元數(shù)據(jù)進行賦值,未指定的元數(shù)據(jù)保持不變(備注:自定義頭域作替換處理)。 REPLACE表示:使用當前請求中攜帶的頭域完整替換,未指定的元數(shù)據(jù)(本表中除x-obs-storage-class的其它元數(shù)據(jù))會被刪除。 |
|
Cache-Control
|
string | header | 否 |
指定Object被下載時的網(wǎng)頁的緩存行為。 |
|
Content-Disposition
|
string | header | 否 |
指定Object被下載時的名稱。 |
|
Content-Encoding
|
string | header | 否 |
指定Object被下載時的內容編碼格式。 |
|
Content-Language
|
string | header | 否 |
指定Object被下載時的內容語言格式。 |
|
Expires
|
string | header | 否 |
指定Object被下載時的網(wǎng)頁的緩存過期時間。 |
|
x-obs-website-redirect-location
|
string | header | 否 |
當桶設置了Website配置,可以將獲取這個對象的請求重定向到桶內另一個對象或一個外部的URL。 例如,重定向請求到桶內另一對象: x-obs-website-redirect-location:/anotherPage.html 或重定向請求到一個外部URL: x-obs-website-redirect-location:http://www.example.com/ 類型:字符串 約束:必須以“/”、“http://”或“https://”開頭,長度不超過2KB |
|
x-obs-storage-class
|
string | header | 否 |
指定對象的存儲類型。 類型:字符串 說明:存儲類型有3種:STANDARD(標準存儲)、WARM(低頻訪問存儲)、COLD(歸檔存儲)。因此這里可配置的值有:STANDARD、WARM和COLD,注意大小寫敏感。 示例:x-obs-storage-class: STANDARD |
|
x-obs-meta-*
|
string | header | 否 |
可以在請求中加入以“x-obs-meta-”開頭的消息頭,用來加入自定義的元數(shù)據(jù),以便對對象進行自定義管理。當用戶獲取此對象或查詢此對象元數(shù)據(jù)時,加入的自定義元數(shù)據(jù)將會在返回消息的頭中出現(xiàn)。更多說明詳見對象自定義元數(shù)據(jù)介紹。 類型:字符串 示例:x-obs-meta-test: test metadata |
|
object_key
|
string | path | 是 |
設置ACL對象的名稱。 |
|
bucket_name
|
string | query | 是 |
請求的桶名稱。 |
|
metadata
|
string | query | 是 |
metadata表示請求對象元數(shù)據(jù)API。 |
請求成功響應消息。
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
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)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
|
x-obs-metadata-directive
|
string | 否 |
元數(shù)據(jù)操作指示符。 取值為REPLACE_NEW或REPLACE。 |
|
Cache-Control
|
string | 否 |
指定Object被下載時的網(wǎng)頁的緩存行為。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
Content-Disposition
|
string | 否 |
指定Object被下載時的名稱。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
Content-Encoding
|
string | 否 |
指定Object被下載時的內容編碼格式。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
Content-Language
|
string | 否 |
指定Object被下載時的內容語言格式。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
Expires
|
string | 否 |
指定Object被下載時的網(wǎng)頁的緩存過期時間。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
x-obs-website-redirect-location
|
string | 否 |
當桶設置了Website配置,可以將獲取這個對象的請求重定向到桶內另一個對象或一個外部的URL。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
x-obs-storage-class
|
string | 否 |
指定對象的存儲類型。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
|
x-obs-meta-*
|
string | 否 |
用戶自定義的元數(shù)據(jù),以便對對象進行自定義管理。如果請求攜帶了此頭域,那么響應的消息中應該包含此消息頭。 |
給對象object添加元數(shù)據(jù):Content-Type:application/zip和x-obs-meta-test:meta。
