調用ListParts列舉指定UploadID所屬的所有已經上傳成功Part - Object Storage Service

ListParts介面用於列舉指定Upload ID所屬的所有已經上傳成功Part。

注意事項

OSS的返回結果按照Part號碼升序排列。
建議使用本地記錄的資料產生Part列表，不推薦使用ListParts返回結果中的Part Number和ETag值產生已經上傳成功的Part列表。原因是通過UploadID上傳的Part可能存在被誤覆蓋的風險，在執行CompleteMultipartUpload操作之前可能需要刪除部分不需要的Part，或者網路傳輸可能存在錯誤導致OSS接收到的Part資料可能不符合預期，如果本地沒有記錄各個Part對應的PartNumber以及ETag資料，將無法從ListParts返回結果中找到符合預期的Part資料，最終無法驗證OSS上的Part資料與原始上傳內容的一致性和完整性。

請求文法

Get  /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

請求參數（Request Parameters）

名稱	類型	樣本值	描述
uploadId	字串	0004B999EF5A239BB9138C6227D6****	MultipartUpload事件的ID。預設值：無
max-parts	整數	1000	規定在OSS響應中的最大Part數目。預設值：1,000 最大值：1,000
part-number-marker	整數	100	指定List的起始位置，只有Part Number數目大於該參數的Part會被列出。預設值：無
encoding-type	字串	url	指定對返回的內容進行編碼，指定編碼的類型。Key使用UTF-8字元，但XML 1.0標準不支援解析一些控制字元，比如ASCII值從0到10的字元。對於Key中包含XML 1.0標準不支援的控制字元，可以通過指定Encoding-type對返回的Key進行編碼。預設值：無可選值：url

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素（Response Elements）

名稱	類型	樣本值	描述
ListPartsResult	容器	不涉及	儲存List Part請求結果的容器。子節點：Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part 父節點：無
Bucket	字串	multipart_upload	Bucket名稱。父節點：ListPartsResult
EncodingType	字串	url	指明對返回結果進行編碼使用的類型。如果請求的參數中指定了Encoding-type，那會對返回結果中的Key進行編碼。父節點：ListPartsResult
Key	字串	multipart.data	Object名稱。父節點：ListPartsResult
UploadId	字串	0004B999EF5A239BB9138C6227D69F95	Upload事件ID。父節點：ListPartsResult
PartNumberMarker	整數	10	本次List結果的Part Number起始位置。父節點：ListPartsResult
NextPartNumberMarker	整數	5	如果本次沒有返回全部結果，響應請求中將包含NextPartNumberMarker元素，用於標明接下來請求的PartNumberMarker值。父節點：ListPartsResult
MaxParts	整數	1000	返回請求中最大的Part數目。父節點：ListPartsResult
IsTruncated	枚舉字串	false	標明本次返回的ListParts結果清單是否被截斷。“true”表示本次沒有返回全部結果；“false”表示本次已經返回了全部結果。有效值：true、false 父節點：ListPartsResult
Part	容器	不涉及	儲存Part資訊的容器。子節點：PartNumber,LastModified, ETag, Size 父節點：ListPartsResult
PartNumber	整數	1	標示Part的數字。父節點：ListPartsResult.Part
LastModified	日期	2012-02-23T07:01:34.000Z	Part上傳的時間。父節點：ListPartsResult.part
ETag	字串	3349DC700140D7F86A0784842780****	已上傳Part內容的ETag。父節點：ListPartsResult.Part
Size	整數	6291456	已上傳Part大小。父節點：ListPartsResult.Part

樣本

請求樣本

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D6****  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6q**************:77Dv****************

返回樣本

HTTP/1.1 200 
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D6****</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>"3349DC700140D7F86A0784842780****"</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>"7265F4D211B56873A381D321F586****"</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

SDK

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