# 恢复归档存储深度归档存储对象 #### 功能说明 恢复指定的存储类型为cold的对象或按指定的对象名前缀批量恢复存储类型为cold的对象。 ![](https://support.huaweicloud.com/utiltg-obs/public_sys-resources/note_3.0-zh-cn.png) - 恢复过程中无法读取对象内容。 - 恢复存储对象后，其实际转换为可下载状态的完成时间依赖于OBS服务端。 - 当前obsutil暂不支持查询恢复状态，您可以通过OBSBrowser+工具或者调用获取对象元数据接口查询恢复状态。 ![](https://support.huaweicloud.com/utiltg-obs/public_sys-resources/caution_3.0-zh-cn.png) obsutil 无法识别并跳过已恢复对象，重复恢复归档存储和深度归档对象时，在延长恢复有效期的同时，将重复收取恢复时所产生的恢复费用。产生的标准存储类别的对象副本有效期将会延长，并收取在延长时间段产生的标准存储副本费用。 #### 命令结构 - 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 -d=30** ，批量恢复桶中所有存储类型为归档存储的对象，并指定恢复保留天数为30天（配置-d参数可设置恢复有效期）。 ``` obsutil restore obs://bucket-test -r -f -d=30 Start at 2026-07-10 04:06:05.0639625 +0000 UTC [-----------------------------------------------] 100.00% tps:0.00 1/1 80ms Succeed count: 1 Failed count: 0 Metrics [max cost:38 ms, min cost:38 ms, average cost:38.00 ms, average tps:10.20] Task id: 755fa156-70fa-4da4-9965-8a0db69a723a ``` #### 参数说明 | **参数** | **约束** | **描述** | |:---|:---|:---| | bucket | 必选 | 桶名。 | | key | 恢复单个存储类型为cold的对象时必选 批量恢复存储类型为cold的对象时可选 | 待恢复的对象名，或批量恢复的对象名前缀。 说明： 批量恢复时，如果该值为空，则表示恢复桶内所有存储类型为cold的对象。 | | d | 附加参数，可选 | 存储类型为cold的对象恢复后的保存时间，单位：天，取值范围是1\~30。默认为1。 | | t | 附加参数，可选 | 恢复选项。支持的值： - standard - expedited 说明： - expedited表示快速恢复对象，归档存储恢复耗时1\~5 min，深度归档存储恢复约耗时3\~5 h。 - standard表示标准恢复对象，归档存储恢复耗时3\~5 h，深度归档存储恢复约耗时5\~12 h。 - 不设置该选项时，默认使用expedited模式。 | | versionId | 附加参数，恢复单个cold存储对象时可选 | 待恢复cold存储对象的版本号。 | | fs | 附加参数，可选 | 是否使用并行文件系统的列举方式，如果桶是并行文件系统，推荐加上该参数。 注意： - 该列举方式会因为目录结构，耗时会差别很大。 - 该参数开启后，会忽略marker和limit值，统计桶或者并行文件系统或者指定目录的大小。 - Util 5.5.12版本及以上支持该参数。 | | encoding-type | 附加参数，可选 | 对象名有特殊字符时，取值为url。 说明： 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 | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | token | 附加参数，可选 | 指定用户的securitytoken。 | #### 响应结果 请参考上传对象的[响应结果](https://support.huaweicloud.com/utiltg-obs/obs_11_0013.html#obs_11_0013__section6926520122416)。