You need to enable JavaScript to run this app.
导航
对象存储
  • 文档首页
    • /
  • 对象存储

RestoreObject

最近更新时间：2024.04.22 10:39:13

首次发布时间：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: examplebucket.tos.<Region>.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

请求参数和消息头

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

名称

位置

参数类型

是否必选

示例值

说明

restore

Query

String

是

restore

代表 RestoreObject 请求的特殊标识。

versionId

Query

String

否

/

对象的版本号。指定对象恢复的版本。

请求元素

名称

参数类型

是否必选

示例值

说明

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 模式取回。

响应消息头

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

响应元素

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

请求示例

请求示例 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