RestoreObject
更新时间:2025-04-21
接口描述
RestoreObject用于取回归档存储文件,请求者必须有归档存储文件的读权限,并且归档存储文件处于冰冻状态。
注意:
- 如果使用软链接访问该接口,会根据软链接的目标文件的存储类型和状态进行处理。
- 如果使用软链接访问该接口且目标文件删除了,会返回Http 404,SymlinkTargetNotExist。
- 多版本环境下,RestoreObject后的文件为空版本
请求(Request)
-
请求语法
Plain Text1POST /ObjectName?restore HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3Date: <Date> 4Content-Length: 0 5Authorization: <Authorization_String> 6x-bce-restore-tier:Expedited/Standard 7x-bce-restore-days:3
-
请求头域
名称 类型 描述 是否必需 x-bce-restore-days int 表示解冻后状态的持续时间,要求是数字,单位是天,取值大于0且不超过30即可。默认解冻持续天数是7天,最长30天。 否 x-bce-restore-tier string 解冻优先级。可取值范围如下: - Expedited:加急取回,表示30min内完成取回
- Standard:标准取回,表示2~5小时内完成取回
- LowCost:延缓取回,表示12小时内完成取回
否,默认是标准取回 -
请求参数
无特殊参数
响应(Response)
注意事项
无
示例
-
请求示例
Plain Text1POST /ObjectName?restore HTTP/1.1 2Host: <BucketName>.bj.bcebos.com 3x-bce-date: <Date> 4Content-Length: 0 5x-bce-restore-days: 3 6x-bce-restore-tier: Expedited
-
响应示例
Plain Text1HTTP/1.1 200 OK 2x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409 3Date: Wed, 31 May 2018 08:34:40 GMT 4Server: BceBos