RestoreObject
更新时间：2026-09-18
接口描述
RestoreObject 用于取回归档存储文件，请求者必须有归档存储文件的读权限，并且归档存储文件处于冰冻状态。
注意：
- 如果使用软链接访问该接口，会根据软链接的目标文件的存储类型和状态进行处理。
- 如果使用软链接访问该接口且目标文件删除了，会返回 HTTP 404，
SymlinkTargetNotExist。 - 多版本环境下，RestoreObject 后的文件为空版本。
请求
请求结构
Http
1POST /{ObjectName}?restore= HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Content-Length: 0
5Authorization: <Authorization_String>
6x-bce-restore-tier: <RestoreTier>
7x-bce-restore-days: <RestoreDays>请求头域
| 名称 | 类型 | 描述 | 是否必需 |
|---|---|---|---|
x-bce-restore-days |
int | 表示解冻后状态的持续时间，单位为天。取值范围为 1~30，默认解冻持续天数为 7 天。 |
否 |
x-bce-restore-tier |
string | 解冻优先级。可取值：Expedited，加急取回，表示 30 分钟内完成取回；Standard，标准取回，表示 2~5 小时内完成取回；LowCost，延缓取回，表示 12 小时内完成取回。 |
否，默认值为 Standard |
请求参数
| 参数名 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
ObjectName |
string | Path | 是 | 需要取回的归档存储文件名称。 |
restore |
string | Query | 是 | 固定 Query 参数，值为空。请求 URL 中可写为 ?restore=，签名时按空值 Query 参数参与签名。 |
无请求 Body 参数。
响应
响应头域
除 BOS 通用响应头外，无特殊响应头域。
| 名称 | 类型 | 描述 |
|---|---|---|
x-bce-request-id |
string | 请求 ID，用于定位请求。 |
响应参数
无响应 Body 参数。
注意事项
无
示例
请求示例
Http
1POST /archive-object.txt?restore= HTTP/1.1
2Host: <BucketName>.bj.bcebos.com
3Date: <Date>
4Content-Length: 0
5Authorization: <Authorization_String>
6x-bce-restore-days: 3
7x-bce-restore-tier: Expedited响应示例
Http
1HTTP/1.1 200 OK
2x-bce-request-id: 4db4b34d-653d-4d9a-b49b-3049ca786409
3Date: Wed, 31 May 2018 08:34:40 GMT
4Server: BceBos评价此篇文章