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

List Parts命令可以羅列出指定Upload ID所屬的所有已經上傳成功Part。

請求語法

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

請求參數(Request Parameters)

名稱	描述
uploadId	Multipart Upload事件的ID。類型：字符串默認值：無
max-parts	規定在OSS響應中的最大Part數目。類型：整數默認值：1,000
part-number-marker	指定List的起始位置，隻有Part Number數目大於該參數的Part會被列出。類型：整數默認值：無
encoding-type	指定對返回的內容進行編碼，指定編碼的類型。Key使用UTF-8字符，但xml 1.0標準不支持解析一些控製字符，比如ascii值從0到10的字符。對於Key中包含xml 1.0標準不支持的控製字符，可以通過指定encoding-type對返回的Key進行編碼。數據類型：字符串默認值：無，可選值：url

響應元素(Response Elements)

名稱	描述
ListPartsResult	保存List Part請求結果的容器。類型：容器子節點：Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part 父節點：無
Bucket	Bucket名稱。類型：字符串父節點：ListPartsResult
EncodingType	指明對返回結果進行編碼使用的類型。如果請求的參數中指定了encoding-type，那會對返回結果中的Key進行編碼。類型：字符串父節點：ListPartsResult
Key	Object名稱。類型：字符串父節點：ListPartsResult
UploadId	Upload事件ID。類型：字符串父節點：ListPartsResult
PartNumberMarker	本次List結果的Part Number起始位置。類型：整數父節點：ListPartsResult
NextPartNumberMarker	如果本次沒有返回全部結果，響應請求中將包含NextPartNumberMarker元素，用於標明接下來請求的PartNumberMarker值。類型：整數父節點：ListPartsResult
MaxParts	返回請求中最大的Part數目。類型：整數父節點：ListPartsResult
IsTruncated	標明是否本次返回的List Part結果列表被截斷。“true”表示本次沒有返回全部結果；“false”表示本次已經返回了全部結果。類型：枚舉字符串有效值：true、false 父節點：ListPartsResult
Part	保存Part信息的容器。類型：字符串子節點：PartNumber,LastModified, ETag, Size 父節點：ListPartsResult
PartNumber	標示Part的數字。類型：整數父節點：ListPartsResult.Part
LastModified	Part上傳的時間。類型：日期父節點：ListPartsResult.part
ETag	已上傳Part內容的ETag。類型：字符串父節點：ListPartsResult.Part
Size	已上傳Part大小。類型：整數父節點：ListPartsResult.Part

細節分析

List Parts支持max-parts和part-number-marker兩種請求參數。
max-parts參數最大值為1000；默認值也為1000。
在OSS的返回結果按照Part號碼升序排列。
由於網絡傳輸可能出錯，所以不推薦用List Part出來的結果（Part Number和ETag值）來生成最後Complete Multipart的Part列表。

示例

請求示例：

Get  /multipart.data?uploadId=0004B999EF5A239BB9138C6227D69F95  HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:4qOnUMc9UQWqkz8wDqD3lIsa9P8=

返回示例：

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=”https://doc.oss-cn-hangzhou.aliyuncs.com”>
    <Bucket>multipart_upload</Bucket>
    <Key>multipart.data</Key>
    <UploadId>0004B999EF5A239BB9138C6227D69F95</UploadId>
    <NextPartNumberMarker>5</NextPartNumberMarker>
    <MaxParts>1000</MaxParts>
    <IsTruncated>false</IsTruncated>
    <Part>
        <PartNumber>1</PartNumber>
        <LastModified>2012-02-23T07:01:34.000Z</LastModified>
        <ETag>&quot;3349DC700140D7F86A078484278075A9&quot;</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>2</PartNumber>
        <LastModified>2012-02-23T07:01:12.000Z</LastModified>
        <ETag>&quot;3349DC700140D7F86A078484278075A9&quot;</ETag>
        <Size>6291456</Size>
    </Part>
    <Part>
        <PartNumber>5</PartNumber>
        <LastModified>2012-02-23T07:02:03.000Z</LastModified>
        <ETag>&quot;7265F4D211B56873A381D321F586E4A9&quot;</ETag>
        <Size>1024</Size>
    </Part>
</ListPartsResult>

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

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

請求語法

請求參數(Request Parameters)

響應元素(Response Elements)

細節分析

示例

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

下一篇： PutBucketcors__跨域資源共享_API 參考_對象存儲 OSS-阿裏雲

相關內容

熱門內容

最新內容