Restore Archive Files
Last Updated：2021-09-13
Interface Description
RestoreObject is used to restore the archive storage file. The requester must have the read permission of the archive storage file, and the archive storage file is frozen.
Notes:
- If the soft link is used to access this interface, the system processes the data according to the storage type and state of the destination files for the soft link.
- If you use the soft link to access this interface and the destination file of the soft link is deleted, it returns “404，SymlinkTargetNotExist”.
Request URI
POST /v1/{bucketName}/{objectKey}?restore
| Parameter Name | Parameter Type | Required? | Description | Example Value | Parameter Position |
|---|---|---|---|---|---|
| bucketName | String | Yes | Bucket name | "bucketName_example" | Path |
| objectKey | String | Yes | Object name | "objectKey_example" | Path |
Request Header Parameters
| Parameter Name | Parameter Type | Required | Description | Example Value |
|---|---|---|---|---|
| xBceRestoreDays | Long | No | Indicate the duration of frozen state. The number is required (days). Its value is greater than 0 and not more than 30. The default duration of the frozen status is 7 days, or up to 30 days. | 789L |
Request Body Parameters
Description of Data Structure for Request Body Field
Response Body Parameters
Description of Data Structure for Response Body Field
Request Example
POST /v1/bucketName_example/objectKey_example?restore
Common Request Header
x-bce-restore-days: 789
{ }Response Example
HTTP/1.1 200 OK
<Common response header>
{ }Error Code
Refer to the universal error code.