Todos os produtos
Search
Central de documentação

Object Storage Service:CleanRestoredObject

Última atualização: Jul 03, 2026

Restaurar um objeto Cold Archive ou Deep Cold Archive no Object Storage Service (OSS) gera uma réplica temporária sujeita a cobranças de armazenamento até que o objeto retorne ao estado congelado. Use a operação CleanRestoredObject para encerrar antecipadamente o estado restaurado, interromper imediatamente as cobranças de armazenamento da réplica e reverter o objeto para o estado congelado. Após essa reversão, o objeto deixa de ser acessível diretamente.

Sintaxe

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

Cabeçalhos da requisição

Uma requisição CleanRestoredObject utiliza apenas cabeçalhos comuns de requisição. Para mais informações, consulte Cabeçalhos comuns de requisição.

Cabeçalhos da resposta

A resposta a uma requisição CleanRestoredObject contém apenas cabeçalhos comuns de resposta. Para mais informações, consulte Cabeçalhos comuns de resposta.

Exemplos

  • Exemplo de requisição

    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
  • Exemplo de resposta

    • Nenhuma requisição RestoreObject foi iniciada para o objeto ou a requisição CleanRestoredObject já foi processada.

      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>
    • Uma requisição RestoreObject foi iniciada para o objeto e a restauração está em andamento.

      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>
    • Uma requisição RestoreObject foi iniciada para o objeto e a restauração foi concluída.

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