All Products
Search

This Product

    Object Storage Service:CleanRestoredObject

    Document Center

    Object Storage Service:CleanRestoredObject

    Last Updated:Jun 02, 2026

    Restoring a Cold Archive or Deep Cold Archive object in Object Storage Service (OSS) generates a temporary replica that incurs storage charges until the object returns to the frozen state. Use CleanRestoredObject to terminate the restored state early, stop replica storage charges immediately, and revert the object to the frozen state, after which the object is no longer directly accessible.

    Syntax

    POST /ObjectName?cleanRestoredObject HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Request headers

    All headers in a CleanRestoredObject request are common request headers. For more information, see Common Request Headers.

    Response headers

    All headers in the response to a CleanRestoredObject request are common response headers. For more information, see Common Response Headers.

    Examples

    • Sample request

      POST /ObjectName?cleanRestoredObject HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 20 Sep 2024 08:32:21 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Sample response

      • The RestoreObject request has not been initiated for the object, or the CleanRestoredObject request has already been processed.

        HTTP/1.1 409 Conflict
Date: Fri, 20 Sep 2024 08:32:21 GMT
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>ArchiveRestoreFileStale</Code>
  <Message>The archive file or restore info stale</Message>
  <RequestId>5374A2880232A65C2300****</RequestId>
  <HostId>10.101.XX.XX</HostId>
</Error>

      • The RestoreObject request has been initiated for the object, and restoration is in progress.

        HTTP/1.1 409 Conflict
Date: Fri, 20 Sep 2024 08:32:21 GMT
Content-Length: 556
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>ArchiveRestoreNotFinished</Code>
  <Message>The archive file's restore is not finished.</Message>
  <RequestId>5374A2880232A65C2300****</RequestId>
  <HostId>10.101.XX.XX</HostId>
</Error>

      • The RestoreObject request has been initiated for the object, and restoration is complete.

        HTTP/1.1 200 Ok
Date: Fri, 20 Sep 2024 08:32:21 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****