链接复制成功!
列举已上传的段
功能说明
通过分段上传任务的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); } } });