• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Objects
  5. POST Object restore
  6. Requests

Requests

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

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: ExpeditedStandard, 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