文档首页/ 对象存储服务 OBS/ 工具指南/ obsutil/ 对象相关命令/ 恢复归档存储对象
更新时间：2024-09-03 GMT+08:00
查看PDF
分享

恢复归档存储对象

功能说明

恢复指定的存储类型为cold的对象或按指定的对象名前缀批量恢复存储类型为cold的对象。

  • 恢复过程中无法读取对象内容。
  • 恢复存储对象后，其实际转换为可下载状态的完成时间依赖于OBS服务端。
  • 当前obsutil暂不支持查询恢复状态，您可以通过OBSBrowser+工具或者调用获取对象元数据接口查询恢复状态；

重复恢复归档存储数据时在延长恢复有效期的同时，也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长，并且收取延长时间段产生的标准存储副本费用。

命令结构

  • 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 to restore object [key] in the bucket [bucket-test] successfully!
  • 以Windows操作系统为例，运行obsutil restore obs://bucket-test -r -f，批量恢复桶中所有的存储类型为cold的对象。 
    obsutil restore obs://bucket-test -r -f

[================================================] 100.00% 3s
Succeed count is:   12        Failed count is:    0
Metrics [max cost:264 ms, min cost:54 ms, average cost:119.33 ms, average tps:19.70]
Task id is: 96f104ee-d0bf-40ff-95dd-31dec0d8f4f4

参数说明

参数

约束

描述

bucket

必选

桶名。

key

恢复单个存储类型为cold的对象时必选

批量恢复存储类型为cold的对象时可选

待恢复的对象名，或批量恢复的对象名前缀。

说明：

批量恢复时，如果该值为空，则表示恢复桶内所有存储类型为cold的对象。

d

附加参数，可选

存储类型为cold的对象恢复后的保存时间，单位：天，取值范围是1~30。默认为1。

t

附加参数，可选

恢复选项。支持的值：

  • standard
  • expedited
说明：
  • expedited表示快速恢复对象，归档存储恢复耗时1~5 min。
  • standard表示标准恢复对象，归档存储恢复耗时3~5 h。
  • 不设置该选项时，默认使用expedited模式。

versionId

附加参数，恢复单个cold存储对象时可选

待恢复cold存储对象的版本号。

fs

附加参数，可选

是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。

注意：
  • 该列举方式会因为目录结构，耗时会差别很大。
  • 该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。
  • Util 5.5.12版本及以上支持该参数。

fr

附加参数，恢复单个cold存储对象时可选

恢复单个cold存储对象时生成结果清单文件。

f

附加参数，批量恢复cold存储对象时可选

强制操作，不进行询问提示。

r

附加参数，批量恢复cold存储对象时必选

按指定的对象名前缀批量恢复cold存储对象。

v

附加参数，批量恢复cold存储对象时可选

按指定的对象名前缀批量恢复多版本cold存储对象。

o

附加参数，可选

生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。

说明：
  • 结果清单文件命名规则：restore_{succeed | failed}_report_时间_TaskId.txt。

    单个结果清单文件默认情况下最大为30MB且最大可保留的文件个数为1024，可在配置文件中通过recordMaxLogSize和recordBackups分别配置。

j

附加参数，批量恢复cold存储对象时可选

批量恢复cold存储对象的最大并发数，默认为配置文件中的defaultJobs。

说明：

工具会保证该值至少为1。

config

附加参数，可选

运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。

e

附加参数，可选

指定终端节点。

i

附加参数，可选

指定用户的AK。

k

附加参数，可选

指定用户的SK。

token

附加参数，可选

指定用户的securitytoken。

响应结果

请参考上传对象的响应结果。

父主题： 对象相关命令

相关文档