恢复归档存储对象
功能说明
恢复指定的存储类型为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 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
参数说明
|
参数 |
约束 |
描述 |
|---|---|---|
|
bucket |
必选 |
桶名。 |
|
key |
恢复单个存储类型为cold的对象时必选 批量恢复存储类型为cold的对象时可选 |
待恢复的对象名，或批量恢复的对象名前缀。
说明：
批量恢复时，如果该值为空，则表示恢复桶内所有存储类型为cold的对象。 |
|
d |
附加参数，可选 |
存储类型为cold的对象恢复后的保存时间，单位：天，取值范围是1~30。默认为1。 |
|
t |
附加参数，可选 |
恢复选项。支持的值：
说明：
|
|
versionId |
附加参数，恢复单个cold存储对象时可选 |
待恢复cold存储对象的版本号。 |
|
fs |
附加参数，可选 |
是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。
注意：
|
|
encoding-type |
附加参数，可选 |
对象名有特殊字符时，取值为url。
说明：
Util 5.5.12版本及以上支持该参数。 |
|
fr |
附加参数，恢复单个cold存储对象时可选 |
恢复单个cold存储对象时生成结果清单文件。 |
|
f |
附加参数，批量恢复cold存储对象时可选 |
强制操作，不进行询问提示。 |
|
r |
附加参数，批量恢复cold存储对象时必选 |
按指定的对象名前缀批量恢复cold存储对象。 |
|
v |
附加参数，批量恢复cold存储对象时可选 |
按指定的对象名前缀批量恢复多版本cold存储对象。 |
|
o |
附加参数，可选 |
生成结果清单文件的文件夹，命令执行完成后，会在该文件夹下生成结果清单文件（可能包含成功结果和失败结果两个文件），默认为运行obsutil命令的用户目录的子文件夹.obsutil_output。 |
|
j |
附加参数，批量恢复cold存储对象时可选 |
批量恢复cold存储对象的最大并发数，默认为配置文件中的defaultJobs。
说明：
工具会保证该值至少为1。 |
|
config |
附加参数，可选 |
运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 |
|
e |
附加参数，可选 |
指定终端节点。 |
|
i |
附加参数，可选 |
指定用户的AK。 |
|
k |
附加参数，可选 |
指定用户的SK。 |
|
token |
附加参数，可选 |
指定用户的securitytoken。 |
响应结果
请参考上传对象的响应结果。
