調用ListMultipartUploads接口列舉所有執行中的Multipart Upload事件,即已經初始化但還未完成(Complete)或者還未中止(Abort)的Multipart Upload事件。
請求語法
Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求參數
名稱 | 類型 | 描述 |
delimiter | 字符串 | 用于對Object名稱進行分組的字符。所有名稱包含指定的前綴且首次出現delimiter字符之間的Object作為一組元素CommonPrefixes。 |
max-uploads | 整數 | 限定此次返回Multipart Upload事件的最大個數,默認值為1000。最大值為1000。 |
key-marker | 字符串 | 與upload-id-marker參數配合使用,用于指定返回結果的起始位置。
|
prefix | 字符串 | 限定返回的Object Key必須以prefix作為前綴。注意使用prefix查詢時,返回的Key中仍會包含prefix。 說明 您可以靈活地使用prefix參數對Bucket內的Object進行分組管理(類似文件夾功能)。 |
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進行編碼。 默認值:無 |
響應元素
名稱 | 類型 | 描述 |
ListMultipartUploadsResult | 容器 | 保存ListMultipartUpload請求結果的容器。 子節點: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 | 枚舉字符串 | 表示本次返回的MultipartUpload結果列表是否被截斷。取值范圍如下:
父節點:ListMultipartUploadsResult |
Upload | 容器 | 保存Multipart Upload事件信息的容器。 子節點:Key, UploadId, Initiated 父節點:ListMultipartUploadsResult |
Key | 字符串 | 初始化Multipart Upload事件的Object名稱。 父節點:Upload 說明 OSS的返回結果按照Object名稱字典序升序排列,對于同一個Object,則按照UploadId的字典序升序排列。 |
UploadId | 字符串 | Multipart Upload事件的ID。 父節點:Upload |
Initiated | 日期 | Multipart Upload事件初始化的時間。 父節點:Upload |
示例
請求示例
Get /?uploads HTTP/1.1
Host:oss-example. oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 06:14:27 GMT
Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 200
Server: AliyunOSS
Connection: keep-alive
Content-length: 1839
Content-type: application/xml
x-oss-request-id: 58a41847-3d93-1905-20db-ba6f561c****
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>0004B999EF5A239BB9138C6227D6****</UploadId>
<Initiated>2012-02-23T04:18:23.000Z</Initiated>
</Upload>
<Upload>
<Key>oss.avi</Key>
<UploadId>0004B99B8E707874FC2D692FA5D7****</UploadId>
<Initiated>2012-02-23T06:14:27.000Z</Initiated>
</Upload>
</ListMultipartUploadsResult>