Todos os produtos
Search
Central de documentação

Object Storage Service:restore

Última atualização: Sep 21, 2026

Se o acesso em tempo real a objetos Archive não estiver ativado, só será possível acessá-los após a restauração. O acesso em tempo real de objetos Archive não é compatível com objetos Cold Archive e Deep Cold Archive. Para acessar objetos Cold Archive e Deep Cold Archive, é necessário restaurá-los primeiro. Em geral, a restauração de um objeto Archive leva alguns minutos, a de um objeto Cold Archive leva algumas horas, e a de um objeto Deep Cold Archive leva de 12 a 48 horas. Os tempos de restauração mencionados servem apenas como referência e podem variar conforme o cenário real. Este tópico descreve como executar o comando restore para restaurar objetos.

Notas de uso

  • Para restaurar um único objeto, você precisa da permissão oss:RestoreObject. Para restaurar objetos por diretório, você precisa das permissões oss:RestoreObject e oss:ListObjects. Para mais informações, consulte Grant a custom policy.

  • Para mais informações sobre o processo de restauração e as regras de faturamento, consulte Restore objects.

Sintaxe do comando

ossutil restore oss://bucket/object [flags]

Parâmetro

Tipo

Descrição

--days

int

A duração na qual o objeto permanece no estado restaurado. Unidade: dias. Valores válidos: 1 a 365.

Ao operar em lote sobre objetos de diferentes classes de armazenamento, se o valor do parâmetro --days exceder a duração máxima de uma classe específica, ele será automaticamente ajustado para a duração máxima dessa classe. Por exemplo, a duração máxima suportada pelo Archive é 7 dias e pelo Deep Cold Archive é 365 dias. Se você definir o parâmetro --days como 100, a duração para objetos Archive será automaticamente ajustada para 7 dias, enquanto a duração para objetos Deep Cold Archive será definida como 100 dias.

--tier

string

A prioridade de restauração. Não é necessário especificar este parâmetro para objetos Archive. A restauração leva aproximadamente 1 minuto.

  • Cold Archive:

    • Expedited: o objeto é restaurado em até 1 hora.

    • Standard: o objeto é restaurado em 2 a 5 horas.

    • Bulk: o objeto é restaurado em 5 a 12 horas.

  • Deep Cold Archive:

    • Expedited: o objeto é restaurado em até 12 horas.

    • Standard: o objeto é restaurado em até 48 horas.

Ao operar em lote sobre objetos de diferentes classes de armazenamento, se o valor do parâmetro --tier exceder a prioridade suportada pela classe de armazenamento, ele será automaticamente ajustado para a prioridade mais baixa dessa classe. Por exemplo, objetos Cold Archive suportam Bulk, enquanto objetos Deep Cold Archive suportam apenas Standard. Nesse caso, se você definir o parâmetro --tier como Bulk, a prioridade de restauração será automaticamente ajustada para Standard.

--dirs

/

Lista objetos e subdiretórios no diretório atual, em vez de exibir recursivamente todos os objetos em todos os subdiretórios.

--encoding-type

string

O método de codificação usado para codificar o nome do objeto. Valor válido: url.

--end-with

string

Retorna objetos cujos nomes são alfabeticamente anteriores ou iguais ao valor do parâmetro --end-with.

--exclude

stringArray

Defina uma regra de exclusão para caminhos ou nomes de objetos.

--exclude-from

stringArray

Lê regras de exclusão a partir de um arquivo.

--files-from

stringArray

Lê nomes de objetos a partir de um arquivo, ignorando linhas vazias e linhas de comentário.

--files-from-raw

stringArray

Lê nomes de objetos a partir de um arquivo, sem ignorar linhas vazias e linhas de comentário.

--filter

stringArray

Defina uma regra de filtro para caminhos ou nomes de objetos.

--filter-from

stringArray

Lê regras de filtro a partir de um arquivo.

-f, --force

/

Força a operação sem exigir confirmação.

--include

stringArray

Defina uma regra de inclusão para caminhos ou nomes de objetos.

--include-from

stringArray

Lê regras de inclusão a partir de um arquivo.

--limited-num

int

O número máximo de resultados a retornar.

--list-objects

/

Lista objetos por meio da operação ListObjects.

--min-age

Duration

Exclui objetos cuja última modificação é posterior ao valor desta opção. A unidade padrão é s (segundos). Você pode adicionar um sufixo de unidade de tempo ao valor numérico. Por exemplo, 1h indica uma hora.

Nota

--min-age 1h especifica que apenas objetos modificados há mais de uma hora são transferidos.

--max-age

Duration

Exclui objetos cuja última modificação é anterior ao valor desta opção. A unidade padrão é s (segundos). Você pode adicionar um sufixo de unidade de tempo ao valor numérico. Por exemplo, 1h indica uma hora.

--min-mtime

Time

Exclui objetos cuja última modificação é anterior ao valor desta opção. O horário deve estar em UTC. Exemplo: 2006-01-02T15:04:05.

Nota

--min-mtime "2006-01-02T15:04:05" especifica que apenas objetos modificados após 15:04:05 de 02/01/2006 são transferidos.

--max-mtime

Time

Exclui objetos cuja última modificação é posterior ao valor desta opção. O horário deve estar em UTC. Exemplo: 2006-01-02T15:04:05.

--max-size

SizeSuffix

O tamanho máximo de um objeto que pode ser transferido. Por padrão, o tamanho é em bytes (B). Você pode adicionar um sufixo de unidade baseada em 1024: B para byte, K para Kibibyte, M para Mebibyte, G para Gibibyte, T para Tebibyte ou P para Pebibyte.

--metadata-exclude

stringArray

Defina uma regra de exclusão para metadados de objetos.

--metadata-filter

stringArray

A regra de filtro para metadados de objetos.

--metadata-filter-from

stringArray

Lê regras de filtro de metadados a partir de um arquivo.

--metadata-include

stringArray

Defina uma regra de inclusão para metadados de objetos.

--min-size

SizeSuffix

O tamanho mínimo de um arquivo ou objeto que pode ser transferido. Por padrão, o tamanho é em bytes (B). Você pode adicionar um sufixo de unidade baseada em 1024: B para byte, K para Kibibyte, M para Mebibyte, G para Gibibyte, T para Tebibyte ou P para Pebibyte.

--page-size

int

O número máximo de objetos retornados por página na listagem paginada em modo batch. Valores válidos: 1 a 1000. Valor padrão: 1000.

-r, --recursive

/

Indica que o comando executa a operação de forma recursiva. Quando especificado, o comando opera em todos os objetos correspondentes no bucket. Caso contrário, o comando opera apenas nos objetos especificados no caminho indicado.

--request-payer

string

O pagador da solicitação. Se o pagamento pelo solicitante estiver ativado, especifique este parâmetro. Valor válido: requester.

--start-after

string

Retorna objetos cujos nomes são alfabeticamente posteriores ao valor do parâmetro --start-after.

--version-id

string

O ID de versão do objeto.

--list-format

string

O formato do arquivo de lista. Valores válidos: plain e inventory.

--list-manifest-from

string

Lê a descrição de formato do arquivo de lista a partir de um arquivo. Especifique este parâmetro obrigatoriamente quando o formato for inventory.

Nota

Para mais informações, consulte Command-line options.

Exemplos

Restaurar objetos Archive

  • O exemplo a seguir mostra como restaurar um objeto Archive chamado exampleobject.txt no examplebucket:

    ossutil restore oss://examplebucket/exampleobject.txt
  • O exemplo a seguir demonstra como restaurar um objeto Archive chamado exampleobject.txt no examplebucket e defina a duração do estado restaurado como 3 dias:

    ossutil restore oss://examplebucket/exampleobject.txt --days 3
  • O exemplo a seguir ilustra como restaurar objetos a partir de uma lista.

    Nota

    Cada linha do arquivo de lista representa um objeto. Todos os objetos no arquivo estão no formato de caminho OSS: oss://{bucket}/{key}.

    A seção a seguir utiliza list.txt como exemplo.

    oss://examplebucket/key1
    oss://examplebucket/key2
    ossutil restore list://list.txt
  • O exemplo a seguir mostra como restaurar objetos diretamente a partir de uma lista, sem verificar o status dos objetos.

    ossutil restore list://list.txt --no-check-status 
  • Este exemplo demonstra como restaurar objetos a partir do arquivo de lista.

    Nota

    Após a configuração do inventário, são gerados um arquivo csv.gz e um arquivo manifest.json, ambos necessários para a restauração de objetos a partir do arquivo de lista.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json
  • Este exemplo mostra como restaurar objetos diretamente a partir do arquivo de lista, sem verificar o status dos objetos.

    ossutil restore list://ca8007fc-4123-493e-9a01-dd1511fbac54.csv.gz --list-format inventory --list-manifest-from manifest.json --no-check-status

Restaurar objetos Cold Archive

O exemplo a seguir mostra como restaurar um objeto Cold Archive chamado exampleobject.txt no examplebucket e defina a duração do estado restaurado como 5 dias:

ossutil restore oss://examplebucket/exampleobject.txt --tier Bulk --days 5

Restaurar objetos Deep Cold Archive

O exemplo a seguir mostra como restaurar um objeto Deep Cold Archive chamado exampleobject.txt no examplebucket e defina a duração do estado restaurado como 10 dias:

ossutil restore oss://examplebucket/exampleobject.txt --tier Standard --days 10

Regras de faturamento

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

  • A restauração de objetos Archive gera taxas de chamada de operação de API com base no número de solicitações PUT. Para mais informações, consulte Request fees.

  • Ao restaurar objetos Cold Archive ou Deep Cold Archive, são cobradas solicitações de recuperação de dados. Para mais informações, consulte Request fees.

  • Taxas de armazenamento são cobradas 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 Storage fees.

  • Ao restaurar um objeto Cold Archive ou Deep Cold Archive, uma réplica Standard é gerada para acesso temporário. O armazenamento temporário dessa réplica é cobrado de acordo com a 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.

  • Um objeto Archive pode permanecer no estado restaurado por até sete dias. Objetos Cold Archive ou Deep Cold Archive podem permanecer no estado restaurado por até 365 dias. Não há cobrança de taxas de recuperação de dados enquanto o objeto estiver no estado restaurado.

  • Após o término do período em que o objeto permanece no estado restaurado, ele retorna ao estado congelado. Se você restaurar o objeto novamente depois que ele voltar ao estado congelado, taxas de recuperação de dados serão cobradas.