バケットのバージョン管理設定は、バケット内のすべてのオブジェクトに適用されます。 バケットのバージョン管理を有効にすると、誤ってオブジェクトを上書きまたは削除したときに、バケット内のオブジェクトの以前のバージョンを復元できます。
バケットのバージョン管理を有効にすると、誤ってオブジェクトを上書きまたは削除したときに、バケット内のオブジェクトの以前のバージョンを復元できます。 バケットは、無効 (デフォルト) 、有効、または一時停止のいずれかのバージョン管理状態にすることができます。 バージョン管理の詳細については、「概要」をご参照ください。
バージョン管理は、Node.js 6.8.0以降のObject Storage Service (OSS) SDKでサポートされています。
バケットのバージョン管理の構成
次のサンプルコードは、バケットのバージョン管理を有効または一時停止する方法の例を示しています。
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.
bucket: 'yourbucketname'
});
async function putBucketVersioning() {
// Set the versioning state of the bucket to Enabled or Suspended.
const status = 'Enabled'; // `Enabled` or `Suspended`
const result = await client.putBucketVersioning('BucketName', status);
console.log(result);
}
putBucketVersioning();
バケットのバージョン管理状態の照会
次のサンプルコードは、バケットのバージョン管理状態を照会する方法の例を示しています。
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.
bucket: 'yourbucketname'
});
async function getBucketVersioning() {
// Query the versioning state of the bucket.
const result = await client.getBucketVersioning('BucketName');
console.log(result.versionStatus);
}
getBucketVersioning();
バケット内の全オブジェクトのバージョン一覧表示
次のサンプルコードは、バケット内の削除マーカーを含むすべてのオブジェクトのバージョンを一覧表示する方法の例を示しています。
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.
bucket: 'yourbucketname'
});
async function getBucketVersions() {
// List the versions of all objects, including delete markers.
const result = await client.getBucketVersions();
console.log(result.objects);
console.log(result.deleteMarker);
}
getBucketVersions();
関連ドキュメント
バージョン管理の完全なサンプルコードについては、『GitHub』をご参照ください。
バケットのバージョン管理を構成するために呼び出すことができるAPI操作の詳細については、「PutBucketVersioning」をご参照ください。
バケットのバージョン管理状態を照会するために呼び出すことができるAPI操作の詳細については、「GetBucketVersioning」をご参照ください。
バケット内の削除マーカーを含むすべてのオブジェクトのバージョンを一覧表示するために呼び出すAPI操作の詳細については、「ListObjectVersions (GetBucketVersions) 」をご参照ください。