Object Storage Service:オブジェクトタグの取得 (Node.js SDK)

オブジェクトタグ情報の取得

バケットでバージョン管理が無効になっている場合、オブジェクトのタグ情報を取得できます。バケットでバージョン管理が有効になっている場合、OSS はデフォルトでオブジェクトの現在のバージョンのタグを取得します。

次のコードは、examplebucket バケットの exampledir フォルダにある exampleobject.txt ファイルのタグを取得する方法を示しています。

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが所在するリージョンに yourRegion を設定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourRegion',
  // 環境変数からアクセス認証情報を取得します。 このコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // バケット名を指定します。 例：examplebucket。
  bucket: 'examplebucket',
});

// オブジェクトの完全なパスを指定します。 例：exampledir/exampleobject.txt。 オブジェクトの完全なパスにバケット名を含めることはできません。
constobjectName='exampledir/exampleobject.txt'

// オブジェクトのタグ情報を取得します。
async function getObjectTagging(objectName) {
  try {
    const result = await client.getObjectTagging(objectName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName)

オブジェクトの特定バージョンのタグ情報の取得

バケットでバージョン管理が有効になっている場合、オブジェクトのバージョン ID (versionId) を指定することで、オブジェクトの特定バージョンのタグを取得できます。

次のコードは、examplebucket バケットの exampledir フォルダにある exampleobject.txt ファイルの特定バージョンのタグを取得する方法を示しています。

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが所在するリージョンに yourRegion を設定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンを oss-cn-hangzhou に設定します。
  region: 'yourRegion',
  // 環境変数からアクセス認証情報を取得します。 このコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // バケット名を指定します。 例：examplebucket。
  bucket: 'examplebucket',
});

// オブジェクトの完全なパスを指定します。 例：exampledir/exampleobject.txt。 オブジェクトの完全なパスにバケット名を含めることはできません。
const objectName='exampledir/exampleobject.txt'
// オブジェクトのバージョン ID を指定します。
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'

// オブジェクトのタグ情報を取得します。
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)

関連ドキュメント

• オブジェクトタグを取得するための完全なサンプルコードについては、GitHub をご参照ください。

• オブジェクトタグを取得するための API 操作の詳細については、「GetObjectTagging」をご参照ください。