Object Storage Service:restore

Parâmetro

Tipo

Descrição

--days

int

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

Ao operar em lote com objetos de diferentes classes de armazenamento, se o valor de --days exceder o limite máximo de uma classe específica, o sistema ajustará automaticamente esse valor para o máximo permitido naquela classe. Por exemplo, Archive suporta até 7 dias e Deep Cold Archive até 365 dias. Se você definir --days como 100, os objetos Archive serão restaurados por 7 dias e os objetos Deep Cold Archive por 100 dias.

--tier

string

Prioridade da restauração. Não é necessário especificar este parâmetro para objetos Archive, cuja restauração leva aproximadamente 1 minuto.

• Cold Archive:

  • Expedited: Objeto restaurado em até 1 hora.

  • Standard: Objeto restaurado em 2 a 5 horas.

  • Bulk: Objeto restaurado em 5 a 12 horas.

• Deep Cold Archive:

  • Expedited: Objeto restaurado em até 12 horas.

  • Standard: Objeto restaurado em até 48 horas.

Em operações em lote envolvendo múltiplas classes de armazenamento, caso o valor de --tier ultrapasse a prioridade suportada pela classe, o sistema redefinirá automaticamente para a menor prioridade válida daquela classe. Por exemplo, Cold Archive aceita Bulk, mas Deep Cold Archive aceita apenas Standard. Assim, se você definir --tier como Bulk, a prioridade será ajustada automaticamente para Standard.

--archive-max-days

int

Número máximo de dias que objetos Archive permanecem restaurados durante uma operação em lote. Valor padrão: 7. Se o valor de --days for superior a este parâmetro, os objetos Archive serão restaurados por este número de dias, enquanto as demais classes seguirão o valor definido em --days.

--checkers

int

Quantidade de verificadores executados em paralelo. Valor padrão: 16.

--dirs

/

Lista objetos e subdiretórios no diretório atual, sem exibir recursivamente todo o conteúdo dos subdiretórios.

--encoding-type

string

Método de codificação aplicado ao nome do objeto. Valor válido: url.

--end-with

string

Retorna objetos cujos nomes sejam alfabeticamente anteriores ou iguais ao valor definido em --end-with.

--exclude

stringArray

Define 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 de um arquivo, ignorando linhas vazias ou comentários.

--files-from-raw

stringArray

Lê nomes de objetos de um arquivo, considerando inclusive linhas vazias e comentários.

--filter

stringArray

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

--filter-from

stringArray

Carrega regras de filtro a partir de um arquivo.

-f, --force

/

Força a execução da operação sem solicitar confirmação.

--include

stringArray

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

--include-from

stringArray

Importa regras de inclusão de um arquivo.

-j, --job

int

Número de tarefas concorrentes para operações em lote envolvendo múltiplos objetos. Valor padrão: 3.

--limited-num

int

Limite máximo de resultados a serem retornados.

--list-objects

/

Lista objetos utilizando a operação ListObjects.

--min-age

Duration

Exclui objetos modificados após o valor especificado nesta opção. A unidade padrão é s (segundos), mas é possível adicionar sufixos temporais ao valor numérico. Por exemplo, 1h equivale a uma hora.

--max-age

Duration

Exclui objetos modificados antes do valor especificado nesta opção. A unidade padrão é s (segundos), aceitando também sufixos temporais. Por exemplo, 1h equivale a uma hora.

--min-mtime

Time

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

--max-mtime

Time

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

--max-size

SizeSuffix

Tamanho máximo permitível para transferência de objetos. Por padrão, o valor está em bytes (B). É possível usar sufixos baseados em 1024: B para byte, K para Kibibyte, M para Mebibyte, G para Gibibyte, T para Tebibyte ou P para Pebibyte.

--metadata-exclude

stringArray

Exclui objetos cujos metadados correspondam à regra definida. A correspondência segue o formato key=value, sendo que o valor aceita o caractere curinga *. Se você especificar apenas key= sem valor, nenhuma correspondência ocorrerá — nem mesmo para objetos nunca restaurados —, resultando no mesmo efeito de não aplicar nenhuma regra de exclusão.

--metadata-filter

stringArray

Regra de filtro aplicada aos metadados dos objetos. Para mais informações, consulte Filter objects based on object metadata.

--metadata-filter-from

stringArray

Lê regras de filtro de metadados de um arquivo. Para mais informações, consulte Filter objects based on object metadata.

--metadata-include

stringArray

Inclui apenas objetos cujos metadados correspondam à regra. Os demais são excluídos por padrão. A correspondência utiliza o formato key=value, e o valor aceita o caractere curinga *.

--min-size

SizeSuffix

Tamanho mínimo permitível para transferência de arquivos e objetos. Por padrão, o valor está em bytes (B). É possível usar sufixos baseados em 1024: B para byte, K para Kibibyte, M para Mebibyte, G para Gibibyte, T para Tebibyte ou P para Pebibyte.

--no-check-status

/

Aplicável somente no modo de lista list://. Ignora a verificação de status e envia solicitação de restauração para todos os objetos da lista. Sem essa opção, o modo de lista comporta-se como o modo recursivo: pula objetos em restauração e aqueles fora da classe Archive, mas ainda envia solicitações para objetos já restaurados. Com esta opção, objetos em restauração retornam o erro RestoreAlreadyInProgress, e objetos fora da classe Archive retornam OperationNotSupported. No modo recursivo, esta opção não produz efeito.

--no-error-report

/

Desativa a geração do arquivo de relatório de erros em operações em lote.

--no-progress

/

Oculta a barra de progresso.

--output-dir

string

Diretório destinado ao armazenamento do relatório de erros gerado em operações em lote. Valor padrão: ossutil_output.

--page-size

int

Quantidade máxima de objetos retornados por página durante listagem paginada em modo de lote. Valores válidos: 1 a 1000. Valor padrão: 1000.

-r, --recursive

/

Ative a execução recursiva do comando. Quando especificado, a operação abrange todos os objetos correspondentes no bucket. Caso contrário, o comando atua apenas sobre os objetos explicitamente indicados no caminho fornecido.

--request-payer

string

Responsável pelo pagamento da solicitação. Obrigatório quando o recurso pay-by-requester estiver ativo. Valor válido: requester.

--start-after

string

Retorna objetos cujos nomes sejam alfabeticamente posteriores ao valor desta opção, excluindo o próprio valor.

--support-dir-object

/

Trata objetos de diretório (nomes terminados em /) como objetos comuns ao ler uma lista de nomes de objetos, por exemplo, via --files-from.

--version-id

string

ID da versão do objeto.

--list-format

string

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

--list-manifest-from

string

Lê a descrição do formato do arquivo de lista a partir de um arquivo. Parâmetro obrigatório quando o formato for inventory.