更新时间:2022-02-10 GMT+08:00

列举已上传的段

功能说明

通过分段上传任务的ID,列举指定桶中已上传的段。

方法定义

ObsClient.listParts

请求参数

字段名

类型

约束

说明

Bucket

String

必选

桶名。

Key

String

必选

对象名。

RequestDate

String

Date

可选

指定请求时间。

说明:

当为String类型时,必须符合ISO8601或RFC822规范。

UploadId

String

必选

分段上传任务的ID。

MaxParts

Number

可选

列举已上传段的返回结果最大段数目,即分页时每一页中段数目。

PartNumberMarker

Number

可选

列举已上传段的起始位置,只有Part Number大于该参数的段会被列出。

返回结果(InterfaceResult)

字段名

类型

说明

RequestId

String

OBS服务端返回的请求ID。

Bucket

String

桶名。

Key

String

对象名。

UploadId

String

分段上传任务的ID。

PartNumberMarker

String

列举已上传段的起始位置,与请求中的该参数对应。

NextPartNumberMarker

String

下次列举已上传段请求的起始位置。

MaxParts

String

列举已上传段的返回结果最大段数目,与请求中的该参数对应。

IsTruncated

String

表明本次请求是否返回了全部结果,“true”表示没有返回全部结果;“false”表示已返回了全部结果。

Parts

Array

已上传段列表。

  

PartNumber

String

段号。

LastModified

String

段的最后上传时间。

ETag

String

段的ETag值。

Size

String

段的大小。

Initiator

Object

分段上传任务的创建者。

  

ID

String

创建者的DomainId。

Owner

Object

和Initiator相同,代表分段上传任务的创建者。

  

ID

String

创建者的DomainId。

StorageClass

String

待分段上传对象的存储类型。

代码样例

obsClient.listParts({
       Bucket:'bucketname',
       Key : 'objectkey',
       UploadId : 'uploadid',
       MaxParts : 10
},function (err, result) {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
                     console.log('Bucket-->' + result.InterfaceResult.Bucket);
                     console.log('Key-->' + result.InterfaceResult.Key);
                     console.log('UploadId-->' + result.InterfaceResult.UploadId);
                     console.log('PartNumberMarker-->' + result.InterfaceResult.PartNumberMarker);
                     console.log('NextPartNumberMarker-->' + result.InterfaceResult.NextPartNumberMarker);
                     console.log('MaxParts-->' + result.InterfaceResult.MaxParts);
                     console.log('IsTruncated-->' + result.InterfaceResult.IsTruncated);
                     console.log('StorageClass-->' + result.InterfaceResult.StorageClass);
                     console.log('Initiator[ID]-->' + result.InterfaceResult.Initiator['ID']);  
                     console.log('Owner[ID]-->' + result.InterfaceResult.Owner['ID']);
                     for(var i=0;i<result.InterfaceResult.Parts.length;i++){
                           console.log('Part['+i+']:');
                           console.log('PartNumber-->' + result.InterfaceResult.Parts[i]['PartNumber']);
                           console.log('LastModified-->' + result.InterfaceResult.Parts[i]['LastModified']);
                           console.log('ETag-->' + result.InterfaceResult.Parts[i]['ETag']);
                           console.log('Size-->' + result.InterfaceResult.Parts[i]['Size']);
                     }
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});