设置对象标签后,您可以根据需要获取Object的标签信息。当存储空间(Bucket)已开启版本控制时,OSS默认只获取Object当前版本的标签信息,您可以通过指定Object的版本ID(versionId)来获取Object指定版本的标签信息。

说明
  • 对象标签使用一组键值对(Key-Value)来标记对象。关于对象标签的更多信息,请参见开发指南中的对象标签
  • 关于获取对象标签的更多信息,请参见GetObjectTagging

获取Object标签信息

当存储空间(Bucket)未开启版本控制时,您可以根据需要获取Object标签信息。当Bucket已开启版本控制时,OSS默认只获取Object当前版本标签信息。

以下代码用于获取目标存储空间examplebucket中exampledir目录下的exampleobject.txt文件的标签信息。

const OSS = require('ali-oss')

const client = new OSS({
  // yourRegion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
  region: 'yourRegion',
  // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
  accessKeyId: 'yourAccessKeyId',
  accessKeySecret: 'yourAccessKeySecret',
  // 填写Bucket名称,例如examplebucket。
  bucket: 'examplebucket',
});

// 填写Object完整路径,例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。
const objectName = 'exampledir/exampleobject.txt'

// 获取Object的标签信息。
async function getObjectTagging(objectName) {
  try {
    const result = await client.getObjectTagging(objectName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName)

获取Object指定版本标签信息

当Bucket已开启版本控制时,通过指定Object的版本ID(versionId),您可以获取Object指定版本标签信息。

以下代码用于获取目标存储空间examplebucket中exampledir目录下的exampleobject.txt文件指定版本的标签信息。

说明 关于获取versionId的具体操作,请参见 列举文件
const OSS = require('ali-oss')

const client = new OSS({
  // yourRegion填写Bucket所在地域。以华东1(杭州)为例,Region填写为oss-cn-hangzhou。
  region: 'yourRegion',
  // 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
  accessKeyId: 'yourAccessKeyId',
  accessKeySecret: 'yourAccessKeySecret',
  // 填写Bucket名称,例如examplebucket。
  bucket: 'examplebucket',
});

// 填写Object完整路径,例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。
const objectName = 'exampledir/exampleobject.txt'
// 填写Object的版本ID。
const versionId = 'CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'

// 获取Object的标签信息。
async function getObjectTagging(objectName) {
  try {
    const options = {
      versionId
    };
    const result = await client.getObjectTagging(objectName, options);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName)