Object Storage Service:restore-object

Observações de uso

• Por padrão, uma conta Alibaba Cloud tem permissão para restaurar objetos. Usuários RAM ou o Security Token Service (STS) exigem a permissão oss:RestoreObject para realizar essa ação. Para mais informações, consulte Grant a custom policy.

• O comando restore-object aplica-se apenas a objetos Archive ou Cold Archive, não sendo válido para objetos Standard ou Infrequent Access (IA).

• Para ler um objeto Archive ou Cold Archive, restaure-o antecipadamente. A restauração de um objeto Archive leva alguns minutos, enquanto a de um objeto Cold Archive pode levar várias horas.

• O estado restaurado de um objeto Archive dura no máximo 7 dias (o valor do parâmetro Days varia de 1 a 7). Após esse período, o objeto retorna automaticamente ao estado congelado. Se você planeja migrar dados (entre contas ou em grande escala) após a restauração e o processo puder exceder 7 dias, use CopyObject para converter o objeto Archive para a classe de armazenamento Standard dentro da validade da restauração antes de iniciar a migração. Essa medida evita falhas causadas pelo retorno do objeto ao estado congelado após o término do período de restauração.

Faturamento

A restauração de objetos gera taxas de armazenamento, recuperação de dados e chamadas de API. Além disso, a restauração de objetos Cold Archive e Deep Cold Archive incorre em taxas de armazenamento temporário.

• Taxas de armazenamento: a cobrança segue as regras de faturamento para objetos Archive, Cold Archive e Deep Cold Archive durante e após a restauração. Para mais informações, consulte Storage fees.

• Taxas de recuperação de dados: calculadas com base no tamanho dos objetos Archive, Cold Archive ou Deep Cold Archive restaurados. Para mais informações, consulte Data processing fees.

• Taxas de chamada de API:

  • Cobrança baseada no número de requisições PUT ao restaurar objetos Archive. Para mais informações, consulte Request fees.

  • Cobrança de requisições de recuperação de dados ao restaurar objetos Cold Archive ou Deep Cold Archive. Para mais informações, consulte Request fees.

• Taxas de armazenamento temporário: ao restaurar um objeto Cold Archive ou Deep Cold Archive, o sistema gera uma réplica para acesso temporário. O armazenamento temporário dessa réplica é cobrado com base na classe de armazenamento Standard até que o objeto Cold Archive ou Deep Cold Archive retorne ao estado congelado. Para mais informações, consulte Temporary storage fees.

Processo de restauração

O processo de restauração é idêntico para todas as classes de armazenamento e segue o fluxo abaixo:

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

2. Após o envio da solicitação de restauração, o objeto entra no estado de restauração.

3. Quando a tarefa no servidor é concluída, o objeto passa para o estado restaurado e torna-se disponível para leitura.

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

5. Ao final do período restaurado, o objeto retorna ao estado congelado e sua classe de armazenamento original permanece inalterada.

Tempo de restauração

A tabela a seguir lista o tempo necessário para restaurar objetos de diferentes classes de armazenamento. Os tempos reais podem variar.

Cota de restauração

• Para uma única conta Alibaba Cloud em uma única região, a cota de referência para restauração de objetos Cold Archive é de 500 objetos por segundo em média, e a cota total nas três prioridades de restauração é de 100 TB a 120 TB por dia. Se o seu negócio exigir uma cota de restauração maior, entre em contato com o Suporte Técnico.

• Para uma única conta Alibaba Cloud em uma única região, a cota de referência para restauração de objetos Deep Cold Archive é de 100 objetos por segundo em média, e a cota total nas duas prioridades de restauração é de 10 TB a 15 TB por dia. Se o seu negócio exigir uma cota de restauração maior, entre em contato com o Suporte Técnico.

Mesmo após exceder a cota de referência para objetos Cold Archive ou Deep Cold Archive, você ainda pode enviar solicitações de restauração. Essas solicitações entrarão em fila e a restauração poderá levar mais tempo do que o estimado para a prioridade especificada.

Duração do estado restaurado

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

Sintaxe do comando

ossutil api restore-object --bucket value --key value [flags]

--restore-request

A opção de configuração --restore-request suporta os formatos XML e JSON. Se o valor da opção contiver o prefixo 'file://', os parâmetros de configuração serão lidos do arquivo especificado.

• Formato XML:

  <RestoreRequest>
    <Days>integer</Days>
    <JobParameters>
      <Tier>string</Tier>
    </JobParameters>
  </RestoreRequest>

• Formato JSON:

  {
    "Days": integer,
    "JobParameters": {
      "Tier": "string"
    }
  }

Exemplos

Operação de API relacionada

O comando restore-object corresponde à operação RestoreObject. Para mais informações, consulte RestoreObject.