restore-object - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações de uso

Por padrão, a 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 Conceder uma política personalizada.
Este comando aplica-se apenas a objetos Archive ou Cold Archive. Ele não é 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; já a de um objeto Cold Archive pode levar várias horas.

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: aplicadas conforme 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 Taxas de armazenamento.
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 Taxas de processamento de dados.
Taxas de chamada de API:
- Aplicadas com base no número de requisições PUT ao restaurar objetos Archive. Para mais informações, consulte Taxas de requisição.
- Cobradas como requisições de recuperação de dados ao restaurar objetos Cold Archive ou Deep Cold Archive. Para mais informações, consulte Taxas de requisição.
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. Essa réplica é cobrada como armazenamento da classe Standard até que o objeto original retorne ao estado congelado. Para mais informações, consulte Taxas de armazenamento temporário.

Processo de restauração

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

Inicialmente, o objeto está no estado congelado.
Após o envio da solicitação de restauração, o objeto entra no estado de restauração.
Quando a tarefa no servidor é concluída, o objeto passa para o estado restaurado e fica disponível para leitura.
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.
Ao término do período restaurado, o objeto retorna ao estado congelado.

Tempo de restauração

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

Classe de armazenamento do objeto	Descrição
Archive	1 minuto.
Cold Archive^①	Expedited: restauração concluída em até 1 hora. Standard: restauração concluída entre 2 e 5 horas. Bulk: restauração concluída entre 5 e 12 horas.
Deep Cold Archive^②	Expedited: restauração concluída em até 12 horas. Standard: restauração concluída em até 48 horas.

^①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 nas 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 nas duas prioridades de restauração varia de 10 TB a 15 TB por dia. Se o seu negócio exigir uma taxa de recuperação maior, entre em contato com o Suporte Técnico.

Duração do estado restaurado

O tempo que os objetos podem permanecer no estado restaurado varia conforme a classe de armazenamento.

Classe de armazenamento do objeto	Descrição
Archive	1 a 7 dias.
Cold Archive	1 a 365 dias.
Deep Cold Archive	1 a 365 dias.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--key	string	Caminho completo do objeto.
--restore-request	string	Informações da solicitação de restauração.
--version-id	string	ID da versão do objeto a ser restaurado.

Nota

O comando restore-object corresponde à operação RestoreObject. Para mais informações sobre os parâmetros dessa operação, consulte RestoreObject.

--restore-request

A opção de configuração --restore-request aceita 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"
  }
}

Nota

Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplos

Restaurar um objeto Archive

Restaure um objeto Archive chamado exampleobject em examplebucket.

Crie um arquivo de configuração chamado restore-request.xml e adicione o seguinte código:

<?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
</RestoreRequest>

Comando de exemplo:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

Crie um arquivo de configuração chamado restore-request.json e adicione o seguinte código:

{
  "Days": "2"
}

Comando de exemplo:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

Configure os parâmetros diretamente no comando usando o formato JSON:

ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\"}"

Restaurar objetos Cold Archive e Deep Cold Archive

Restaure um objeto Cold Archive chamado exampleobject em examplebucket.

Crie um arquivo de configuração chamado restore-request.xml e adicione o seguinte código:

<?xml version="1.0" encoding="UTF-8"?>
<RestoreRequest>
  <Days>2</Days>
  <JobParameters>
    <Tier>Standard</Tier>
  </JobParameters>
</RestoreRequest>

Comando de exemplo:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.xml

Crie um arquivo de configuração chamado restore-request.json e adicione o seguinte código:

{
  "Days": "2",
  "JobParameters": {
    "Tier": "Standard"
  }
}

Comando de exemplo:

ossutil api restore-object --bucket examplebucket --key exampleobject --restore-request file://restore-request.json

Configure os parâmetros diretamente no comando usando o formato JSON:

ossutil api restore-object  --bucket examplebucket --key exampleobject --restore-request "{\"Days\":\"2\",\"JobParameters\":{\"Tier\":\"Standard\"}}"

Operação de API relacionada

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