すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:オブジェクトタグの照会

最終更新日:Dec 18, 2023

オブジェクトのタグを設定した後、オブジェクトのタグを照会できます。 タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、object Storage Service (OSS) はデフォルトでオブジェクトの現在のバージョンのタグを返します。 オブジェクトの指定されたバージョンのタグを照会するには、オブジェクトのバージョンIDを指定する必要があります。

オブジェクトのタグの照会

タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっていない場合は、要件に基づいてオブジェクトのタグを照会できます。 タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、OSSはデフォルトでオブジェクトの現在のバージョンのタグを返します。

次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトのタグを照会する方法の例を示しています。

const OSS = require('ali-OSS ')

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

// オブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。 バケット名をフルパスに含めないでください。 
constobjectName='exampledir/exampleobject.txt'

// オブジェクトのタグを照会します。 
async関数getObjectTagging(objectName) {
  try {
    const result = await client.getObjectTagging(objectName);
    console.log (結果);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName) 

オブジェクトの指定されたバージョンのタグを照会する

タグを照会するオブジェクトを格納するバケットのバージョン管理が有効になっている場合、オブジェクトのバージョンIDを指定して、指定したバージョンのオブジェクトのタグを照会できます。

次のサンプルコードは、examplebucketバケットのexampledirディレクトリにあるexampleobject.txtオブジェクトの指定されたバージョンのタグを照会する方法の例を示しています。

説明

バージョンIDの取得方法の詳細については、「オブジェクトのリスト」をご参照ください。

const OSS = require('ali-OSS ')

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

// オブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。 バケット名をフルパスに含めないでください。 
const objectName='exampledir/exampleobject.txt'
// オブジェクトのバージョンIDを指定します。 
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk ****'

// オブジェクトのタグを照会します。 
async関数getObjectTagging(objectName) {
  try {
    const options = {
      versionId
    };
    const result = await client.getObjectTagging(objectName、オプション);
    console.log (結果);
  } catch (e) {
    console.log(e);
  }
}

getObjectTagging(objectName) 

参考資料

  • オブジェクトのタグのクエリに使用される完全なサンプルコードについては、GitHubをご覧ください。

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