RestoreObject
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:
- When accessing this API via a symlink, it will be processed based on the storage class and status of the symlink 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.
- The files following RestoreObject are null in a multi-version environment
Request
-
Request syntax
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 -
Request headers
| Name | Types | Description | Whether required |
|---|---|---|---|
| x-bce-restore-days | int | Defines the duration of the restored state in days, with a numeric value greater than 0 and less than 30. By default, the restoration duration is 7 days, with a maximum duration of 30 days. | No |
| x-bce-restore-tier | string | Restore priority. The available values are as follows:
|
No, defaulting to standard restoration |
Response
Note
None
Example
-
Request example
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 -
Response example
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
