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

Object Storage Service:バージョン管理 (Node.js SDK)

最終更新日:Nov 30, 2025

バージョン管理はバケット内のすべてのオブジェクトに適用されます。バージョン管理を使用すると、オブジェクトが誤って上書きまたは削除された場合に、バケット内の以前のいずれかのバージョンに復元できます。

バケットのバージョン管理の状態は、バージョン管理が無効 (デフォルト)、バージョン管理が有効、バージョン管理が一時停止の 3 つのいずれかです。バージョン管理の詳細については、「バージョン管理」をご参照ください。

説明

バージョン管理は、ソフトウェア開発キット (SDK) バージョン 6.8.0 以降でサポートされています。

バケットのバージョン管理状態の設定

次のコードは、バケットのバージョン管理を有効または一時停止する方法を示しています。

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,
  // bucket をご使用のバケット名に設定します。
  bucket: 'yourbucketname'
});

async function putBucketVersioning() {
  // バケットのバージョン管理状態を Enabled または Suspended に設定します。
  const status = 'Enabled'; // `Enabled` または `Suspended`
  const result = await client.putBucketVersioning('BucketName', status);
  console.log(result);
}
putBucketVersioning();

バケットのバージョン管理状態の取得

次のコードは、バケットのバージョン管理状態を取得する方法を示しています。

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,
  // bucket をご使用のバケット名に設定します。
  bucket: 'yourbucketname'
});

async function getBucketVersioning() {
  // バケットのバージョン管理状態を取得します。
  const result = await client.getBucketVersioning('BucketName');
  console.log(result.versionStatus);
}
getBucketVersioning();

バケット内のすべてのオブジェクトバージョンのリスト

次のコードは、指定されたバケット内の削除マーカーを含むすべてのオブジェクトバージョンをリストする方法を示しています。

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,
  // bucket をご使用のバケット名に設定します。
  bucket: 'yourbucketname'
});

async function getBucketVersions() {
  // 削除マーカーを含むすべてのオブジェクトバージョンをリストします。
  const result = await client.getBucketVersions();
  console.log(result.objects); 
  console.log(result.deleteMarker);
}
getBucketVersions();

関連ドキュメント

  • バージョン管理の完全なサンプルコードについては、「GitHub の例」をご参照ください。

  • バケットのバージョン管理状態を設定する API 操作の詳細については、「PutBucketVersioning」をご参照ください。

  • バケットのバージョン管理状態を取得する API 操作の詳細については、「GetBucketVersioning」をご参照ください。

  • 削除マーカーを含む、バケット内のすべてのオブジェクトバージョンをリストする API 操作の詳細については、「ListObjectVersions (GetBucketVersions)」をご参照ください。