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õesoss:RestoreObjecteoss: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.
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
|
|
--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
|
|
--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. |
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.
NotaCada 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/key2ossutil 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.
NotaApó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.