列举桶内多版本对象

功能说明

列举桶内多版本对象，默认返回最大1000个多版本对象。

方法定义

ObsClient.listVersions

请求参数

字段名	类型	约束	说明
Bucket	String	必选	桶名。
RequestDate	String 或 Date	可选	指定请求时间。说明：当为String类型时，必须符合ISO8601或RFC822规范。
Prefix	String	可选	限定返回的对象名必须带有Prefix前缀。
KeyMarker	String	可选	列举多版本对象的起始位置，返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。
MaxKeys	Number	可选	列举多版本对象的最大数目，取值范围为1~1000，当超出范围时，按照默认的1000进行处理。
Delimiter	String	可选	用于对对象名进行分组的字符。对于对象名中包含Delimiter的对象，其对象名（如果请求中指定了Prefix，则此处的对象名需要去掉Prefix）中从首字符至第一个Delimiter之间的字符串将作为一个分组并作为CommonPrefix返回。
VersionIdMarker	String	可选	与KeyMarker配合使用，返回的对象列表将是对象名和版本号按照字典序排序后该参数以后的所有对象。如果VersionIdMarker不是KeyMarker的一个版本号，则该参数无效。

返回结果（InterfaceResult）

字段名			类型	说明
RequestId			String	OBS服务端返回的请求ID。
Location			String	桶的区域位置。
Bucket			String	桶名。
Delimiter			String	用于对对象名进行分组的字符，与请求中的该参数对应。
Prefix			String	对象名的前缀，与请求中的该参数对应。
IsTruncated			String	表明本次请求是否返回了全部结果，“true”表示没有返回全部结果；“false”表示已返回了全部结果。
KeyMarker			String	列举多版本对象的起始位置，与请求中的该参数对应。
VersionIdMarker			String	表示列举多版本对象的起始位置（VersionId标识），与请求中的该参数对应。
NextKeyMarker			String	下次列举多版本对象请求的起始位置。
NextVersionIdMarker			String	下次列举多版本对象请求的起始位置（VersionId标识），与NextKeyMarker配合使用。
MaxKeys			String	列举多版本对象的最大数目，与请求中的该参数对应。
Versions			Array	多版本对象列表。
-	ETag		String	对象的MD5值。
	Size		String	对象的字节数。
	Key		String	对象名。
	VersionId		String	对象的版本号。
	IsLatest		String	标识对象是否是最新的版本，true代表是最新的版本。
	LastModified		String	对象最近一次被修改的时间。
	Owner		Object	对象的所有者。
	-	ID	String	对象所有者的DomainId。
-	StorageClass		String	对象的存储类型。
-	Type		String	对象是否可被追加上传。
DeleteMarkers			Array	删除标记列表。
-	Owner		Object	对象的所有者。
	-	ID	String	对象所有者的DomainId。
	Key		String	对象名。
	VersionId		String	对象的版本号。
	IsLatest		String	标识对象是否是最新的版本，true代表是最新的版本。
	LastModified		String	对象最近一次被修改的时间。
CommonPrefixes			Array	当请求中设置了Delimiter分组字符时，返回按Delimiter分组后的对象名称前缀列表。
-	Prefix		String	按Delimiter分组后的对象名称前缀。

代码样例

obsClient.listVersions({
       Bucket : 'bucketname',
       Prefix : 'prefix',
       MaxKeys : 100
},function (err, result) {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
                     console.log('Versions:');
                     for(var j=0;j<result.InterfaceResult.Versions;j++){
                           console.log('Version[' + j +  ']:');
                           console.log('Key-->' + result.InterfaceResult.Versions[j]['Key']);
                           console.log('VersionId-->' + result.InterfaceResult.Versions[j]['VersionId']);
                           console.log('IsLatest-->' + result.InterfaceResult.Versions[j]['IsLatest']);
                           console.log('LastModified-->' + result.InterfaceResult.Versions[j]['LastModified']);
                           console.log('ETag-->' + result.InterfaceResult.Versions[j]['ETag']);
                           console.log('Size-->' + result.InterfaceResult.Versions[j]['Size']);
                           console.log('Owner[ID]-->' + result.InterfaceResult.Versions[j]['Owner']['ID']);
                           console.log('StorageClass-->' + result.InterfaceResult.Versions[j]['StorageClass']);
                     }
                     console.log('DeleteMarkers:');
                     for(var i=0;i<result.InterfaceResult.DeleteMarkers.length;i++){
                           console.log('DeleteMarker[' + i +  ']:');
                           console.log('Key-->' + result.InterfaceResult.DeleteMarkers[i]['Key']);
                           console.log('VersionId-->' + result.InterfaceResult.DeleteMarkers[i]['VersionId']);
                           console.log('IsLatest-->' + result.InterfaceResult.DeleteMarkers[i]['IsLatest']);
                           console.log('LastModified-->' + result.InterfaceResult.DeleteMarkers[i]['LastModified']);
                           console.log('Owner[ID]-->' + result.InterfaceResult.DeleteMarkers[i]['Owner']['ID']);
                     }
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});

父主题：桶相关接口

上一篇：列举桶内对象

下一篇：列举桶内分段上传任务