恢复归档或深度归档存储对象

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 在桶列表中，单击待操作的桶，进入“对象”页面。
3. 单击待恢复对象操作列的“恢复”。

   也可以选中多个对象，单击对象列表上方的“更多>恢复”恢复多个对象。

   图3 恢复对象
   

4. 恢复对象需要设置对象的有效期和恢复速率，参数解释如下表所示：

   表3 恢复对象

   参数	说明
   有效期	对象恢复后，保持为“已恢复”状态的时长，从对象恢复完成开始计时。有效期时长可设置1-30天的整数。系统默认有效期为30天。 例如：恢复对象时，有效期设置为20天，则从对象恢复成功后开始算起，20天后，该对象则会从“已恢复”状态变成“未恢复”状态。
   速率	对象的恢复速度。 加急：可在1-5分钟内恢复归档存储数据，3-5小时内恢复深度归档存储数据。 标准：可在3-5小时内恢复归档存储数据，5-12小时内恢复深度归档存储数据。

5. 单击“确定”。
   

   系统每天会在UTC 00:00点检查一次文件恢复情况，过期时间是根据最近一次系统检查时间开始计算的。

恢复归档存储或深度归档存储对象

1. 登录OBS Browser+。
2. 单击待恢复文件或文件夹所在的桶，进入对象列表页面。
3. 选中待恢复文件或文件夹，单击“更多”->“恢复对象”，如下图4所示。
   图4 恢复对象
   

   恢复对象需要设置对象的有效期和恢复速率，参数解释如表4所示：

   表4 恢复对象

   参数	说明
   对象名	恢复的对象名或路径名。
   有效期	对象恢复后，保持为“已恢复”状态的时间。从对象恢复完成开始计时。有效期时间可设置1-30天的整数。系统默认有效期为30天。 例如：恢复对象时，有效期设置为20天，则从对象恢复成功后算起20天后，该对象又会从“已恢复”状态变成“未恢复”状态。
   速率	对象的恢复速度。 加急：可在1-5分钟内恢复小于250MB的数据。 标准：可在3-5小时内恢复所有归档数据。

4. 单击“确定”，确认恢复归档存储的文件或文件夹。

   文件或文件夹恢复状态可单击对象右侧的图标，在“属性”页面查看“恢复状态”。文件恢复成功后才能对该文件进行下载操作。

命令结构：

• Windows操作系统
  • 恢复对象

    obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

  • 批量恢复对象

    obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

  • 批量恢复指定目录下的所有对象

    obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

• macOS/Linux操作系统
  • 恢复对象

    ./obsutil restore obs://bucket/key [-d=1] [-t=xxx] [-versionId=xxx] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

  • 批量恢复对象

    ./obsutil restore obs://bucket[/key] -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

  • 批量恢复指定目录下的所有对象

    ./obsutil restore obs://bucket/folder/ -r [-f] [-v] [-d=1] [-t=xxx] [-o=xxx] [-j=1] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-token=xxx]

运行示例：

• 以Windows操作系统为例，运行obsutil restore obs://bucket-test/key，恢复单个存储类型为cold的对象。

  obsutil restore obs://bucket-test/key
  Start at 2024-09-30 08:56:17.9537365 +0000 UTC
  
  Start to restore object [key] in the bucket [bucket-test] successfully, cost [252] ms, request id [0000019242250F754015F23EE0B7876E]

• 以Windows操作系统为例，运行obsutil restore obs://bucket-test -r -f，批量恢复桶中所有的存储类型为cold的对象。

  obsutil restore obs://bucket-test -r -f
  Start at 2024-09-30 08:57:11.3565648 +0000 UTC
  
  [================================================] 100.00% 3s
  Succeed count:   12        Failed count:    0
  Metrics [max cost:264 ms, min cost:54 ms, average cost:119.33 ms, average tps:19.70]
  Task id: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4

参数说明：

响应结果：

1. 在OBS管理控制台左侧导航栏选择“桶列表”。
2. 单击待查看恢复信息的对象名称，进入对象详情页面。在基本信息下即可查看对象的“恢复状态”和“恢复过期时间”。
   图5 查看对象恢复信息
   

调用获取对象元数据接口，查看接口响应头“x-obs-restore”，即可获取对象恢复状态和恢复过期时间。

调用各语言SDK的获取对象元数据接口，查看对应接口的返回参数“restore”，即可获取对象恢复状态和恢复过期时间。

命令结构：

• Windows操作系统

  obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

• macOS/Linux操作系统

  ./obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例：

• 以Windows操作系统为例，运行obsutil stat obs://bucket-test/key，查询对象基本属性。

  obsutil stat obs://bucket-test/key
  
  Start at 2024-09-25 04:48:10.1147483 +0000 UTC
  
  Key:
    obs://bucket-test/key
  LastModified:
    2018-11-16T02:15:49Z
  Size:
    7
  StorageClass:
    standard
  ETag:
    43d93b553855b0e1fc67e31c28c07b65
  ContentType:
    text/plain
  Type:
    file
  Metadata:
    key=value

参数说明：

响应结果：