文档首页/ 对象存储服务 OBS/ SDK参考/ Node.js/ 标签管理/ 获取对象标签
更新时间：2024-09-09 GMT+08:00
查看PDF
分享

获取对象标签

开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。

用户可以通过本接口获取对象（Object）的标签信息。对象标签使用一组键值对（Key-Value）标记对象。

如果请求中不携带版本号（versionId），需要确保执行者有GetObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作，也可以通过设置桶策略或用户策略给其他用户。

默认设置Object当前版本的标签信息。可以通过指定versionId参数来设置指定Object版本的标签信息。如果对应版本为删除标记（Delete Marker），则OBS将返回404 Not Found。

  • 文件桶不支持该功能
  • 每个对象最多能设置10个标签。
  • 标签的键名（Key）的最大长度为128个字符，可用UTF-8格式表示的字母（含中文）、数字、空格，以及以下字符：_ . : = + - @；区分大小写，不可重复，不能为空。
  • 标签的键值（Value）的最大长度为255个字符，可用UTF-8格式表示的字母（含中文）、数字、空格，以及以下字符：_ . : /= + - @；区分大小写，可以为空。

代码示例

以下代码展示了如何获取对象标签：

 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
 
// 引入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/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.cn-north-4.myhuaweicloud.com",
});

async function getObjectTagging() {
  try {
    const params = {
      // 指定存储桶名称
      Bucket: "examplebucket",
      // 指定对象，此处以 example/objectname 为例
      Key: "example/objectname",
    };
    // 获取对象标签配置
    const result = await obsClient.getObjectTagging(params);
    if (result.CommonMsg.Status <= 300) {
      console.log("Get Object(%s)'s tagging configuratio successful with Bucket(%s)", params.Bucket);
      console.log("RequestId: %s", result.CommonMsg.RequestId);
      for (let tag of result.InterfaceResult.Tags) {
        console.log('Key: %s, Value: %s', tag.key, tag.value);
      };
      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);
  };
};

getObjectTagging();
父主题： 标签管理

相关文档