喜讯：国内、香港、海外云服务器租用特惠活动，2核/4G/10M仅需31元每月，点击抢购>>>

点击这里注册天翼云特邀VIP帐号，立即体验天翼云对象存储>>>

天翼云对象存储（经典版）I型API参考-List Part

该操作用于列出一次分片上传过程中已经上传完成的所有片段。

该操作必须包含一个通过Initial Multipart Upload操作获取的上传ID。该请求最多返回1000个上传片段信息，默认返回的片段数是1000。用户可以通过指定max-parts参数来指定一次请求返回的片段数。如果用户的分片上传过程超过1000个片段，响应中的IsTruncated字段的值则被设置成true，并且指定一个NextPartNumberMarker元素。用户可以在下一个连续的List Part请求中加入part-number-marker参数，并把它的值设置成上一个请求返回的NextPartNumberMarker值。

请求语法

请求参数

响应结果

出错响应

请求示例

假设用户上传了一系列以1开头的有连续分片号的片段，下面的List Part请求指定了max-parts和part-number-marker查询参数。此次请求列出了紧随片段1的两个片段，从请求响应体中可以获取到片段2和片段3。如果有更多的片段存在，则片段列表操作没有完成，响应体中将会包含值为true的IsTruncated元素。同时，响应体中还会包含值为3的NextPartNumberMarker元素，这个值用来指定在下一次连续的列表操作中part-number-marker参数的值。

GET /example-object?uploadId=668428231343369399&max-parts=2&part-number-marker=1 HTTP/1.1
Host: example-bucket.oos-cn.ctyunapi.cn
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: AWS 7799e793ce4624ee7e5a:xQE0diMbLRepdf3YB+FIEXAMPLE=

响应示例

HTTP/1.1 200 OK
x-amz-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1014
Connection: keep-alive
Server: CTYUN
 
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>example-bucket</Bucket>
  <EncodingType></EncodingType>
  <Key>example-object</Key>
  <UploadId>1638428231343309399</UploadId>
  <Initiator>
    <ID>mailaddress@email.com</ID>
    <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <Owner>
    <ID></ID>
    <DisplayName></DisplayName>
  </Owner>
  <StorageClass>STANDARD</StorageClass>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2010-11-10T20:48:34.000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2010-11-10T20:48:33.000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
   </Part>
</ListPartsResult>