RestoreObject_对象存储_API调试

版本控制

Object 的各个版本可以对应不同的存储类型。调用 RestoreObject 接口默认解冻 Object 当前版本，您可以通过指定 versionId 的方式来解冻 Object 指定版本。

• 如果针对该 Object 第一次调用 RestoreObject 接口，则返回 202。
• 如果已经成功调用过 RestoreObject 接口，且 Object 已完成解冻，再次调用时返回 200 OK。

解冻过程说明

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

归档类型或者冷归档类型的 Object 在执行解冻前后的状态变换过程如下：

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

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

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

• 对于归档类型的 Object，解冻状态默认持续 24 小时，24 小时内再次调用 RestoreObject 接口则解冻状态会自动延长 24 小时，一次解冻流程内可有效调用 7 次 RestoreObject 接口达到最长 7 天的解冻持续时间。您也可以通过传入解冻天数，一次调用 RestoreObject 接口指定最长 7 天的解冻持续时间。

• 对于冷归档类型的 Object，您可以指定解冻天数和解冻优先级，解冻天数最短为 1 天，最长为 7 天。不同解冻优先级的首字节取回时间如下：

  • 高优先级（Expedited）：表示 1 小时内完成解冻。
  • 标准（Standard）：表示 2~5 小时内完成解冻。如果不传入 JobParameters 节点，则默认为 Standard。
  • 批量（Bulk）：表示 5~12 小时内完成解冻。

4、解冻状态结束后，Object 再次返回到冷冻状态。

计费说明

状态变换过程中产生的相关费用如下：

• 对处于冷冻状态的 Object 执行解冻操作，会产生数据取回费用。
• 解冻状态最多延长 7 天。在此期间不再重复收取数据取回费用。
• 解冻状态结束后，Object 又回到冷冻状态，再次执行解冻操作会收取数据取回费用。