Restore Object

描述

此接口用于对归档Object进行解冻。

此接口只针对归档类型的Object的解冻操作。如果一个Object是标准或者低频访问类型，不要调用该接口。

归档类型Object状态说明

1. 将文件上传到归档存储Bucket，文件自动存储为归档object,处于冷冻状态。
2. 提交一次Restore操作后，Object将处于解冻中的状态，服务端执行解冻。解冻任务完成需要1到10分钟。
3. 待服务端执行完成解冻任务后，Object进入解冻状态，此时用户可以读取Object。
4. 解冻状态默认持续24小时，24小时内再次调用Restore Object接口则解冻状态会自动延长24小时，最多可延长7天，之后，Object又回到初始时的冷冻状态。

解冻操作所产生的费用说明：

• 对一个处于冷冻状态的Object执行Restore操作，会产生数据取回费用。
• 解冻状态最多延长7天。在此期间内不再重复收取数据取回费用。
• 解冻状态结束后，Object又回到冷冻状态，再次解冻的首次读取数据会收取数据取回费用。
• 每调用Restore Object接口，都会产生请求数费用

请求

语法

下面展示的是对某一个归档文件进行解冻请求

POST /{ObjectKey}?restore HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

注意：

• endpoint与Region对应关系
• SignatureValue签名算法

语法

该接口不使用请求参数。

请求头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

说明

响应

响应头部

该接口可以使用所有常用响应头部。获取更多信息，请点击常用响应头部。

示例

说明

• 如果是对归档Object第一次调用RestoreObject接口，则返回202。
• 如果已经成功调用过RestoreObject接口，且Object仍处于解冻中，再次调用时返回409, 错误码为：RestoreAlreadyInProgress，表示服务端正在执行解冻操作，用户只需要等待解冻完成，最长等待时间10分钟。
• 如果已经成功调用过RestoreObject接口，且服务端解冻已经完成，再次调用时返回200，且会将归档文件的可下载时间延长一天，最多延长7天。
• 如果文件不存在，则返回404。
• 如果针对非归档类型的文件提交解冻操作，则返回400，错误码为：OperationNotSupported。

首次提交请求示例

POST /restore_test.txt?restore HTTP/1.1
Host: test-arc-12/ks3-cn-shanghai-internal.ksyuncs.com
Date: Fri, 26 Dec 2018 06:34:32 GMT
Authorization:KSS authorization string

响应示例

HTTP/1.1 202 Accepted
Server: Tengine
Date: Fri, 26 Dec 2018 06:34:32 GMT
Content-Length: 0
Connection: keep-alive
X-Application-Context: application
x-kss-request-id: cb2a95d037794c0293be0a094375c047
x-kss-storage-class: ARCHIVE

再解冻操作未完成的情况下，再次提交请求示例

POST /restore_test.txt?restore HTTP/1.1
Host: test-arc-12/ks3-cn-shanghai-internal.ksyuncs.com
Date: Fri, 26 Dec 2018 06:35:02 GMT
Authorization:KSS authorization string

响应示例

HTTP/1.1 409 Conflict
Server: Tengine
Date: Fri, 26 Dec 2018 06:35:02 GMT
Content-Type: application/xml
Transfer-Encoding: chunked
Connection: keep-alive
X-Application-Context: application
x-kss-request-id: 79516a04224b423181f20f3dcbf2f416
x-kss-StorageClass: -
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Error>
	<Code>RestoreAlreadyInProgress</Code>
	<Message>Object restore is already in progress.</Message>
	<Resource>/test-arc-12/restore_test1.txt?restore</Resource>
	<RequestId>79516a04224b423181f20f3dcbf2f416</RequestId>
</Error>

解冻后，第三次提交请求示例

POST /restore_test.txt?restore HTTP/1.1
Host: test-arc-12/ks3-cn-shanghai-internal.ksyuncs.com
Date: Fri, 26 Dec 2018 06:40:02 GMT
Authorization:KSS authorization string

响应示例

HTTP/1.1 200 OK
Server: Tengine
Date: Fri, 26 Dec 2018 06:40:02 GMT
Content-Length: 0
Connection: keep-alive
X-Application-Context: application
x-kss-request-id: 1d147c34a9d542aa8dc7f0f70d3db893
x-kss-storage-class: ARCHIVE