列舉桶中已初始化多段任務(wù) 用戶可以通過本接口查詢一個(gè)桶中所有的初始化后還未合并以及未取消的多段上傳任務(wù)。
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
Authorization
|
string | header | 是 |
請求消息中可帶的簽名信息。 |
|
Date
|
string | header | 否 |
請求發(fā)起端的日期和時(shí)間,例如:Wed, 27 Jun 2018 13:39:15 +0000。 默認(rèn)值:無。 條件:如果消息頭中帶了x-obs-date字段,則可以不帶該字段,其他情況下必選。 |
|
bucket_name
|
string | query | 是 |
桶名稱 |
|
uploads
|
string | query | 是 |
uploads表示請求多段任務(wù)API。 |
|
delimiter
|
string | query | 否 |
對于名字中包含delimiter的對象的任務(wù),其對象名(如果請求中指定了prefix,則此處的對象名需要去掉prefix)中從首字符至第一個(gè)delimiter之間的字符串將作為CommonPrefix在響應(yīng)中返回。對象名包含CommonPrefix的任務(wù)被視為一個(gè)分組,作為一條記錄在響應(yīng)中返回,該記錄不包含任務(wù)的信息,僅用于提示用戶該分組下存在多段上傳任務(wù)。 |
|
prefix
|
string | query | 否 |
如果請求中指定了prefix,則響應(yīng)中僅包含對象名以prefix開始的任務(wù)信息。 |
|
max-uploads
|
integer | query | 否 |
列舉的多段任務(wù)的最大條目,取值范圍為[1,1000],當(dāng)超出范圍時(shí),按照默認(rèn)的1000進(jìn)行處理。 |
|
key-marker
|
string | query | 否 |
列舉時(shí)返回指定的key-marker之后的多段任務(wù)。 |
|
upload-id-marker
|
string | query | 否 |
只有和key-marker一起使用才有意義, 列舉時(shí)返回指定的key-marker的upload-id-marker之后的多段任務(wù)。 |
|
encoding-type
|
string | query | 否 |
對響應(yīng)中的部分元素進(jìn)行指定類型的編碼。如果Delimiter、KeyMarker、Prefix、NextKeyMarker和Key包含xml 1.0標(biāo)準(zhǔn)不支持的控制字符,可通過設(shè)置encoding-type對響應(yīng)中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key進(jìn)行編碼。 |
請求成功響應(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)建來唯一確定本次請求的值,可以通過該值來定位問題。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Bucket
|
string | 否 |
初始化任務(wù)所在的桶名。 |
|
EncodingType
|
string | 否 |
對響應(yīng)中的部分元素進(jìn)行指定類型的編碼。如果請求中設(shè)置了encoding-type,那響應(yīng)中的Delimiter、KeyMarker、Prefix(包括CommonPrefixes中的Prefix)、NextKeyMarker和Key會被編碼。 |
|
KeyMarker
|
string | 否 |
列舉時(shí)的起始對象位置。 |
|
UploadIdMarker
|
string | 否 |
列舉時(shí)的起始UploadId位置。 |
|
NextKeyMarker
|
string | 否 |
如果本次沒有返回全部結(jié)果,響應(yīng)請求中將包含NextKeyMarker字段,用于標(biāo)明接下來請求的KeyMarker值。 |
|
NextUploadIdMarker
|
string | 否 |
如果本次沒有返回全部結(jié)果,響應(yīng)請求中將包含NextUploadMarker字段,用于標(biāo)明接下來請求的UploadMarker值。 |
|
MaxUploads
|
integer | 否 |
返回的最大多段上傳任務(wù)數(shù)目。 |
|
IsTruncated
|
boolean | 否 |
表明是否本次返回的Multipart Upload結(jié)果列表被截?cái)??！皌rue”表示本次沒有返回全部結(jié)果;“false”表示本次已經(jīng)返回了全部結(jié)果。 |
|
Upload
|
Upload object | 否 |
保存Multipart Upload任務(wù)信息的容器。 |
|
ListMultipartUploadsResult.Prefix
|
string | 否 |
請求中帶的Prefix。 |
|
Delimiter
|
string | 否 |
請求中帶的Delimiter。 |
|
CommonPrefixes
|
CommonPrefixes object | 否 |
請求中帶Delimiter參數(shù)時(shí),返回消息帶CommonPrefixes分組信息。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
Key
|
string | 否 |
初始化Multipart Upload任務(wù)的Object名字。 |
|
UploadId
|
string | 否 |
Multipart Upload任務(wù)的ID。 |
|
Initiator
|
string | 否 |
Multipart Upload任務(wù)的創(chuàng)建者。 |
|
Owner
|
string | 否 |
段的所有者。 |
|
StorageClass
|
string | 否 |
表明待多段上傳的 對象存儲 類型。 |
|
Initiated
|
string | 否 |
Multipart Upload任務(wù)的初始化時(shí)間。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
ID
|
string | 否 |
創(chuàng)建者的DomainId。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
ID
|
string | 否 |
創(chuàng)建者的DomainId。 |
| 名稱 | 類型 | 必選 | 描述 |
|---|---|---|---|
|
CommonPrefixes. Prefix
|
string | 否 |
CommonPrefixes分組信息中,表明不同的Prefix。 |
請求失敗響應(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源。 |
不帶任何參數(shù)列舉已初始化的段任務(wù)
帶prefix和delimeter列舉已初始化的段任務(wù) 例如,用戶桶examplebucket中2個(gè)段任務(wù),對象名分別為multipart-object001和part2-key02,列舉段任務(wù)時(shí),設(shè)置prefix為“multipart",delimeter設(shè)置為object001,列舉已初始化的段任務(wù)
