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

Object Storage Service:バージョン管理

最終更新日:Dec 18, 2023

バケットのバージョン管理設定は、バケット内のすべてのオブジェクトに適用されます。 バケットのバージョン管理を有効にすると、誤ってオブジェクトを上書きまたは削除したときに、バケット内のオブジェクトの以前のバージョンを復元できます。

バケットのバージョン管理を有効にすると、誤ってオブジェクトを上書きまたは削除したときに、バケット内のオブジェクトの以前のバージョンを復元できます。 バケットは、無効 (デフォルト) 、有効、または一時停止のいずれかのバージョン管理状態にすることができます。 バージョン管理の詳細については、「概要」をご参照ください。

説明

バージョン管理は、Node.js 6.8.0以降のObject Storage Service (OSS) SDKでサポートされています。

バケットのバージョン管理の構成

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

const OSS = require('ali-OSS ');

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

async関数putBucketVersioning() {
  // バケットのバージョン管理状態を有効または一時停止に設定します。 
  const status = 'Enabled'; // 'Enabled' または 'Suspended'
  const result = await client.putBucketVersioning('BucketName' 、status);
  console.log (結果);
}
putBucketVersioning(); 

バケットのバージョン管理状態の照会

次のサンプルコードは、バケットのバージョン管理状態を照会する方法の例を示しています。

const OSS = require('ali-OSS ');

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

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

バケット内の全オブジェクトのバージョン一覧表示

次のサンプルコードは、バケット内の削除マーカーを含むすべてのオブジェクトのバージョンを一覧表示する方法の例を示しています。

const OSS = require('ali-OSS ');

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

async関数getBucketVersions() {
  // 削除マーカーを含むすべてのオブジェクトのバージョンを一覧表示します。 
  const result = await client.getBucketVersions();
  console.log(result.objects); 
  console.log(result.de leteMarker);
}
getBucketVersions(); 

参考資料

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

  • バケットのバージョン管理を構成するために呼び出すことができるAPI操作の詳細については、「PutBucketVersioning」をご参照ください。

  • バケットのバージョン管理状態を照会するために呼び出すことができるAPI操作の詳細については、「GetBucketVersioning」をご参照ください。

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