Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>

2023-03-14 12:40:31 +00:00

16 KiB

Raw Permalink Blame History

POST Object restore

If you want to obtain the content of a Cold object, restore the object first. Then, you can download the object.

Versioning

By default, the object of the latest version is restored. If the object has a delete marker, status code 404 is returned. To restore an object of a specified version, the versionId parameter can be used to specify the desired version.

Request Syntax

POST /ObjectName?restore&versionId=VersionID HTTP/1.1  
User-Agent: agent
Host: bucketname.obs.example.com   
Accept: */*
Date: date   
Authorization: authorization string   
Content-MD5: MD5 

<RestoreRequest>
   <Days>NumberOfDays</Days>
   <GlacierJobParameters>
       <Tier>RetrievalOption</Tier>
   </GlacierJobParameters>
</RestoreRequest>

Request Parameters

Parameter	Description	Remarks
versionId	Version ID of the Cold object to be restored. Type: String	Optional

Parameter

Description

Remarks

versionId

Version ID of the Cold object to be restored.

Type: String

Optional

Request Headers

This request uses common headers. For details, see section Common Request Headers.

Request Elements

**Table 1** Request elements
Element	Description	Remarks
RestoreRequest	Container for restore information. Type: Container	Mandatory
Days	Indicates the retention period of the restored object. The value is an integer ranging from 1 to 30. Type: Positive integer	Mandatory
GlacierJobParameters	Container for Glacier job parameters. Type: Container	Optional
Tier	Indicates the retrieval option used when restoring a Cold object. Valid Values: Expedited, Standard, and Bulk Expedited: indicates that data can be restored within 1 to 5 minutes. Standard: indicates that data can be restored within 3 to 5 hours. Bulk: indicates that data can be restored within 5 to 12 hours. The default value is Standard. Type: String	Optional

Response Syntax

HTTP/1.1 status_code 
Server: server
x-amz-request-id: request id   
x-amz-id-2: id   
x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc   
Date: date

Response Headers

This response uses common headers. For details, see section Common Response Headers.

Response Elements

This response involves no elements.

Error Responses

**Table 2** List of OBS error codes
Error Code	Description	HTTP Status Code
RestoreAlreadyInProgress	The object is being restored. The request conflicts with another. ErrorMessage: Object restore is already in progress	409 Conflict
ObjectHasAlreadyRestored	The object has been restored and the retention period of the restored object is not allowed to be shortened. ErrorMessage: After restoring a Cold object, you cannot shorten the restoration period of the Cold object	409 Conflict
MalformedXML	Invalid value for the Days field (not an integer) ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema	400 Bad Request
InvalidArgument	The value of the Days field is not within the range of 1to 30. ErrorMessage: restoration days should be at least 1 and at most 30	400 Bad Request
MalformedXML	Invalid value for the Tier field. ErrorMessage: The XML you provided was not well-formed or did not validate against our published schema	400 Bad Request
InvalidObjectState	The restored object is not a Cold object. ErrorMessage: Restore is not allowed, as object's storage class is not GLACIER	403 Forbidden

Sample Request

POST /object?restore HTTP/1.1   
User-Agent: curl/7.19.7 (x86_64-suse-linux-gnu) libcurl/7.19.7 OpenSSL/0.9.8j zlib/1.2.7 libidn/1.10   
Host: bucketname.obs.example.com   
Accept: */*   
Date: Tue, 07 Mar 2017 08:54:09 +0000   
Authorization: AWS UDSIAMSTUBTEST000002:kaEwOixnSVuS6If3Q0Lnd6kxm5A=   
Content-Length: 183   
Expect: 100-continue 
    
<RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-3-01">      
   <Days>3</Days>      
   <GlacierJobParameters>         
       <Tier>Expedited</Tier>     
   </GlacierJobParameters>   
</RestoreRequest>

Sample Response

HTTP/1.1 100 Continue   
HTTP/1.1 202 Accepted  
Server: OBS 
x-amz-request-id: 00013235600000015AA7FE74DCAE68RC   
x-amz-id-2: W5NZYb1KhRt+updrvY4OCgmESg7R1lsdR3CMA450Gq2jtrc07YAThUJmV8mPg9D4   x-reserved: amazon, aws and amazon web services are trademarks or registered trademarks of Amazon Technologies, Inc   
Content-Length: 0   
Date: Tue, 07 Mar 2017 08:59:15 GMT

Parent topic: Operations on Objects

16 KiB Raw Permalink Blame History