ListParts
更新时间:2021-07-21
接口描述
此命令用于列出用户指定UploadId所属的所有已经上传成功的Part,用户可以通过此命令查看当前的进度。
请求(Request)
-
请求语法
Plain Text1GET /<ObjectName>?uploadId=UploadId&maxParts=MaxParts&partNumberMarker=PartNumberMarker HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3Date: <Date> 4Authorization: <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列表。
示例
-
请求示例
Plain Text1GET /ObjectName?uploadId=a44cc9bab11cbd156984767aad637851&maxParts=2&partNumberMarker=1 2Host: BucketName.bj.bcebos.com 3Date: Wed, 06 Apr 2016 06:34:40 GMT 4Authorization: AuthorizationString
-
响应示例
Plain Text1HTTP/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{ 9 "bucket":"BucketName", 10 "key":"object", 11 "uploadId":"a44cc9bab11cbd156984767aad637851", 12 "initiated":"2010-11-10T20:48:33Z", 13 "owner":{ 14 "id":"75aa570f8e7faeebf76c078efc7c6caea54ba06a", 15 "displayName":"someName" 16 }, 17 "storageClass":"STANDARD", 18 "partNumberMarker":1, 19 "nextPartNumberMarker":3, 20 "maxParts":2, 21 "isTruncated":true, 22 "parts":[ 23 { 24 "partNumber":2, 25 "lastModified":"2010-11-10T20:48:34Z", 26 "ETag":"7778aef83f66abc1fa1e8477f296d394", 27 "size":10485760 28 }, 29 { 30 "partNumber":3, 31 "lastModified":"2010-11-10T20:48:33Z", 32 "ETag":"aaaa18db4cc2f85cedef654fccc4a4x8", 33 "size":10485760 34 } 35 ] 36}