ListMultipartUploads可以羅列出所有執行中的Multipart Upload事件,即已經被初始化的Multipart Upload但是未被Complete或者Abort的Multipart Upload事件。
OSS返回的羅列結果中最多會包含1000個Multipart Upload資訊。如果想指定OSS返回羅列結果內Multipart Upload資訊的數目,可以在請求中添加max-uploads參數。另外,OSS返回羅列結果中的IsTruncated元素標明是否還有其他的Multipart Upload。
請求文法
Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
請求參數(Request Parameters)
名稱 | 類型 | 描述 |
---|---|---|
delimiter | 字元串 | 是一個用於對Object名字進行分組的字元。所有名字包含指定的首碼且第一次出現delimiter字元之間的object作為一組元素——CommonPrefixes。 |
max-uploads | 字元串 | 限定此次返回Multipart Uploads事件的最大數目,如果不設定,預設為1000,max-uploads取值不能大於1000。 |
key-marker | 字元串 | 與upload-id-marker參數一同使用來指定返回結果的起始位置。
|
prefix | 字元串 | 限定返回的object key必須以prefix作為首碼。注意使用prefix查詢時,返回的key中仍會包含prefix。 |
upload-id-marker | 字元串 | 與key-marker參數一同使用來指定返回結果的起始位置。
|
encoding-type | 字元串 | 指定對返回的內容進行編碼,指定編碼的類型。Delimiter、KeyMarker、Prefix、NextKeyMarker和Key使用UTF-8字元,但xml 1.0標準不支援解析一些控制字元,比如ascii值從0到10的字元。對於包含xml 1.0標準不支援的控制字元,可以通過指定encoding-type對返回的Delimiter、KeyMarker、Prefix、NextKeyMarker和Key進行編碼。 預設值:無 |
響應元素(Response Elements)
名稱 | 類型 | 描述 |
---|---|---|
ListMultipartUploadsResult | 容器 | 保存List Multipart Upload請求結果的容器。 子節點:Bucket, KeyMarker, UploadIdMarker, NextKeyMarker, NextUploadIdMarker, MasUploads, Delimiter, Prefix, CommonPrefixes, IsTruncated, Upload 父節點:None |
Bucket | 字元串 | Bucket名稱。 父節點:ListMultipartUploadsResult |
EncodingType | 字元串 | 指明返回結果中編碼使用的類型。如果請求的參數中指定了encoding-type,那返回的結果會對Delimiter、KeyMarker、Prefix、NextKeyMarker和Key這些元素進行編碼。 父節點:ListMultipartUploadsResult |
KeyMarker | 字元串 | 列表的起始Object位置。 父節點:ListMultipartUploadsResult |
UploadIdMarker | 字元串 | 列表的起始UploadID位置。 父節點:ListMultipartUploadsResult |
NextKeyMarker | 字元串 | 如果本次沒有返回全部結果,響應請求中將包含NextKeyMarker元素,用於標明接下來請求的KeyMarker值。 父節點:ListMultipartUploadsResult |
NextUploadMarker | 字元串 | 如果本次沒有返回全部結果,響應請求中將包含NextUploadMarker元素,用於標明接下來請求的UploadMarker值。 父節點:ListMultipartUploadsResult |
MaxUploads | 整數 | 返回的最大Upload數目。 父節點:ListMultipartUploadsResult |
IsTruncated | 枚舉字元串 | 標明是否本次返回的Multipart Upload結果清單被截斷。“true”表示本次沒有返回全部結果;“false”表示本次已經返回了全部結果。 有效值:false、true 預設值:false 父節點:ListMultipartUploadsResult |
Upload | 容器 | 保存Multipart Upload事件資訊的容器。 子節點:Key, UploadId, Initiated 父節點:ListMultipartUploadsResult |
Key | 字元串 | 初始化Multipart Upload事件的Object名字。 父節點:Upload |
UploadId | 字元串 | Multipart Upload事件的ID。 父節點:Upload |
Initiated | 日期 | Multipart Upload事件初始化的時間。 父節點:Upload |
細節分析
- max-uploads參數最大值為1000。
- 在OSS的返回結果首先按照Object名字字典序升序排列;對於同一個Object,則按照時間序,升序排列。
- 可以靈活地使用prefix參數對bucket內的object進行分組管理(類似與檔案夾的功能)。
- List Multipart Uploads請求支援5種請求參數: prefix、marker、delimiter、upload-id-marker和max-uploads。通過這些參數的組合,可以設定查詢Multipart Uploads事件的規則,獲得期望的查詢結果。
樣本
請求樣本:
Get /?uploads HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:JX75CtQqsmBBz+dcivn7kwBMvOY=
返回樣本:
HTTP/1.1 200
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561ce67a
Date: Thu, 23 Feb 2012 06:14:27 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Bucket>oss-example</Bucket>
<KeyMarker></KeyMarker>
<UploadIdMarker></UploadIdMarker>
<NextKeyMarker>oss.avi</NextKeyMarker>
<NextUploadIdMarker>0004B99B8E707874FC2D692FA5D77D3F</NextUploadIdMarker>
<Delimiter></Delimiter>
<Prefix></Prefix>
<MaxUploads>1000</MaxUploads>
<IsTruncated>false</IsTruncated>
<Upload>
<Key>multipart.data</Key>
<UploadId>0004B999EF518A1FE585B0C9360DC4C8</UploadId>
<Initiated>2012-02-23T04:18:23.000Z</Initiated>
</Upload>
<Upload>
<Key>multipart.data</Key>
<UploadId>0004B999EF5A239BB9138C6227D69F95</UploadId>
<Initiated>2012-02-23T04:18:23.000Z</Initiated>
</Upload>
<Upload>
<Key>oss.avi</Key>
<UploadId>0004B99B8E707874FC2D692FA5D77D3F</UploadId>
<Initiated>2012-02-23T06:14:27.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>