アーカイブまたはコールドアーカイブのオブジェクトにアクセスするには、まずオブジェクトを解凍する必要があります。 このトピックでは、アーカイブおよびコールドアーカイブのオブジェクトを解凍する方法について説明します。
説明
アーカイブまたはコールドアーカイブのストレージクラスにないオブジェクトに対して RestoreObject メソッドを呼び出さないでください。
アーカイブオブジェクトの解凍
次のコードは、アーカイブオブジェクトを解凍する方法を示しています。
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',
});
// 解凍するアーカイブオブジェクトの名前を指定します。 例: exampleobject.txt。
client.restore('exampleobject.txt').then((res) => {
console.log(res);
}).catch(err => {
console.log(err);
})コールドアーカイブオブジェクトの解凍
次のコードは、コールドアーカイブオブジェクトを解凍する方法を示しています。
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',
});
const restoreOptions = {
// コールドアーカイブストレージクラスを指定します。
type: 'ColdArchive',
// JobParameters を使用して解凍優先度を指定します。
// 迅速:オブジェクトは 1 時間以内に解凍されます。
// 標準:オブジェクトは 2〜5 時間以内に解凍されます。 JobParameters を指定しない場合、デフォルトで標準が使用されます。
// バルク:オブジェクトは 5〜12 時間以内に解凍されます。
JobParameters: 'Bulk',
// Days を使用して、解凍されたオブジェクトがアクセス可能な日数を指定します。 値の範囲は 1〜7 です。
Days: 2,
};
client.restore('exampleobject.txt', restoreOptions)
.then(res => {
console.log(res);
})
.catch(err => {
console.log(err);
});関連ドキュメント
アーカイブおよびコールドアーカイブオブジェクトを解凍する方法を示す完全なサンプルコードについては、GitHub の例をご参照ください。
アーカイブおよびコールドアーカイブオブジェクトを解凍する API 操作の詳細については、RestoreObject をご参照ください。