RestoreObject--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

RestoreObject

最近更新时间：2024.08.26 19:15:14首次发布时间：2023.04.13 11:18:04

调用 RestoreObject 接口恢复归档存储（ARCHIVE）、冷归档（COLD_ARCHIVE）和深度冷归档（DEEP_COLD_ARCHIVE）对象。

注意事项

软链接不支持恢复。软链接的存储类型为归档、冷归档或深度冷归档时，您可直接访问该对象，而无需先对其恢复。通过软链接访问其指向的目标文件时，若目标文件的存储类型为归档、冷归档或深度冷归档，您需要先恢复该目标文件。
归档存储、冷归档和深度冷归档对象无法直接读取，您需要先恢复该对象，才能执行读取操作。恢复对象前，您需要拥有 RestoreObject 权限。
归档存储、冷归档和深度冷归档对象恢复后，TOS 会生成一份标准存储类型的临时副本文件供您读取。副本将在您设置的有效期后自动删除。
归档存储、冷归档和深度冷归档对象恢复后，您还可以使用 RestoreObject 接口延长副本的有效期。
注意
目前只支持延长副本有效期，不支持缩短。
归档存储、冷归档和深度冷归档的对象的恢复时间不同，说明如下：
- 归档存储文件恢复时间在 1 分钟内。
- 冷归档对象的恢复时间取决于您选择的恢复模式。不同恢复模式的取回时间及计费单价不同，时间越短，单价越高，恢复模式说明如下：
  - 快速取回：一般在 1~5 分钟内完成恢复。适用于需要紧急获取文件的场景。
  - 标准取回：一般在 2~5 小时内完成恢复。
  - 批量取回：一般在 5~12 小时内完成恢复。
- 深度冷归档对象的恢复时间取决于您选择的恢复模式。不同恢复模式的取回时间及计费单价不同，时间越短，单价越高，恢复模式说明如下：
  - 标准取回：一般在 12 小时内完成恢复。
  - 批量取回：一般在 48 小时内完成恢复。
深度冷归档目前处于邀测状态，如您需要使用该功能，请联系客户经理。

请求消息样式

POST /objectname?restore
Host: bucketname.tos-cn-beijing.volces.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
restore	Query	String	是	-	代表 RestoreObject 请求的特殊标识。
versionId	Query	String	否	570773C5A7847849299D	对象的版本号。指定对象恢复的版本。

请求元素

名称	参数类型	是否必选	示例值	说明
Days	Integer	是	10	对象的恢复天数。取值范围为 1~365。父节点为 RestoreRequest。
RestoreJobParameters	Object	否	-	恢复优先级信息。
Tier	String	否	Standard	恢复优先级。父节点为 RestoreJobParameters。归档存储对象的恢复优先级只能为 `Standard`，表示归档存储对象在 1 分钟内完成恢复。说明 `Standard` 对于归档存储、冷归档和深度冷归档对象的恢复优先级的意义不同，说明如下：如果恢复归档存储对象，设置 `Tier` 为 `Standard`，则归档存储对象将在 1 分钟内完成恢复。如果恢复冷归档对象，设置 `Tier` 为 `Standard`，则冷归档对象将在 2～5 小时内完成恢复。如果恢复深度冷归档对象，设置 `Tier` 为 `Standard`，则深度冷归档对象将在 12 小时内完成恢复。冷归档对象的恢复优先级取值如下： `Expedited`：快速取回，1～5 分钟内完成恢复。 `Standard`：标准取回，2～5 小时内完成恢复。 `Bulk`：批量取回，5～12 小时内完成恢复。深度冷归档对象的恢复优先级取值如下： `Standard`：标准取回，12 小时内完成恢复。 `Bulk`：批量取回，48 小时内完成恢复。不设置 RestoreJobParameters 信息，则默认使用 `Standard` 模式取回。

名称

参数类型

是否必选

示例值

说明

Days

Integer

是

对象的恢复天数。取值范围为 1~365。
父节点为 RestoreRequest。

RestoreJobParameters

Object

否

恢复优先级信息。

Tier

String

否

Standard

恢复优先级。父节点为 RestoreJobParameters。

归档存储对象的恢复优先级只能为 Standard，表示归档存储对象在 1 分钟内完成恢复。
说明
Standard 对于归档存储、冷归档和深度冷归档对象的恢复优先级的意义不同，说明如下：
- 如果恢复归档存储对象，设置 Tier 为 Standard，则归档存储对象将在 1 分钟内完成恢复。
- 如果恢复冷归档对象，设置 Tier 为 Standard，则冷归档对象将在 2～5 小时内完成恢复。
- 如果恢复深度冷归档对象，设置 Tier 为 Standard，则深度冷归档对象将在 12 小时内完成恢复。
冷归档对象的恢复优先级取值如下：
- Expedited：快速取回，1～5 分钟内完成恢复。
- Standard：标准取回，2～5 小时内完成恢复。
- Bulk：批量取回，5～12 小时内完成恢复。
深度冷归档对象的恢复优先级取值如下：
- Standard：标准取回，12 小时内完成恢复。
- Bulk：批量取回，48 小时内完成恢复。

不设置 RestoreJobParameters 信息，则默认使用 Standard 模式取回。

响应消息头

该请求返回公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

请求示例 1

恢复归档存储、冷归档或深度冷归档对象。

POST /objectname?restore
Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

{
  "Days": 10
}

请求示例 2

恢复指定版本的归档存储、冷归档或深度冷归档对象。

POST /objectname?restore&versionId=***
Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

{
    "Days": 10,
    "RestoreJobParameters": {
        "Tier": "Standard"
    }
}

请求示例 3

延长归档存储、冷归档或深度冷归档对象的副本有效期。

POST /objectname?restore
Host: examplebucket.tos.cn-beijing.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

{
  "Days": 12
}

响应示例

响应示例 1

首次恢复归档存储、冷归档或深度冷归档对象。

HTTP/1.1 202 Accepted
x-tos-id-2: 5726ce090a2d002d-a444ed0
x-tos-request-id: 5726ce090a2d002d-a444ed0
Date: Fri, 30 Jul 2021 08:05:36 GMT
server: TosServer
Content-Length: 0

响应示例 2

对处于恢复中状态的归档存储、冷归档或深度冷归档对象再次进行恢复。

HTTP/1.1 409 Conflict
x-tos-id-2: 5726ce090a2d002d-a444ed0
x-tos-request-id: 5726ce090a2d002d-a444ed0
Date: Fri, 30 Jul 2021 08:05:36 GMT
server: TosServer
Content-Length: 0

{
    "Code": "RestoreAlreadyInProgress",
    "RequestId": "23480125cb6573606625cb65-ac1a6118-1ryjQL-RO-cb-1AZ-F-LFRZ-B-K2-1",
    "HostId": "jONFHoplLHsdsOxAENiZdsWlVlti****",
    "Message": "Object restore is already in progress",
    "EC": "0017-00000507"
}

响应示例 3

对处于恢复完成状态的归档存储、冷归档或深度冷归档对象延长副本有效期。

HTTP/1.1 200 OK
x-tos-id-2: 5726ce090a2d002d-a444ed0
x-tos-request-id: 5726ce090a2d002d-a444ed0
Date: Fri, 30 Jul 2021 08:05:36 GMT
server: TosServer
Content-Length: 0