Interface Description

This command is used to list all parts withspecified UploadIduploaded successfully. The user can view current progress through this command.

Request

• Request syntax

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

• Request header field

  No special header field.

• Query parameters

  Name	Type	Parameter Position	Description	Required?
  maxParts	Int	Query Parameters	The maximum number of parts returned by BOS at a time. The default value is 1,000 and the maximum value is 1,000.	No
  partNumberMarker	Int	Query Parameters	Sorted by partNumber, the starting part of this request is returned from the next one of this partNumber.	No
  uploadId	String	Query Parameter	The MultipartUpload ID	Yes

Response

• Response header field

  No special header field.

• Response element

  Name	Type	Description
  bucket	String	Bucket name
  key	String	Object Name
  uploadId	String	UploadId specified by request
  initiated	String	Creation time of multipartUpload
  owner	Container	User information of this object
  +id	String	User ID
  +displayName	String	User name
  storageClass	String	Storage type of the object. It returnsSTANDARD_IA for the infrequent access, COLD for cold storage, STANDARDfor standard storage and ARCHIVE for archive type. If it is a multi-AZ bucket, it returns MAZ_STANDARD_IA for the multi-AZ infrequent access MAZ_STANDARD for the multi-AZ standard storage.
  partNumberMarker	Int	Starting location of this part Number specified by the request
  nextPartNumberMarker	Int	partNumber of the last record returned from this request, which can be used as the PartNumberMarker for the next request.
  maxParts	Int	Maximum number of parts specified by the request and returned this time
  isTruncated	Bool	Indicates whether the ListPart results list returned this time is truncated. True indicates that not all results are returned this time. False indicates that all results are returned this time.
  parts	Container	Part container
  +partNumber	Int	Part ID
  +lastModified	DATE	Part upload time
  +ETag	String	ETag of each MultiPartUpload
  +size	Int	Part size

Considerations

1. BOS is sorted in the ascending order of PartNumber.
2. For the network transmission error may occur, it is not recommended to use the results of ListParts to generate the last part list of CompleteMultipartUpload.

Example

• Request example

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

• Response example

  HTTP/1.1 200 OK
  x-bce-request-id: 4db2b34d-654d-4d8a-b49b-3049ca786409
  Date: Wed, 06 Apr 2016 06:34:40 GMT
  Content-Length: 985
  Connection: keep-alive
  Server: BceBos
  
  {
      "bucket":"BucketName",
      "key":"object",
      "uploadId":"a44cc9bab11cbd156984767aad637851",
      "initiated":"2010-11-10T20:48:33Z",
      "owner":{
          "id":"75aa570f8e7faeebf76c078efc7c6caea54ba06a",
          "displayName":"someName"
      },
      "storageClass":"STANDARD",
      "partNumberMarker":1,
      "nextPartNumberMarker":3,
      "maxParts":2,
      "isTruncated":true,
      "parts":[
          {
              "partNumber":2,
              "lastModified":"2010-11-10T20:48:34Z",
              "ETag":"7778aef83f66abc1fa1e8477f296d394",
              "size":10485760
          },
          {
              "partNumber":3,
              "lastModified":"2010-11-10T20:48:33Z",
              "ETag":"aaaa18db4cc2f85cedef654fccc4a4x8",
              "size":10485760
          }
      ]
  }