Object Storage Service:RestoreObject

Pré-requisitos

• O objeto utiliza a classe de armazenamento Archive, Cold Archive ou Deep Cold Archive. Para mais informações, consulte Classes de armazenamento.

• Você tem a permissão oss:RestoreObject. Consulte Anexar uma política personalizada a um usuário RAM.

Observações

• A operação RestoreObject aplica-se exclusivamente a objetos Archive, Cold Archive e Deep Cold Archive. Ela não é válida para objetos Standard ou Infrequent Access (IA).

• Na primeira chamada à operação RestoreObject para um objeto, o sistema retorna uma resposta 202 Accepted. Se o objeto já estiver no estado restaurado, as chamadas subsequentes retornarão uma resposta 200 OK.

• Não invoque a operação RestoreObject em um objeto em processo de restauração. Essa tentativa resulta no erro 409 Conflict. Aguarde a conclusão da restauração atual antes de chamar a operação novamente.

• Em buckets com versionamento ativado, diferentes versões de um mesmo objeto podem ter classes de armazenamento distintas. Por padrão, a operação RestoreObject restaura a versão atual do objeto. Para restaurar uma versão específica, especifique o respectivo versionId.

Processo de restauração

O fluxo de restauração é idêntico para objetos de diferentes classes de armazenamento, conforme descrito abaixo.

1. Inicialmente, o objeto está no estado congelado.

2. Após o envio de uma solicitação de restauração, o objeto passa para o estado de restauração em andamento.

3. Quando a tarefa no servidor é concluída, o objeto entra no estado restaurado e permite leitura.

4. Se você enviar outra solicitação de restauração enquanto o objeto ainda estiver no estado restaurado, a duração desse estado será estendida. O tempo total estendido não pode exceder o limite máximo permitido para aquela classe de armazenamento.

5. Ao final do período de restauração, o objeto retorna ao estado congelado.

Tempo de restauração

A tabela a seguir lista os prazos estimados para restauração de objetos em cada classe de armazenamento. Os tempos reais podem variar.

^①Para uma única conta Alibaba Cloud em uma única região, a taxa estimada de recuperação de dados para objetos Cold Archive é de 500 objetos por segundo, em média. O volume total de recuperação somando as três prioridades de restauração varia de 100 TB a 120 TB por dia. Se o seu negócio exigir uma taxa de recuperação maior, entre em contato com o Suporte Técnico.

^②Para uma única conta Alibaba Cloud em uma única região, a taxa estimada de recuperação de dados para objetos Deep Cold Archive é de 100 objetos por segundo, em média. O volume total de recuperação considerando ambas as prioridades de restauração varia de 10 TB a 15 TB por dia. Caso sua operação necessite de uma taxa de recuperação superior, contate o Suporte Técnico.

Duração do estado restaurado

O período em que os objetos permanecem no estado restaurado varia conforme a classe de armazenamento.

Faturamento

• Taxas de recuperação de dados são geradas ao restaurar objetos Archive, Cold Archive e Deep Cold Archive. Para mais detalhes, consulte Taxas de processamento de dados.

• Objetos Archive podem permanecer no estado restaurado por até 7 dias. Já os objetos Cold Archive e Deep Cold Archive mantêm esse estado por até 365 dias. Nenhuma taxa adicional de recuperação de dados é cobrada durante esse período.

• Quando o estado restaurado expira, o objeto volta ao estado congelado. Uma nova restauração implicará novas taxas de recuperação de dados.

• Ao restaurar um objeto Cold Archive ou Deep Cold Archive, o sistema cria uma réplica dele na classe de armazenamento Standard para permitir o acesso. Enquanto o objeto estiver no estado restaurado, você será cobrado pelo armazenamento temporário dessa réplica, conforme as tarifas da classe Standard. Para mais informações, veja Taxas de armazenamento temporário.

Sintaxe da solicitação

POST /ObjectName?restore HTTP/1.1
Host: archive-bucket.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

A operação RestoreObject utiliza apenas cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Parâmetros da solicitação

Cabeçalhos da resposta

As respostas da operação RestoreObject incluem cabeçalhos de resposta comuns. Para mais detalhes, consulte Cabeçalhos de resposta comuns.

Exemplos

• Restaurar um objeto Archive congelado (primeira solicitação)

  Exemplo de solicitação

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemplo de resposta de sucesso

  HTTP/1.1 202 Accepted
  Date: Sat, 15 Apr 2017 07:45:28 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Restaurar um objeto Archive em processo de restauração

  Exemplo de solicitação

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemplo de resposta de sucesso

  HTTP/1.1 409 Conflict
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Content-Length: 556
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74
  <?xml version="1.0" encoding="UTF-8"?>
  <Error>
    <Code>RestoreAlreadyInProgress</Code>
    <Message>The restore operation is in progress.</Message>
    <RequestId>58EAF141461FB42C2B000008</RequestId>
    <HostId>10.101.XX.XX</HostId>
  </Error>

• Restaurar um objeto Archive já no estado restaurado

  Exemplo de solicitação

  POST /oss.jpg?restore HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Sat, 15 Apr 2017 07:45:29 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  <RestoreRequest>
    <Days>2</Days>
  </RestoreRequest>

  Exemplo de resposta de sucesso

  HTTP/1.1 200 Ok
  Date: Sat, 15 Apr 2017 07:45:30 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-request-id: 5374A2880232A65C23002D74

• Restaurar um objeto Cold Archive ou Deep Cold Archive já no estado restaurado

  Exemplo de solicitação

  POST /coldarchiveobject?restore HTTP/1.1
  Host: cold-archive-bucket.oss-cn-hangzhou.aliyuncs.com
  User-Agent: aliyun-sdk-go/v2.1.0 (Darwin/17.5.0/x86_64;go1.11.8)/ossutil-v1.6.12
  Content-Length: 99
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  Content-Type: text/plain; charset=utf-8
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Accept-Encoding: gzip
  <RestoreRequest>
    <Days>2</Days>
    <JobParameters>
      <Tier>Standard</Tier>
    </JobParameters>
  </RestoreRequest>

  Exemplo de resposta de sucesso

  HTTP/1.1 200 OK
  Server: AliyunOSS
  Date: Tue, 21 Apr 2020 11:09:19 GMT
  Content-Length: 0
  Connection: keep-alive
  x-oss-request-id: 5E9ED45F093E2F3930318EA0
  x-oss-object-restore-priority: Standard
  x-oss-server-time: 10

• Restaurar uma versão específica do objeto

  Exemplo de solicitação

  POST /oss.jpg?restore&versionId=CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh**** HTTP/1.1
  Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

  Exemplo de resposta de sucesso

  HTTP/1.1 202 Accepted
  Date: Tue, 09 Apr 2019 06:50:48 GMT
  Content-Length: 0
  Connection: keep-alive
  Server: AliyunOSS
  x-oss-version-id: CAEQNRiBgMClj7qD0BYiIDQ5Y2QyMjc3NGZkODRlMTU5M2VkY2U3MWRiNGRh****
  x-oss-request-id: 5CAC40C8B7AEADE017000653

SDKs do OSS

Use a operação RestoreObject com os SDKs do OSS nas seguintes linguagens:

• Java

• Python V2

• PHP V2

• Go V2

• C

• C++

• .NET

• Android

• iOS

• Node.js

• Harmony

• Browser.js

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação RestoreObject, consulte restore-object.

Códigos de erro

Referências

• Para saber mais sobre o tempo necessário para restauração e a quantidade de dias em que um objeto permanece no estado restaurado, consulte Restaurar objetos.

• Para instruções sobre como usar o ossutil para restaurar um objeto, veja Restaurar arquivos.

• Caso precise manter um objeto permanentemente no estado restaurado, consulte Como manter um objeto do OSS permanentemente restaurado?