This operation can restore a temporary replica of an object of GLACIER storage type Support the life cycle of a specified temporary replica when restoring, that is, after a specified period of time, OSS will delete the temporary replica. This operation does not affect the restored source object.
When restoring archived objects, you can specify the following restore options:
POST /ObjectName?restore HTTP/1.1 Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com Date: date Authorization: authorization string request body
No Request Parameter
No Special Header
XML Example of Request Body:
<RestoreRequest>
<Days>2</Days>
<GlacierJobParameters>
<Tier>Bulk</Tier>
</GlacierJobParameters>
</RestoreRequest>
| Name | Description | Must |
|---|---|---|
| RestoreRequest | Collection of Retrieval Information. Type: Container |
Yes |
| Days | Retrieved Life Cycle of Temporary Replica. The minimum number of days to restore objects from Glacier is 1. When a replica of an object reaches the specified life cycle, OSS deletes it from the bucket. Type: Positive Integer Parent Tag: RestoreRequest |
Yes |
| GlacierJobParameters | Collection of Glacier Retrieval Task Parameter. Type: Container Parent Tag: RestoreRequest |
No |
| Tier | Restore option, Standard by default. Type: Enum Valid Value: Expedited, Standard, Bulk Parent Tag: GlacierJobParameters |
No |
No Special Header
No Response Element
| Error Code | Description | HTTP Status Code |
|---|---|---|
| RestoreAlreadyInProgress | Object restoration is already in process. | 409 Conflict |
This request restores the replica of photo1.jpg from the archival storage with the restore option as Expedited and the life cycle of the copy is 2 days.
POST /photo1.jpg?restore HTTP/1.1
Host: <BUCKET_NAME>.s3.<REGION>.jdcloud-oss.com
Date: Mon, 22 Oct 2012 01:49:52 GMT
Authorization: authorization string
Content-Length: content length
<RestoreRequest>
<Days>2</Days>
<GlacierJobParameters>
<Tier>Expedited</Tier>
</GlacierJobParameters>
</RestoreRequest>
HTTP/1.1 202 Accepted x-amz-request-id: 9F341CD3C4BA79E0 Date: Sat, 20 Oct 2012 23:54:05 GMT Content-Length: 0 Server: JDCloudOSS