全部产品
Search
文档中心

Object Storage Service:Dapatkan tag objek (Node.js SDK)

更新时间:Nov 30, 2025

Setelah menetapkan tag untuk suatu objek, Anda dapat mengambil informasi tagnya. Jika pengendalian versi diaktifkan untuk bucket, OSS secara default mengambil tag dari versi terkini objek tersebut. Untuk mengambil tag dari versi tertentu, tentukan ID versi (versionId) objek tersebut.

Dapatkan informasi tag objek

Jika pengendalian versi dinonaktifkan untuk suatu bucket, Anda dapat mengambil informasi tag objek tersebut. Jika pengendalian versi diaktifkan untuk bucket, OSS secara default mengambil tag dari versi terkini objek tersebut.

Kode berikut menunjukkan cara mengambil tag file exampleobject.txt yang berada di folder exampledir dalam bucket examplebucket.

const OSS = require('ali-oss')

const client = new OSS({
  // Setel yourRegion ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel Region ke oss-cn-hangzhou.
  region: 'yourRegion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Tentukan nama bucket. Misalnya, examplebucket.
  bucket: 'examplebucket',
});

// Tentukan path lengkap objek. Misalnya, exampledir/exampleobject.txt. Path lengkap objek tidak boleh memuat nama bucket.
const objectName='exampledir/exampleobject.txt'

// Dapatkan informasi tag objek.
async function getObjectTagging(objectName) {
  try {
    const result = await client.getObjectTagging(objectName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName)

Dapatkan informasi tag untuk versi tertentu dari suatu objek

Jika pengendalian versi diaktifkan untuk bucket, Anda dapat mengambil tag dari versi tertentu objek dengan menentukan ID versi (versionId) objek tersebut.

Kode berikut menunjukkan cara mengambil tag dari versi tertentu file exampleobject.txt yang berada di folder exampledir dalam bucket examplebucket.

Catatan

Untuk informasi selengkapnya tentang cara mendapatkan ID versi, lihat Daftar objek (Node.js SDK).

const OSS = require('ali-oss')

const client = new OSS({
  // Setel yourRegion ke wilayah tempat bucket berada. Misalnya, jika bucket berada di wilayah China (Hangzhou), setel Region ke oss-cn-hangzhou.
  region: 'yourRegion',
  // Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Tentukan nama bucket. Misalnya, examplebucket.
  bucket: 'examplebucket',
});

// Tentukan path lengkap objek. Misalnya, exampledir/exampleobject.txt. Path lengkap objek tidak boleh memuat nama bucket.
const objectName='exampledir/exampleobject.txt'
// Tentukan ID versi objek.
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'

// Dapatkan informasi tag objek.
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)

Referensi

  • Untuk kode contoh lengkap tentang pengambilan tag objek, lihat GitHub.

  • Untuk informasi selengkapnya tentang operasi API untuk mengambil tag objek, lihat GetObjectTagging.