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
當您在OSS ON云盒中調用該接口時,您需要將Host替換為云盒Endpoint。更多信息,請參見云盒Endpoint。
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(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結果列表是否被截斷?!皌rue”表示本次沒有返回全部結果;“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如下: