ListParts

API description

This command lists all successfully uploaded Parts for a user-specified UploadId, allowing users to view the current upload progress.

Request

• Request syntax

  Plain Text Copy

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

• Request headers

  No special headers

• Request parameters

Response

• Response headers

  No special headers

• Response element

  Name	Types	Description
  bucket	String	Corresponding bucket name
  key	String	Object name
  uploadId	String	UploadId specified in the request
  initiated	String	Creation time of multipartUpload
  owner	Container	Information of user to whom this object belongs
  +id	String	User ID
  +displayName	String	Username
  storageClass	String	Object storage class. Return STANDARD_IA for infrequent access storage, COLD for cold storage, STANDARD for standard storage, and ARCHIVE for archive storage; if it is multi-AZ bucket, return MAZ_STANDARD_IA for multi-AZ infrequent access storage, and return MAZ_STANDARD for multi-AZ standard storage.
  partNumberMarker	Int	Starting position of this part Number specified in the request
  nextPartNumberMarker	Int	partNumber of the last record returned upon this request, which could be used as the PartNumberMarker for the next request
  maxParts	Int	Maximum number of parts specified by the request to be returned this time
  isTruncated	Bool	Indicates whether the List Part result returned is truncated. A value of True means not all results are returned; False means all results are returned.
  parts	Container	Container of a part
  +partNumber	Int	Identifier of this part
  +lastModified	DATE	Upload time of this part
  +ETag	String	ETag of each multipart uploaded
  +size	Int	Size of this part

Note

1. BOS arranges parts in ascending order of PartNumber.
2. Due to potential network transmission errors, it is not recommended to finalize the Part list for CompleteMultipartUpload based on the ListParts results.

Example

• Request example

  Plain Text Copy

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

• Response example

  Plain Text Copy

  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    "bucket":"BucketName",
  9    "key":"object",
  10    "uploadId":"a44cc9bab11cbd156984767aad637851",
  11    "initiated":"2010-11-10T20:48:33Z",
  12    "owner":{
  13        "id":"75aa570f8e7faeebf76c078efc7c6caea54ba06a",
  14        "displayName":"someName"
  15    },
  16    "storageClass":"STANDARD",
  17    "partNumberMarker":1,
  18    "nextPartNumberMarker":3,
  19    "maxParts":2,
  20    "isTruncated":true,
  21    "parts":[
  22        {
  23            "partNumber":2,
  24            "lastModified":"2010-11-10T20:48:34Z",
  25            "ETag":"7778aef83f66abc1fa1e8477f296d394",
  26            "size":10485760
  27        },
  28        {
  29            "partNumber":3,
  30            "lastModified":"2010-11-10T20:48:33Z",
  31            "ETag":"aaaa18db4cc2f85cedef654fccc4a4x8",
  32            "size":10485760
  33        }
  34    ]
  35}