Restore Archived Files
Updated at：2025-11-03
API description
RestoreObject is used to retrieve archive storage files. The requester must have read permissions for the archive storage files, which must be in a frozen state.
Note:
- If this API is accessed via a symlink, it will handle the request based on the storage class and status of the symlink's target file.
- If accessed via a symlink and the target file has been deleted, an HTTP 404 error with the code SymlinkTargetNotExist will be returned.
Request URI
POST /v1/{bucketName}/{objectKey}?restore
| Parameter name | Parameter type | Required or not | Description | Example value | Parameter location |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
| objectKey | String | Yes | Object name | "objectKey_example" | Path |
Request header parameters
| Parameter name | Parameter type | Required or not | Description | Example value |
|---|---|---|---|---|
| xBceRestoreDays | int | No | Specify the duration for which the file remains in a restored state, a numeric value in days, greater than 0 but less than 30. The default restoration period is 7 days, with a maximum of 30 days. | 7 |
| x-bce-restore-tier | string | No | Restore priority. The available value range is as follows: Expedited: expedited restoration, indicating completion within 30 min; Standard: standard restoration, indicating completion within 2 - 5 h; LowCost: deferred restoration, indicating completion within 12 h |
Expedited |
Parameters of request body
Description of the data structure of request body fields
Response body parameters
Description of the data structure of response body fields
Request example
JSON
1POST /v1/bucketName_example/objectKey_example?restore
2 <Common request headers>
3x-bce-restore-days: 7
4{ }Response example
JSON
1HTTP/1.1 200 OK
2 <Common response headers>
3{ }Error code
Please refer to the general error codes