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

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

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

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

const OSS = require('ali-oss')

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

// Specify the full path of the object. Example: exampledir/exampleobject.txt. Do not include the bucket name in the full path. 
constobjectName='exampledir/exampleobject.txt'

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

getObjectTagging(objectName)

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

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

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

const OSS = require('ali-oss')

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

// Specify the full path of the object. Example: exampledir/exampleobject.txt. Do not include the bucket name in the full path. 
const objectName='exampledir/exampleobject.txt'
// Specify the version ID of the object. 
const versionId='CAEQIRiBgMDqvPqA3BciIDJhMjE4MWZkN2ViYTRmYzJhZjkxMzk2YWM2NjJk****'

// Query the tags 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)

関連ドキュメント

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

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