解冻归档存储类型的文件,可设置解冻有效期1~7天。
完成解冻任务通常需要1~5分钟。
请求报文
请求语法
POST /restoreAr/<EncodedEntry>/freezeAfterDays/<FreezeAfterDays> HTTP/1.1
Host: rs.qbox.me
Content-Type: application/json
Authorization: Qiniu <AccessToken>
<EncodedEntryURI>
:细节请参考 EncodedEntryURI。<FreezeAfterDays>
:解冻有效时长,取值范围 1~7 。
访问权限
管理凭证方式。
响应报文
头部信息
头部名称 | 必填 | 说明 |
---|---|---|
Content-Type | 是 | 正常情况下该值将被设为application/json ,表示返回JSON格式的文本信息 |
其它可能返回的头部信息,请参考HTTP扩展字段。
响应内容
如果请求成功,不返回任何内容。
如果请求失败,返回包含如下内容的JSON字符串(已格式化,便于阅读):
{
"error": "<errMsg string>"
}
字段名称 | 必填 | 说明 |
---|---|---|
error | 是 | 与HTTP状态码对应的消息文本 |
响应状态码
HTTP状态码 | 含义 |
---|---|
200 | 更改成功 |
400 | 请求报文格式错误 当 Bucket 为空时,返回400 Bad Request {"error":"invalid argument"} 当 Object 不符合UTF-8编码,返回400 Bad Request {"error":"key must be utf8 encoding"} 当 Object 已经处于解冻状态时,返回400 Bad Request {"error":"archive already restored"} 当 <FreezeAfterDays> 不符合要求时,返回400 Bad Request {"error":"invalid freeze after days"} |
401 | 管理凭证无效 |
403 | 禁止操作 当非归档存储类型 Object 调用此接口时,返回 403 Fobbiden {"error": "operation not allowed for archive"} |
612 | 目标资源不存在 |
599 | 服务端操作失败 |
示例
请求示例
POST /restoreAr/YnVja2V0LW1rdDNqbGNtemsyc2V2N3Rlb2ZjOktPRE8tS0VZLVRFU1QtYXJjaGl2ZS1UYmNZUEN0c3Ay/freezeAfterDays/1 HTTP/1.1
Host: rs.qbox.me
User-Agent: Go-http-client/1.1
Authorization: Qiniu HwFOxpYCQU6oXoZXFOTh1mq5ZZig6Yyocgk3BTZZ:dkV6wjnPOasNG-WPDvbttUlYWaw=
Content-Type: application/json
响应示例
HTTP/1.1 200 OK
Date: Mon, 23 Feb 2020 10:20:15 GMT
Content-Type: application/json
Connection: keep-alive
X-Reqid: ZhUAACe10_2tVfYV
文档反馈
(如有产品使用问题,请提交工单)