0016-00000715-Object Storage Service(OSS)-阿里云帮助中心

Problem description

A RestoreObject request fails when the specified Tier value represents a lower restoration priority than the one currently in progress for a Cold Archive object.

Causes

OSS only allows upgrading the restoration priority of an in-progress restore job — downgrading is not permitted. If the Tier value in a new RestoreObject request represents a slower restore speed than the current priority, OSS rejects the request with an error.

The Tier parameter controls restoration priority and determines how quickly a Cold Archive object becomes readable:

Priority	Restoration time
Expedited	Within 1 hour
Standard	Within 2 to 5 hours (default when `JobParameters` is omitted)
Bulk	Within 5 to 12 hours

Priority order from highest to lowest: Expedited > Standard > Bulk. To change the priority of an in-progress restore, the new Tier value must be higher than the current one. For example, if the current priority is Standard, only Expedited is a valid upgrade.

Examples

The following example shows a RestoreObject request that starts a restore at Standard priority:

POST /coldarchiveobject?restore HTTP/1.1
Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
Date: Tue, 21 Apr 2020 11:09:19 GMT
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Standard</Tier>
  </JobParameters>
</RestoreRequest>

The following request is sent while the restore is still in progress, attempting to change the priority to Bulk:

POST /coldarchiveobject?restore HTTP/1.1
Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
Date: Tue, 21 Apr 2020 11:09:19 GMT
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Bulk</Tier>
  </JobParameters>
</RestoreRequest>

Because Bulk is lower than Standard, OSS rejects this request and returns an error.

Solutions

Set Tier to a value that represents a higher priority than the current in-progress restore. The following request upgrades the priority from Standard to Expedited:

POST /coldarchiveobject?restore HTTP/1.1
Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
Date: Tue, 21 Apr 2020 11:09:19 GMT
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Expedited</Tier>
  </JobParameters>
</RestoreRequest>

References

RestoreObject