文档

ListParts

更新时间:

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结果列表是否被截断。“true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。

有效值:truefalse

父节点: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如下: