所有文档

          对象存储 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;如果是多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列表。

          示例

          • 请求示例

            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