文档首页/ 对象存储服务 OBS/ SDK参考/ Node.js/ 多版本控制(Node.js SDK)/ 列举桶内多版本对象(Node.js SDK)
更新时间:2024-11-13 GMT+08:00

列举桶内多版本对象(Node.js SDK)

开发过程中,您有任何问题可以在github上提交issue

功能介绍

用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。

接口约束

  • 您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举桶内多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:ListBucketVersions权限,如果使用桶策略则需授予ListBucketVersions权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略自定义创建桶策略
  • OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点

方法定义

ObsClient.listVersions(params)

请求参数

表1 请求参数列表

参数名称

参数类型

是否必选

描述

Bucket

string

必选

参数解释

桶名。

约束限制:

  • 桶的名字需全局唯一,不能与已有的任何桶名称重复,包括其他用户创建的桶。
  • 桶命名规则如下:
    • 3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。
    • 禁止使用IP地址。
    • 禁止以“-”或“.”开头及结尾。
    • 禁止两个“.”相邻(如:“my..bucket”)。
    • 禁止“.”和“-”相邻(如:“my-.bucket”和“my.-bucket”)。
  • 同一用户在同一个区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。

取值范围:

长度为3~63个字符。

默认取值:

KeyMarker

string

可选

参数解释:

列举多版本对象的起始位置,返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。

约束限制:

该字段仅用于多版本列举。

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

VersionIdMarker

string

可0选

参数解释:

与KeyMarker配合使用。返回的对象列表将是对象名和版本号按照字典序排序后该参数以后的所有对象。KeyMarker指定对象名,VersionIdMarker指定该对象的具体版本号,两者共同确定对象版本

约束限制:

  • 该字段只适用于多版本列举场景。
  • 如果VersionIdMarker指定的版本号不属于KeyMarker指定对象的版本,则该参数无效。

取值范围:

对象的版本号,即KeyMarker对象的某一个VersionId值。

默认取值:

Prefix

string

可选

参数解释:

限定返回的对象名必须带有指定前缀。

例如,假设您拥有以下对象:logs/day1、logs/day2、logs/day3和ExampleObject.jpg。如果您将logs/指定为前缀,将返回以字符串“logs/”开头的三个对象。如果您指定空的前缀且请求中没有其他过滤条件,将返回桶中的所有对象。

约束限制:

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

MaxKeys

number

可选

参数解释:

列举对象的最大数目,返回的对象列表将是按照字典顺序的最多前MaxKeys个对象。

约束限制:

取值范围:

1~1000,当超出范围时,按照默认的1000进行处理。

默认取值:

1000

Delimiter

string

可选

参数解释:

对象名按照此标识符进行分组。通常与Prefix参数搭配使用,如果指定了Prefix,从Prefix到第一次出现Delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes;如果没有指定Prefix,从对象名的首字符到第一次出现Delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes。

例如,桶中有3个对象,分别为abcd、abcde、bbcde。如果指定Delimiter为d,Prefix为a,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes;如果只指定Delimiter为d,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes,而bbcde会被单独分成一组,形成一条前缀为bbcd的CommonPrefixes。

对于并行文件系统,不携带此参数时默认列举是递归列举此目录下所有内容,会列举子目录。在大数据场景下(目录层级深、目录下文件多)的列举,建议设置[Delimiter=/],只列举当前目录下的内容,不列举子目录,提高列举效率。

约束限制:

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

EncodingType

string

可选

参数解释:

对响应中的部分元素进行指定类型的编码。如果Delimiter、KeyMarker、Prefix、CommonPrefixes、NextKeyMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Delimiter、KeyMarker、Prefix、CommonPrefixes、NextKeyMarker和Key进行编码。

约束限制:

取值范围:

可选值为url。

默认取值:

无,不设置则不编码。

返回结果

表2 返回结果

参数类型

描述

表3

说明:

该接口返回是一个Promise类型,需要使用Promise、async/await语法处理。

参数解释:

接口返回信息,详见表3

表3 Response

参数名称

参数类型

描述

CommonMsg

ICommonMsg

参数解释:

接口调用完成后的公共信息,包含HTTP状态码,操作失败的错误码等,详见ICommonMsg

InterfaceResult

ListVersionsOutput

参数解释:

操作成功后的结果数据,详见ListVersionsOutput

约束限制

当Status大于300时为空。

表4 ICommonMsg

参数名称

参数类型

描述

Status

number

参数解释:

OBS服务端返回的HTTP状态码。

取值范围:

状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态。完整的状态码列表请参见状态码

Code

string

参数解释:

OBS服务端返回的错误码。

Message

string

参数解释:

OBS服务端返回的错误描述。

HostId

string

参数解释:

OBS服务端返回的请求服务端ID。

RequestId

string

参数解释:

OBS服务端返回的请求ID。

Id2

string

参数解释:

OBS服务端返回的请求ID2。

Indicator

string

参数解释:

OBS服务端返回的详细错误码。

表5 ListVersionsOutput

参数名称

参数类型

描述

RequestId

string

参数解释:

OBS服务端返回的请求ID。

默认取值:

Location

string

参数解释

桶所在的区域。

Name

string

参数解释

桶名。

Prefix

string

参数解释:

对象名的前缀,与请求中的该参数对应。

例如,假设您拥有以下对象:logs/day1、logs/day2、logs/day3和ExampleObject.jpg。如果您将logs/指定为前缀,将返回以字符串“logs/”开头的三个对象。如果您指定空的前缀且请求中没有其他过滤条件,将返回桶中的所有对象。

KeyMarker

string

参数解释:

列举多版本对象的起始位置,与请求中的该参数对应。返回的对象列表将是对象名按照字典序排序后该参数以后的所有对象。

VersionIdMarker

string

参数解释:

keyMarker对象的对应版本号。

与KeyMarker配合使用。返回的对象列表将是对象名和版本号按照字典序排序后该参数以后的所有对象。KeyMarker指定对象名,VersionIdMarker指定该对象的具体版本号,两者共同确定对象版本

Delimiter

string

参数解释:

对象名按照此标识符进行分组。通常与Prefix参数搭配使用,如果指定了Prefix,从Prefix到第一次出现Delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes;如果没有指定Prefix,从对象名的首字符到第一次出现Delimiter间具有相同字符串的对象名会被分成一组,形成一条CommonPrefixes。

例如,桶中有3个对象,分别为abcd、abcde、bbcde。如果指定Delimiter为d,Prefix为a,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes;如果只指定Delimiter为d,abcd、abcde会被分成一组,形成一条前缀为abcd的CommonPrefixes,而bbcde会被单独分成一组,形成一条前缀为bbcd的CommonPrefixes。

对于并行文件系统,不携带此参数时默认列举是递归列举此目录下所有内容,会列举子目录。在大数据场景下(目录层级深、目录下文件多)的列举,建议设置[Delimiter=/],只列举当前目录下的内容,不列举子目录,提高列举效率。

MaxKeys

number

参数解释:

列举对象的最大数目,与请求中的该参数对应。返回的对象列表将是按照字典顺序的最多前MaxKeys个对象。

IsTruncated

boolean

参数解释:

表明本次请求是否返回了全部结果。因为每次列举返回对象的数量上限是1000个,如果对象个数大于1000,则无法通过一次请求返回全部结果。

取值范围:

  • true:表示没有返回全部结果。
  • false:表示已返回了全部结果。

NextKeyMarker

string

参数解释:

下次列举多版本对象请求的起始位置。如果本次没有返回全部结果,响应请求中将包含该元素,用于标明接下来请求的KeyMarker值。

NextVersionIdMarker

string

参数解释:

下次列举多版本对象请求的起始位置(VersionIdMarker),与NextKeyMarker配合使用。如果本次没有返回全部结果,响应请求中将包含该元素,用于标明接下来请求的VersionIdMarker值。

Versions

Version[]

参数解释:

桶内多版本对象列表,详见Version

DeleteMarkers

DeleteMarker[]

参数解释:

桶内多版本删除标记列表,详见DeleteMarker

CommonPrefixes

表6[]

参数解释:

当请求中设置了Delimiter分组字符时,返回按Delimiter分组后的对象名称前缀列表,详见CommonPrefix

EncodingType

string

参数解释:

表明响应中的部分元素的编码类型。如果Delimiter、KeyMarker、Prefix、CommonPrefixes、NextKeyMarker和Key包含xml 1.0标准不支持的控制字符,可通过设置该参数对响应中的Delimiter、KeyMarker、Prefix、CommonPrefixes、NextKeyMarker和Key进行编码。

表6 CommonPrefix

参数名称

参数类型

描述

Prefix

string

参数解释:

为桶内对象的前缀。

表7 Version

参数名称

参数类型

描述

Key

string

参数解释:

对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。

例如,您对象的访问地址为examplebucket.obs.ap-southeast-1..com/folder/test.txt 中,对象名为folder/test.txt。

取值范围:

长度大于0且不超过1024的字符串。

默认取值:

VersionId

string

参数解释:

对象的版本号。

取值范围:

长度为32的字符串。

默认取值:

LastModified

string

参数解释:

对象最近一次被修改的时间(UTC时间)。

取值范围:

UTC时间

默认取值:

ETag

string

参数解释:

对象的base64编码的128位MD5摘要。ETag是对象内容的唯一标识,可以通过该值识别对象内容是否有变化。比如上传对象时ETag为A,下载对象时ETag为B,则说明对象内容发生了变化。ETag只反映变化的内容,而不是其元数据。上传的对象或复制操作创建的对象,都有唯一的ETag。

约束限制:

当对象是服务端加密的对象时,ETag值不是对象的MD5值。

取值范围:

长度为32的字符串。

默认取值:

Size

number

参数解释:

对象的字节数。

取值范围:

0~48.8TB,单位:字节。

默认取值:

Owner

Owner

参数解释:

对象的所有者,详见Owner

StorageClass

StorageClassType

参数解释:

对象的存储类型,详见StorageClassType

IsLatest

boolean

参数解释:

标识对象是否是最新的版本。

取值范围:

  • true:代表是最新的版本。
  • false:代表非最新版本。

默认取值:

false

表8 DeleteMarker

参数名称

参数类型

描述

Key

string

参数解释:

对象名。对象名是对象在存储桶中的唯一标识。对象名是对象在桶中的完整路径,路径中不包含桶名。

例如,您对象的访问地址为examplebucket.obs.ap-southeast-1.myhuaweicloud.com/folder/test.txt 中,对象名为folder/test.txt。

VersionId

string

参数解释:

对象的版本号。

IsLatest

boolean

参数解释:

标识对象是否是最新的版本。

取值范围:

  • true:代表是最新的版本。
  • false:代表非最新版本。

LastModified

string

参数解释:

对象最近一次被修改的时间(UTC时间)。

Owner

Owner

参数解释:

对象的所有者,包含对象拥有者DomainId和对象拥有者名称,详见Owner

StorageClass

StorageClassType

参数解释:

对象的存储类型,详见存储类型取值范围详见StorageClassType

表9 Owner

参数名称

参数类型

是否必选

描述

ID

string

作为请求参数时必选

参数解释:

所有者的账号ID,即domain_id。

取值范围:

如何获取账号ID请参见如何获取账号ID和用户ID?(Node.js SDK)

默认取值:

DisplayName

string

可选

参数解释:

所有者的账号用户名。

默认取值:

表10 StorageClassType

常量名

原始值

说明

ObsClient.enums.StorageClassStandard

STANDARD

标准存储。

标准存储拥有低访问时延和较高的吞吐量,适用于有大量热点对象(平均一个月多次)或小对象(<1MB),且需要频繁访问数据的业务场景。

ObsClient.enums.StorageClassWarm

WARM

低频访问存储。

低频访问存储适用于不频繁访问(平均一年少于12次)但在需要时也要求能够快速访问数据的业务场景。

ObsClient.enums.StorageClassCold

COLD

归档存储。

归档存储适用于很少访问(平均一年访问一次)数据的业务场景。

代码示例一:简单列举

本示例用于简单列举多版本对象,最多返回1000个对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
    };
    // 列举桶内版本对象
    const result = await obsClient.listVersions(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("List objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      // 获取多版本对象 
      for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
        const val = result.InterfaceResult.Versions[j];
        console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
          j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
      };
      // 获取对象删除标记 
      for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
        const val = result.InterfaceResult.Versions[j];
        console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
          j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
      };
      return;
    };
    console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
    console.log("Status: %d", result.CommonMsg.Status);
    console.log("Code: %s", result.CommonMsg.Code);
    console.log("Message: %s", result.CommonMsg.Message);
    console.log("RequestId: %s", result.CommonMsg.RequestId);
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();
  • 每次至多返回1000个多版本对象,如果指定桶包含的对象数量大于1000,则返回结果中InterfaceResult.IsTruncated为true表明本次没有返回全部对象,并可通过InterfaceResult.NextKeyMarker和InterfaceResult.NextVersionIdMarker获取下次列举的起始位置。
  • 如果想获取指定桶包含的所有多版本对象,可以采用代码示例五:分页列举全部多版本对象的方式。

代码示例二:指定数目列举

本示例用于指定数目列举多版本对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定返回的最大对象数,此处以 100 为例,返回的对象列表将是按照字典顺序的最多前max-keys个对象
      MaxKeys: 100,
    };
    // 列举桶内版本对象
    const result = await obsClient.listVersions(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("List version objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let j = 0; j < result.InterfaceResult.Contents.length; j++) {
        // 获取多版本对象 
        for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
            j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
        };
        // 获取对象删除标记 
        for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
            j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
        };
        return;
      };
    };
    console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
    console.log("Status: %d", result.CommonMsg.Status);
    console.log("Code: %s", result.CommonMsg.Code);
    console.log("Message: %s", result.CommonMsg.Message);
    console.log("RequestId: %s", result.CommonMsg.RequestId);
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();

代码示例三:指定前缀列举

本示例用于指定前缀列举多版本对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');
// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定列举对象前缀,此处以“test/”前缀为例,满足指定前缀的对象会被列举
      Prefix: "test/",
      // 指定返回的最大对象数,此处以 100 为例,返回的对象列表将是按照字典顺序的最多前max-keys个对象,默认值为1000
      MaxKeys: 100,
    };
    
    // 列举桶内版本对象
    const result = await obsClient.listVersions(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("List version objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let j = 0; j < result.InterfaceResult.Contents.length; j++) {
        // 获取多版本对象 
        for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
            j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
        };
        // 获取对象删除标记 
        for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
            j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
        };
        return;
      };
    };

    console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
    console.log("Status: %d", result.CommonMsg.Status);
    console.log("Code: %s", result.CommonMsg.Code);
    console.log("Message: %s", result.CommonMsg.Message);
    console.log("RequestId: %s", result.CommonMsg.RequestId);
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();

代码示例四:指定起始位置列举

本示例用于指定起始位置列举多版本对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定列举对象前缀,此处以“test/”前缀为例,满足指定前缀的对象会被列举
      Prefix: "test/",
      // 指定返回的最大对象数,此处以 100 为例,返回的对象列表将是按照字典顺序的最多前max-keys个对象
      MaxKeys: 100,
      // 指定列举对象的起始位置,此处以“test/test2”为例
      KeyMarker: "test/test2",
    };
    // 列举桶内版本对象
    const result = await obsClient.listVersions(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("List version objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let j = 0; j < result.InterfaceResult.Contents.length; j++) {
        // 获取多版本对象 
        for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
            j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
        };
        // 获取对象删除标记 
        for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
            j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
        };
        return;
      };
    };
    console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
    console.log("Status: %d", result.CommonMsg.Status);
    console.log("Code: %s", result.CommonMsg.Code);
    console.log("Message: %s", result.CommonMsg.Message);
    console.log("RequestId: %s", result.CommonMsg.RequestId);
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();

代码示例五:分页列举全部多版本对象

本示例用于分页列举全部多版本对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定编码方式,此处以“url”为例,如果列举对象中存在特殊字符,则该参数必传
      EncodingType: "url",
    };
    while (true) {
      // 列举桶内版本对象
      const result = await obsClient.listVersions(params);
      if (result.CommonMsg.Status > 300) {
        console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
        console.log("Status: %d", result.CommonMsg.Status);
        console.log("Code: %s", result.CommonMsg.Code);
        console.log("Message: %s", result.CommonMsg.Message);
        console.log("RequestId: %s", result.CommonMsg.RequestId);
        return;
      };
      console.log("List version objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let j = 0; j < result.InterfaceResult.Contents.length; j++) {
        // 获取多版本对象 
        for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
            j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
        };
        // 获取对象删除标记 
        for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
            j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
        };
      };
      if (result.InterfaceResult.IsTruncated === "true") {
        params.KeyMarker = result.InterfaceResult.NextKeyMarker;
        params.VersionIdMarker = result.InterfaceResult.NextVersionIdMarker;
      } else {
        break;
      };
    };
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();

代码示例六:列举文件夹中的所有多版本对象

OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。文件夹对象实际上是一个大小为0且对象名以“/”结尾的对象,将这个文件夹名作为前缀,即可模拟列举文件夹中对象的功能。以下代码展示如何列举文件夹中的多版本对象。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
// 引入obs库
// 使用npm安装
const ObsClient = require("esdk-obs-nodejs");
// 使用源码安装
// var ObsClient = require('./lib/obs');

// 创建ObsClient实例
const obsClient = new ObsClient({
  // 推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险
  // 您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.html
  access_key_id: process.env.ACCESS_KEY_ID,
  secret_access_key: process.env.SECRET_ACCESS_KEY,
  // 【可选】如果使用临时AK/SK和SecurityToken访问OBS,同样建议您尽量避免使用硬编码,以降低信息泄露风险。您可以通过环境变量获取访问密钥AK/SK,也可以使用其他外部引入方式传入
  // security_token: process.env.SECURITY_TOKEN,
  // endpoint填写Bucket对应的Endpoint, 这里以中国-香港为例,其他地区请按实际情况填写
  server: "https://obs.ap-southeast-1.myhuaweicloud.com"
});

async function listVersions() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定列举对象前缀,此处以“test/”前缀为例,满足指定前缀的对象会被列举
      Prefix: "test/",
      // 指定编码方式,此处以“url”为例,如果列举对象中存在特殊字符,则该参数必传
      EncodingType: "url",
    };
    while (true) {
      // 列举桶内版本对象
      const result = await obsClient.listVersions(params);
      if (result.CommonMsg.Status > 300) {
        console.log("An ObsError was found, which means your request sent to OBS was rejected with an error response.");
        console.log("Status: %d", result.CommonMsg.Status);
        console.log("Code: %s", result.CommonMsg.Code);
        console.log("Message: %s", result.CommonMsg.Message);
        console.log("RequestId: %s", result.CommonMsg.RequestId);
        return;
      };
      console.log("List version objects under the bucket(%s) successful!", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let j = 0; j < result.InterfaceResult.Contents.length; j++) {
        // 获取多版本对象 
        for (let j = 0; j < result.InterfaceResult.Versions.length; j++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, ETag:%s, Key:%s, VersionId, LastModified:%s, Size:%d',
            j, val.Owner.ID, val.ETag, val.Key, val.VersionId, val.LastModified, val.Size);
        };
        // 获取对象删除标记 
        for (let i = 0; i < result.InterfaceResult.DeleteMarkers.length; i++) {
          const val = result.InterfaceResult.Versions[j];
          console.log('Content[%d]-OwnerId:%s, Key:%s, VersionId, LastModified:%s',
            j, val.Owner.ID, val.Key, val.VersionId, val.LastModified);
        };
      };
      if (result.InterfaceResult.IsTruncated === "true") {
        params.KeyMarker = result.InterfaceResult.NextKeyMarker;
        params.VersionIdMarker = result.InterfaceResult.NextVersionIdMarker;
      } else {
        break;
      };
    };
  } catch (error) {
    console.log("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.");
    console.log(error);
  };
};

listVersions();