restore-object

注意事项

• 阿里云账号默认拥有解冻文件的权限。如果您需要通过RAM用户或者STS的方式进行解冻，您必须拥有oss:RestoreObject权限。具体操作，请参见为RAM用户授权自定义的权限策略。

• restore-object只针对归档或冷归档类型的Object，不适用于标准类型和低频访问类型的Object。

• 对于归档类型或者冷归档类型的Object，如果需要读取Object，请提前解冻。归档类型的Object解冻有分钟级延迟，冷归档类型的Object解冻有数小时延迟。

计费说明

解冻文件会产生存储费用、数据取回容量费用、请求费用，如果您解冻的是冷归档和深度冷归档类型的数据，还会产生临时存储费用。

• 存储费用：归档、冷归档、深度冷归档类型的Object在解冻过程中和完成后，均按照相应的存储类型计算存储费用。更多信息，请参见存储费用。

• 数据取回容量费用：解冻归档、冷归档、深度冷归档类型的Object会产生数据取回容量费用。更多信息，请参见数据处理费用。

• 请求费用：

  • 解冻归档类型的Object会产生Put类型请求次数费用。更多信息，请参见请求费用。

  • 解冻冷归档、深度冷归档类型的Object会产生取回请求次数费用。更多信息，请参见请求费用。

• 临时存储费用：冷归档、深度冷归档类型的Object在解冻时，会生成一份标准存储类型的文件副本用于访问，该文件在解冻时间结束前会以标准存储的存储费率计算临时存储费用。更多信息，请参见临时存储费用。

解冻过程

不同存储类型的Object的解冻过程相同。Object的解冻过程如下。

1. 初始时，Object处于冷冻状态。

2. 提交一次解冻请求后，Object处于解冻中状态。

3. 服务端完成解冻任务后，Object进入解冻状态。此时您可以读取Object。

4. 如果Object处于解冻状态时，再次提交一次解冻请求，Object的解冻状态持续时间在原基础上累加。延长后的总时长不能超过每种存储类型的解冻状态持续时间的最大值。

5. 解冻状态结束后，Object再次返回到冷冻状态，且不改变Object原有的存储类型。

解冻消耗时间

解冻不同存储类型的Object所消耗的时间可参考下表。解冻时间请以实际为准。

解冻配额

• 单个阿里云账号在单个地域的冷归档类型的Object的解冻配额参考值：平均每秒500个Object，三种解冻优先级总解冻配额为每天100 TB~120 TB。如您的业务有更高的解冻配额需求，请联系技术支持。

• 单个阿里云账号在单个地域的深度冷归档类型的Object解冻配额参考值：平均每秒100个Object，两种解冻优先级总解冻配额为每天10 TB~15 TB。如您的业务有更高的解冻配额需求，请联系技术支持。

解冻状态持续时间

不同存储类型的Object处于解冻状态的持续时间如下。

命令格式

ossutil api restore-object --bucket value --key value [flags]

--restore-request

--restore-request配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

• XML语法：

  <RestoreRequest>
    <Days>integer</Days>
    <JobParameters>
      <Tier>string</Tier>
    </JobParameters>
  </RestoreRequest>

• JSON语法：

  {
    "Days": integer,
    "JobParameters": {
      "Tier": "string"
    }
  }

使用示例

相关API

restore-object命令对应API接口RestoreObject。关于API中的具体信息，请参见RestoreObject。