接口描述

此命令用于列出用户指定UploadId所属的所有已经上传成功的Part，用户可以通过此命令查看当前的进度。

请求（Request）

• 请求语法

  Plain Text 复制

  1GET /<ObjectName>?uploadId=UploadId&maxParts=MaxParts&partNumberMarker=PartNumberMarker HTTP/1.1
  2Host: <BucketName>.bj.bcebos.com
  3Date: <Date>
  4Authorization: <AuthorizationString>

• 请求头域

  无特殊头域

• 请求参数

响应（Response）

• 响应头域

  无特殊头域

• 响应元素

  名称	类型	描述
  bucket	String	所属Bucket名称
  key	String	Object名称
  uploadId	String	请求指定的UploadId
  initiated	String	multipartUpload的创建时间
  owner	Container	此object所属的用户信息
  +id	String	用户ID
  +displayName	String	用户名
  storageClass	String	Object的存储类型，低频存储返回STANDARD_IA，冷存储返回COLD，标准存储返回STANDARD，归档存储返回ARCHIVE；如果是多AZ类型bucket，多AZ低频存储返回MAZ_STANDARD_IA，多AZ标准存储返回MAZ_STANDARD。
  partNumberMarker	Int	请求指定的本次part Number起始位置
  nextPartNumberMarker	Int	本次请求返回的最后一条记录的partNumber，可以作为下一次请求的PartNumberMarker
  maxParts	Int	请求指定的本次最多返回的part数量
  isTruncated	Bool	标明是否本次返回的List Part结果列表被截断。 true表示本次没有返回全部结果； false表示本次已经返回了全部结果
  parts	Container	一个part的容器
  +partNumber	Int	该part的标识
  +lastModified	DATE	该part的上传时间
  +ETag	String	每个上传分块的ETag
  +size	Int	该part大小

注意事项

1. BOS按照PartNumber升序排序。
2. 由于网络传输可能出错，所以不推荐用ListParts出来的结果生成最后CompleteMultipartUpload的Part列表。

示例

• 请求示例

  Plain Text 复制

  1GET /ObjectName?uploadId=a44cc9bab11cbd156984767aad637851&maxParts=2&partNumberMarker=1
  2Host: BucketName.bj.bcebos.com
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Authorization: AuthorizationString

• 响应示例

  Plain Text 复制

  1HTTP/1.1 200 OK
  2x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  3Date: Wed, 06 Apr 2016 06:34:40 GMT
  4Content-Length: 985
  5Connection: keep-alive
  6Server: BceBos
  7
  8{
  9    "bucket":"BucketName",
  10    "key":"object",
  11    "uploadId":"a44cc9bab11cbd156984767aad637851",
  12    "initiated":"2010-11-10T20:48:33Z",
  13    "owner":{
  14        "id":"75aa570f8e7faeebf76c078efc7c6caea54ba06a",
  15        "displayName":"someName"
  16    },
  17    "storageClass":"STANDARD",
  18    "partNumberMarker":1,
  19    "nextPartNumberMarker":3,
  20    "maxParts":2,
  21    "isTruncated":true,
  22    "parts":[
  23        {
  24            "partNumber":2,
  25            "lastModified":"2010-11-10T20:48:34Z",
  26            "ETag":"7778aef83f66abc1fa1e8477f296d394",
  27            "size":10485760
  28        },
  29        {
  30            "partNumber":3,
  31            "lastModified":"2010-11-10T20:48:33Z",
  32            "ETag":"aaaa18db4cc2f85cedef654fccc4a4x8",
  33            "size":10485760
  34        }
  35    ]
  36}