Restoring Archive Objects

Functions

To obtain the content of an object in the Archive storage class, you need to restore the object first and then you can download it. After an object is restored, a copy of the object is saved in the Standard storage class. By doing so, the object in the Archive storage class and its copy in the Standard storage class co-exist in the bucket. The copy will be automatically deleted once its retention period ends.

Versioning

By default, this operation returns the latest version of an object. 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 
Host: bucketname.obs.region.myhuaweicloud.eu
Date: date
Authorization: authorization string
Content-MD5: MD5

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

Request Parameters

Parameter	Type	Mandatory (Yes/No)	Description
versionId	String	No	Definition: Version ID of the Archive object to be restored Constraints: None Range: None Default value: None. If this parameter is not configured, the latest version of the object is specified.

Parameter

Type

Mandatory (Yes/No)

Description

versionId

String

Definition:

Version ID of the Archive object to be restored

Constraints:

None

Range:

None

Default value:

None. If this parameter is not configured, the latest version of the object is specified.

Request Headers

This request uses common headers. For details, see Table 3.

Request Elements

**Table 1** Request elements
Element	Type	Mandatory (Yes/No)	Description
RestoreRequest	Container	Yes	Definition: Container for the restore information Constraints: None Range: None Default value: None
Days	Integer	Yes	Definition: After an object is restored, a Standard copy of it is generated. This parameter specifies how long the Standard copy can be retained, that is, the validity period of the restored object. Constraints: The retention period starts from the first 08:00 (Beijing time) after the object retrieval is initiated. For example, if the retention period is one day and the retrieval is initiated any time between 08:00 on the 27th day and 08:00 on the 28th day, the expiration is always at 08:00 on the 29th day. Range: The value ranges from 1 to 30, in days. Default value: None
RestoreJob	Container	No	Definition: Container for the restore options Constraints: None Range: None Default value: None
Tier	String	No	Definition: Retrieval speed tier. You can select a tier that suits your retrieval needs. Range: Expedited indicates that objects can be quickly restored from Archive storage within 1 to 5 minutes. Standard indicates that objects can be restored from Archive storage within 3 to 5 hours. Default value: Standard

Response Syntax

    
         HTTP/1.1 status_code
Date: date

Response Headers

The response to the request uses common headers. For details, see Table 1.

Response Elements

This response contains no elements.

Error Responses

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

Sample Request

    
         POST /object?restore HTTP/1.1
Host: examplebucket.obs.region.myhuaweicloud.eu
Accept: */*
Date: WED, 01 Jul 2015 04:39:46 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:kaEwOixnSVuS6If3Q0Lnd6kxm5A=
Content-Length: 183

<RestoreRequest>
   <Days>2</Days> 
   <RestoreJob>
     <Tier>Expedited</Tier>
   </RestoreJob> 
</RestoreRequest>

Sample Response

    
         HTTP/1.1 202 Accepted
Server: OBS
x-obs-request-id: A2F500000163F374CCBB2063F834C6C4
x-obs-id-2: 32AAAUgAIAABAAAQAAEAABAAAQAAEAABCSLbWIs23RR95NVpkbWlJdlm8Dq+wQBw
Date: WED, 01 Jul 2015 04:39:46 GMT
Content-Length: 0