You need to enable JavaScript to run this app.
导航

RestoreObject

最近更新时间2024.02.21 16:45:17

首次发布时间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

/

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

请求元素

名称

参数类型

是否必选

示例值

说明

RestoreRequest

Object

-

恢复请求信息。

Days

Integer

10

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

RestoreJobParameters

Object

-

恢复优先级信息。

Tier

String

Standard

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

  • 归档存储对象的恢复优先级只能为 Standard,表示归档存储对象在 1 分钟内完成恢复。

    说明

    Standard 对于归档存储、冷归档和深度冷归档对象的恢复优先级的意义不同,说明如下:

    • 如果恢复归档存储对象,设置 TierStandard,则归档存储对象将在 1 分钟内完成恢复。
    • 如果恢复冷归档对象,设置 TierStandard,则冷归档对象将在2~5 小时内完成恢复。
    • 如果恢复深度冷归档对象,设置 TierStandard,则深度冷归档对象将在 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

{
    "RestoreRequest": {
        "Days": 10
    }
}

请求示例 2

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

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

{
    "RestoreRequest": {
        "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

{
    "RestoreRequest": {
        "Days": 20
    }
}

响应示例

响应示例 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": "5726ce090a2d002d-a444ed0"
    "HostId": "GFdpcBKxovJAtAdAQluzipAXqa****"
    "Message": "Object restore is already in progress",
}

响应示例 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