通過Harmony SDK解凍歸檔、冷歸檔和深度冷歸檔Object - Object Storage Service

歸檔、冷歸檔以及深度冷歸檔類型的檔案需要解凍之後才能讀取。檔案解凍後，會產生一個標準儲存類型的檔案副本，即同時存在標準儲存類型的檔案副本和歸檔、冷歸檔或深度冷歸檔的原檔案。在檔案解凍的有效期間過後，標準儲存類型的檔案副本會自動刪除。本文介紹如何使用OSS Harmony SDK解凍歸檔、冷歸檔以及深度冷歸檔檔案。

注意事項

僅歸檔、冷歸檔類型以及深度冷歸檔類型的Object支援調用RestoreObject方法。
關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。
要解凍檔案，您必須有oss:RestoreObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

範例程式碼

您可以使用以下代碼解凍歸檔、冷歸檔或者深度冷歸檔檔案：

import Client, { RequestError } from '@aliyun/oss';

// 建立OSS用戶端執行個體
const client = new Client({
  // 請替換為STS臨時訪問憑證的Access Key ID
  accessKeyId: 'yourAccessKeyId',
  // 請替換為STS臨時訪問憑證的Access Key Secret
  accessKeySecret: 'yourAccessKeySecret',
  // 請替換為STS臨時訪問憑證的Security Token
  securityToken: 'yourSecurityToken',
  // 填寫Bucket所在地區。以華東1（杭州）為例，Region填寫為oss-cn-hangzhou
  region: 'oss-cn-hangzhou',
});

// 指定要操作的Bucket名稱，請替換為您實際使用的Bucket名稱
const bucket = 'yourBucketName';
// 指定要恢複的對象（檔案）名稱，請替換為您實際要恢複的對象名稱
const key = 'yourObjectName';

/**
 * 恢複Archive Storage對象。
 * 使用restoreObject方法將Archive Storage類型（Archive或Cold Archive）的對象恢複到可讀狀態。
 */
const restoreObject = async () => {
  try {
    // 調用restoreObject方法恢複指定Bucket中的Archive Storage對象
    const res = await client.restoreObject({
      bucket, // Bucket名稱
      key,    // 對象（檔案）名稱
      restoreRequest: {
        days: 2, // 恢複後的有效天數，單位為天。在此期間內可以讀取該對象
      },
    });

    // 列印恢複結果
    console.log(JSON.stringify(res));
  } catch (err) {
    // 捕獲請求過程中的異常資訊
    if (err instanceof RequestError) {
      // 如果是已知類型的錯誤，則列印錯誤碼、錯誤訊息、請求ID、狀態代碼、EC碼等資訊
      console.log('code: ', err.code); // 錯誤碼
      console.log('message: ', err.message); // 錯誤訊息
      console.log('requestId: ', err.requestId); // 請求ID
      console.log('status: ', err.status); // HTTP狀態代碼
      console.log('ec: ', err.ec); // 錯誤碼
    } else {
      // 列印其他未知類型的錯誤
      console.log('unknown error: ', err);
    }
  }
};

// 調用restoreObject函數執行恢複Archive Storage對象的操作
restoreObject();

Object Storage Service：Harmony解凍檔案

注意事項

範例程式碼

相關文檔