最近更新时间:2023-05-24 17:38:58
此接口只用于对归档Object
进行解冻操作,如果一个Object
是标准或者低频访问类型,不要调用该接口。
Bucket
,文件自动存储为归档Object,处于冷冻状态。Restore
操作后,Object
将处于解冻中的状态。服务端执行解冻,解冻任务完成需要1到10分钟。Object
进入解冻状态,此时用户可以读取Object
。Restore Object
接口则解冻状态会自动延长24小时,一次解冻流程内可有效调用7次Restore Object
接口达到最长7天的解冻持续时间。Object
又回到初始时的冷冻状态。Object
执行Restore
操作,会产生数据取回费用。Object
保持解冻状态持续时间最长为7天,在此期间内不再重复收取数据取回费用。Object
又回到冷冻状态,再次解冻的首次读取数据会收取数据取回费用。Restore Object
接口,都会产生请求数费用。Restore Object
接口,则返回202。Restore Object
接口,且服务端解冻已经完成,再次调用时返回200,且会将归档文件的可下载时间延长一天,持续时间最长为7天。下面展示的是对某一个归档文件进行解冻请求
POST /{ObjectKey}?restore HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}
注意:
该接口不使用请求参数。
该接口可以使用所有常用请求头部。获取更多信息,请点击常用请求头部。
该接口可以使用所有常用响应头部。获取更多信息,请点击常用响应头部。
首次提交请求示例
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: KS3
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: KS3
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
<?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: KS3
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
错误码 | HTTP状态码 | 描述 |
---|---|---|
OperationNotSupported | 400 | 目标Object不是归档类型,不支持解冻。 |
NoSuchKey | 404 | 目标Object不存在。 |
RestoreAlreadyInProgress | 409 | 您已经成功调用过RestoreObject接口,且Object仍处于解冻中,请等待解冻完成。 |
文档内容是否对您有帮助?
评价建议不能为空
非常感谢您的反馈,我们会继续努力做到更好!