CleanRestoredObject

更新时间:2024-12-31 01:49:30

冷归档或者深度冷归档存储类型文件(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: OSS qn6q**************:77Dv****************
  • 返回示例

    • 未对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****

  • 本页导读 (1)
  • 请求语法
  • 请求头
  • 响应头
  • 示例