Object Storage Service:revert

Parâmetro

Tipo

Descrição

version-directive

string

Versão excluída do objeto a ser restaurada. Valores válidos:

• ID da versão. Exemplo: CAEQIBiBgICAr6yv9hgiIDZiNmUzNjM5Njg0ZDRhOWQ4Yj.

• Índice de versão. Formato: HEAD~n. Restaura a versão do objeto para a n-1 versão válida, excluindo o marcador de exclusão.

  • Se o índice de versão for HEAD~0, o objeto retorna à versão válida imediatamente anterior. Se a versão mais recente for um marcador de exclusão, a restauração ocorre mediante a remoção desse marcador.

  • Se o índice de versão for HEAD~n (n > 0), a versão do objeto é restaurada pela cópia da versão correspondente.

• Índice de tempo. Formato: NOW~Tempo relativo ou NOW~Tempo absoluto. Restaura a versão válida mais recente cuja última modificação não ultrapasse o horário especificado, desconsiderando o marcador de exclusão.

  • NOW~ tempo relativo: Permite retroceder um intervalo específico a partir da hora local atual. O formato é NOW~ seguido de um sufixo de unidade de tempo. Sufixos suportados: ms (milissegundos), s (segundos), m (minutos), h (horas), d (dias), w (semanas), M (meses) e y (anos).

    • Exemplo: NOW~1d restaura a versão de um dia antes da hora local atual.

  • NOW~ tempo absoluto: Para cenários que exigem data e hora específicas, utilize um índice de tempo absoluto. O formato é NOW~ seguido de uma string de tempo conforme o padrão ISO 8601 (YYYY-MM-DDTHH:mm:ss). Isso restaura a versão mais recente anterior ao horário local especificado.

    • Exemplo: NOW~2024-04-12T14:00:00 restaura a versão válida mais recente cuja última modificação não seja posterior às 14:00:00 de 12 de abril de 2024.

-d, --dirs

/

Retorna os objetos e subdiretórios no diretório atual.

--encoding-type

string

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

--end-with

string

Retorna apenas objetos cujos nomes sejam alfabeticamente anteriores ou iguais ao valor do parâmetro --end-with.

--exclude

stringArray

Regra de exclusão para caminhos ou nomes de objetos.

--exclude-from

stringArray

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

--files-from

stringArray

Lê os nomes dos objetos de source do arquivo de regras, ignorando linhas vazias ou comentários.

--files-from-raw

stringArray

Lê os nomes dos objetos de source diretamente do arquivo de regras.

--filter

stringArray

Regra de filtro aplicada aos caminhos ou nomes de objetos.

--filter-from

stringArray

Carrega a regra de filtro para caminhos ou nomes de objetos de um arquivo de regras.

-f, --force

/

Força a execução do comando sem solicitar confirmação.

--ignore-version-not-exist

/

Ignora erros sobre versões inexistentes durante operações em lote.

--include

stringArray

Regra de inclusão para caminhos ou nomes de objetos.

--include-from

stringArray

Obtém a regra de inclusão de um arquivo de regras.

--max-age

Duração

Restaura apenas objetos modificados dentro da duração especificada. A unidade padrão é segundos. Também é possível usar um sufixo, como 1h para uma hora.

--min-mtime

Hora

Restaura apenas objetos cuja última modificação tenha ocorrido após o horário especificado. Exemplo: 2006-01-02T15:04:05.

--page-size

int

Número máximo de objetos listados por solicitação de API durante operações em lote. Valor padrão: 1000. Intervalo válido: 1 a 1000.

-r, --recursive

/

Executa o comando recursivamente nos objetos. Se especificado, o comando revert afeta todos os objetos que atendam às condições no bucket. Caso contrário, atua apenas sobre os objetos no caminho especificado.

--request-payer

string

Pagador da solicitação. Se o pagamento pelo solicitante estiver ativado para o bucket, defina este parâmetro como requester. Valor válido: requester.

--start-after

string

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