对象存储BOS

    ListParts

    接口描述

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

    请求(Request)

    • 请求语法

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

      无特殊头域

    • 请求参数

      名称 类型 参数位置 描述 是否必需
      maxParts Int Query参数 BOS一次最多返回的part数目,默认1000,最大1000
      partNumberMarker Int Query参数 按照partNumber排序,本次请求的起始part从此partNumber的下一个开始返回
      uploadId String Query参数 此次MultipartUpload的ID

    响应(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
      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列表。

    示例

    • 请求示例

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

      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
              }
          ]
      }
    上一篇
    AbortMultipartUpload
    下一篇
    ListMultipartUploads