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

Object Storage Service:オブジェクトを復元する

最終更新日:Nov 12, 2024

オブジェクトを読み取る前に、ArchiveオブジェクトまたはCold Archiveオブジェクトを復元する必要があります。 このトピックでは、ArchiveオブジェクトまたはCold Archiveオブジェクトを復元する方法について説明します。

説明

ストレージクラスがArchiveまたはCold Archiveでないオブジェクトでは、RestoreObject操作を呼び出さないでください。

Archive オブジェクトの復元

次のサンプルコードは、Archiveオブジェクトを復元する方法の例を示しています。

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 the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the name of the bucket. Example: examplebucket. 
  bucket: 'examplebucket',
});

// Specify the name of the Archive object that you want to restore. Example: exampleobject.txt. 
client.restore('exampleobject.txt').then((res) => {
    console.log(res);
}).catch(err => {
    console.log(err);
})

Cold Archiveオブジェクトを復元する

次のサンプルコードは、Cold Archiveオブジェクトを復元する方法の例を示しています。

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 the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured. 
  accessKeyId: process.env.OSS_ACCESS_KEY_ID,
  accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
  authorizationV4: true,
  // Specify the name of the bucket. Example: examplebucket. 
  bucket: 'examplebucket',
});

const restoreOptions = {
  // Specify Cold Archive as the storage class. 
  type: 'ColdArchive', 
  // Set JobParameters to specify a restoration priority for the object. 
  // Expedited: The object is restored within 1 hour. 
  // Standard: The object is restored within 2 to 5 hours. If you leave JobParameters empty, Standard is used as the restoration priority. 
  // Bulk: The object is restored within 5 to 12 hours. 
  JobParameters: 'Bulk', 
  // The Days parameter is used to specify the duration in which the object can remain in the restored state. Unit: days. Valid values: 1 to 7. 
  Days: 2,
};

client.restore('exampleobject.txt', restoreOptions)
  .then(res => {
    console.log(res);
  })
  .catch(err => {
    console.log(err);
  });

関連ドキュメント

  • アーカイブまたはコールドアーカイブオブジェクトの復元に使用される完全なサンプルコードについては、GitHubをご参照ください。

  • ArchiveオブジェクトまたはCold Archiveオブジェクトを復元するために呼び出すことができるAPI操作の詳細については、「RestoreObject」をご参照ください。