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

versionId

String

否

参数解释：

待恢复归档存储或深度归档存储对象的版本号。

约束限制：

无

取值范围：

无

默认取值：

无，如果不设置则默认指定最新版本的对象。

RestoreRequest

Container

是

参数解释：

恢复信息的容器。

约束限制：

无

取值范围：

无

默认取值：

无

Days

Integer

是

参数解释：

恢复对象后，会生成一个对象的标准存储副本，此参数指定恢复有效期，即标准存储副本的保存时间。

约束限制：

保存时间是从对象发起取回后的第一个 北京时间 08: 00 开始计算的。

以保存时间为一天为例，取回发起时间在 27号 08: 00 到 28号 08: 00 之间的取回，实际过期时间都是29号的 08: 00。

取值范围：

[1, 30]，单位：天。

默认取值：

无

RestoreJob

Container

否

参数解释：

恢复选项的容器。

约束限制：

无

取值范围：

无

默认取值：

无

Tier

String

否

参数解释：

恢复选项，用户可根据需求选择恢复选项，不同的恢复选项恢复耗时不同。

取值范围：

• Expedited：表示快速恢复对象，归档存储恢复耗时1~5 min，深度归档（受限公测）存储恢复约耗时3~5 h。
• Standard：表示标准恢复对象，归档存储恢复耗时3~5 h，深度归档（受限公测）存储恢复约耗时5~12 h。

默认取值：

Standard

RestoreAlreadyInProgress

参数解释：

对象正在恢复，请求冲突。

ErrorMessage: Object restore is already in progress

409 Conflict

ObjectHasAlreadyRestored

参数解释：

已经恢复的对象，禁止缩短恢复保存时间。

ErrorMessage:After restoring an archived object, you cannot shorten the restoration period of the archived object

409 Conflict

MalformedXML

参数解释：

Days字段不合法（不为整数）。

ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema

400 Bad Request

InvalidArgument

参数解释：

Days字段取值超出范围（1<=days<=30)。

ErrorMessage: restoration days should be at least 1 and at most 30

400 Bad Request

MalformedXML

参数解释：

Tier字段不合法。

ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema

400 Bad Request

InvalidObjectState

参数解释：

恢复的对象不是归档存储或深度归档存储对象。

ErrorMessage: Restore is not allowed, as object's storage class is not COLD or DEEP_ARCHIVE

403 Forbidden