調用ListMultipartUploads列舉執行中的MultipartUpload事件 - Object Storage Service

調用ListMultipartUploads介面列舉所有執行中的Multipart Upload事件，即已經初始化但還未完成（Complete）或者還未中止（Abort）的Multipart Upload事件。

請求文法

Get /?uploads HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

請求參數

名稱	類型	描述
delimiter	字串	用於對Object名稱進行分組的字元。所有名稱包含指定的首碼且首次出現delimiter字元之間的Object作為一組元素CommonPrefixes。
max-uploads	整數	限定此次返回Multipart Upload事件的最大個數，預設值為1000。最大值為1000。
key-marker	字串	與upload-id-marker參數配合使用，用於指定返回結果的起始位置。如果未設定upload-id-marker參數，查詢結果中包含所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。如果設定了upload-id-marker參數，查詢結果中包含：所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。 Object名稱等於key-marker參數值，但是UploadId比upload-id-marker參數值大的Multipart Upload事件。
prefix	字串	限定返回的Object Key必須以prefix作為首碼。注意使用prefix查詢時，返回的Key中仍會包含prefix。說明您可以靈活地使用prefix參數對Bucket內的Object進行分組管理（類似檔案夾功能）。
upload-id-marker	字串	與key-marker參數配合使用，用於指定返回結果的起始位置。如果未設定key-marker參數，則OSS會忽略upload-id-marker參數。如果設定了key-marker參數，查詢結果中包含：所有Object名稱的字典序大於key-marker參數值的Multipart Upload事件。 Object名稱等於key-marker參數值，但是UploadId比upload-id-marker參數值大的Multipart Upload事件。
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結果清單是否被截斷。取值範圍如下： true：表示本次沒有返回全部結果。 false（預設）：表示本次已經返回了全部結果。父節點：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>

SDK

此介面所對應的各語言SDK如下：