对象存储服务 OBS-恢复归档存储对象:参数说明

时间:2024-12-11 17:17:48

参数说明

参数

约束

描述

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版本及以上支持该参数。

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

附加参数,可选

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

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

token

附加参数,可选

指定用户的securitytoken。

support.huaweicloud.com/utiltg-obs/obs_11_0016.html