CleanRestoredObject - Object Storage Service

冷歸檔或者深度冷Archive Storage類型檔案（Object）在資料解凍時會產生一份檔案副本用於訪問，檔案副本在解凍時間結束前會收取臨時儲存費用。如果您希望提前結束解凍狀態，且檔案副本不再產生臨時儲存費用，您可以發起CleanRestoredObject請求。請求完成後，Object將恢複為冷凍狀態，不能直接讀取。

請求文法

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

要求標頭

此介面僅涉及公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅涉及公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

樣本

請求樣本

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

返回樣本

未對Object發起RestoreObject請求、或者CleanRestoredObject請求已完成

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>

已對Object發起RestoreObject請求，但RestoreObject請求未完成

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>

已對Object發起RestoreObject請求，且RestoreObject請求已完成

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****