246 阿裏雲

ListMultipartUploads__關於MultipartUpload的操作_API 參考_對象存儲 OSS-阿裏雲

List Multipart Uploads可以羅列出所有執行中的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參數一同使用來指定返回結果的起始位置。 l 如果upload-id-marker參數未設置，查詢結果中包含：所有Object名字的字典序大於key-marker參數值的Multipart事件。 l 如果upload-id-marker參數被設置，查詢結果中包含：所有Object名字的字典序大於key-marker參數值的Multipart事件和Object名字等於key-marker參數值，但是Upload ID比upload-id-marker參數值大的Multipart Uploads事件。類型：字符串
prefix	限定返回的object key必須以prefix作為前綴。注意使用prefix查詢時，返回的key中仍會包含prefix。類型：字符串
upload-id-marker	與key-marker參數一同使用來指定返回結果的起始位置。 l 如果key-marker參數未設置，則OSS忽略upload-id-marker參數。 l 如果key-marker參數被設置，查詢結果中包含：所有Object名字的字典序大於key-marker參數值的Multipart事件和Object名字等於key-marker參數值，但是Upload ID比upload-id-marker參數值大的Multipart Uploads事件。類型：字符串
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=”https://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>

最後更新：2016-11-23 17:16:08

ListMultipartUploads__關於MultipartUpload的操作_API 參考_對象存儲 OSS-阿裏雲

請求語法

請求參數(Request Parameters)

響應元素(Response Elements)

細節分析

示例

上一篇： AbortMultipartUpload__關於MultipartUpload的操作_API 參考_對象存儲 OSS-阿裏雲

下一篇： ListParts__關於MultipartUpload的操作_API 參考_對象存儲 OSS-阿裏雲

相關內容

熱門內容

最新內容