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

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

最終更新日:Nov 30, 2025

不要になったオブジェクトタグは削除できます。バケットでバージョン管理が有効になっている場合、Object Storage Service (OSS) はデフォルトで現在のオブジェクトバージョンのタグを削除します。特定のバージョンからタグを削除するには、オブジェクトのバージョン ID を指定する必要があります。

オブジェクトタグの削除

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

次のコードは、examplebucket バケットの exampledir フォルダにある exampleobject.txt オブジェクトからオブジェクトタグを削除する方法の例です。

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが配置されているリージョンに region を設定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、region を 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'

// オブジェクトタグを削除します。
async function deleteObjectTagging(objectName) {
  try {
    const result = await client.deleteObjectTagging(objectName);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

deleteObjectTagging(objectName)

特定のバージョンのオブジェクトからのタグの削除

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

次のコードは、examplebucket バケットの exampledir フォルダにある exampleobject.txt オブジェクトの特定のバージョンのタグを削除する方法の例です。

説明

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

const OSS = require('ali-oss')

const client = new OSS({
  // バケットが配置されているリージョンに region を設定します。 たとえば、バケットが中国 (杭州) リージョンにある場合は、region を 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 deleteObjectTagging(objectName) {
  try {
    const options = {
      versionId
    };
    const result = await client.deleteObjectTagging(objectName, options);
    console.log(result);
  } catch (e) {
    console.log(e);
  }
}

deleteObjectTagging(objectName)

関連ドキュメント

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

  • オブジェクトタグの削除に使用される API 操作の詳細については、「DeleteObjectTagging」をご参照ください。