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