ListParts
更新时间:2021-07-21
接口描述
此命令用于列出用户指定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大小
注意事项
- BOS按照PartNumber升序排序。
- 由于网络传输可能出错,所以不推荐用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 } ] }