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

Object Storage Service:オブジェクトの解凍 (Node.js SDK)

最終更新日:Nov 30, 2025

アーカイブまたはコールドアーカイブのオブジェクトにアクセスするには、まずオブジェクトを解凍する必要があります。 このトピックでは、アーカイブおよびコールドアーカイブのオブジェクトを解凍する方法について説明します。

説明

アーカイブまたはコールドアーカイブのストレージクラスにないオブジェクトに対して 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 をご参照ください。