Todos os produtos
Search
Central de documentação

Object Storage Service:Get object tags (Node.js SDK)

Última atualização: Oct 10, 2026

Após configurar as etiquetas de um objeto, você pode consultá-las. Se o versionamento estiver ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, o Object Storage Service (OSS) retorna, por padrão, as etiquetas da versão atual do objeto. Para consultar as etiquetas de uma versão específica, especifique o ID da versão do objeto.

Obter informações de etiquetas de objeto

Caso o versionamento não esteja ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, você pode consultar as etiquetas do objeto de acordo com os seus requisitos. Se o versionamento estiver ativado no bucket, o OSS retorna, por padrão, as etiquetas da versão atual do objeto.

O código de exemplo a seguir mostra como consultar as etiquetas do objeto exampleobject.txt no diretório exampledir do bucket examplebucket:

const OSS = require('ali-oss')

const client = new OSS({
  // Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'yourRegion',
  // Get access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the bucket name. For example, examplebucket.
  bucket: 'examplebucket',
});

// Specify the full path of the object. For example, exampledir/exampleobject.txt. The full path of the object cannot contain the bucket name.
constobjectName='exampledir/exampleobject.txt'

// Get the tag information of the object.
async function getObjectTagging(objectName) {
  try {
    const result = await client.getObjectTagging(objectName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName)

Obter informações de etiquetas de uma versão específica de um objeto

Se o versionamento estiver ativado no bucket que armazena o objeto cujas etiquetas deseja consultar, você poderá consultar as etiquetas de uma versão específica do objeto especificando o ID da versão.

O código de exemplo a seguir mostra como consultar as etiquetas de uma versão específica do objeto exampleobject.txt no diretório exampledir do bucket examplebucket:

Nota

Para mais informações sobre como obter um ID de versão, consulte List objects (Node.js SDK).

const OSS = require('ali-oss')

const client = new OSS({
  // Set yourRegion to the region where the bucket is located. For example, if the bucket is in the China (Hangzhou) region, set Region to oss-cn-hangzhou.
  region: 'yourRegion',
  // Get access credentials from environment variables. Before you run this code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the bucket name. For example, examplebucket.
  bucket: 'examplebucket',
});

// Specify the full path of the object. For example, exampledir/exampleobject.txt. The full path of the object cannot contain the bucket name.
const objectName='exampledir/exampleobject.txt'
// Specify the version ID of the object.
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'

// Get the tag information of the 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)

Referências

  • Para obter o código de exemplo completo para obter etiquetas de objeto, consulte GitHub.

  • Para mais informações sobre a operação da API para obter etiquetas de objeto, consulte GetObjectTagging.