Harmony解冻文件

注意事项

• 仅归档、冷归档类型以及深度冷归档类型的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';

/**
 * 恢复归档存储对象。
 * 使用restoreObject方法将归档存储类型（Archive或Cold Archive）的对象恢复到可读状态。
 */
const restoreObject = async () => {
  try {
    // 调用restoreObject方法恢复指定Bucket中的归档存储对象
    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函数执行恢复归档存储对象的操作
restoreObject();

相关文档

• 关于解冻文件的更多操作信息，请参见解冻文件。