Object Storage Service:Advanced commands

Escopo do comando

Opções compatíveis

Todos os comandos avançados

• --encoding-type string: Codificação para nomes de objetos ou arquivos de entrada. Valor válido: url.

• --request-payer string: Ativa o modo de pagamento pelo solicitante. Defina como requester.

Comandos com suporte a operações em lote

• --start-after/--end-with (, ]: Filtro de intervalo de chaves. Início exclusivo, fim inclusivo.

• Opções de filtro: Filtra por nome de objeto/arquivo, pasta, tamanho, tempo ou metadados. Opções de filtro.

• --limited-num: Limita o número de resultados retornados por consulta de API.

• --recursive/-r: Percorre recursivamente todos os subdiretórios.

• --dirs/-d: Lista apenas o diretório atual, excluindo subdiretórios.

  Nota

  Para objetos, esta opção utiliza o método Delimiter e verifica todos os objetos sob o prefixo. Quanto mais objetos, maior o tempo de verificação.

• --force/-f: Força a operação sem solicitar confirmação.

• --list-objects: Utiliza a API ListObjects para listar objetos.

Comandos com suporte a regras de filtragem de destino

• --update: Compara apenas o horário de modificação. Sincroniza somente quando a origem é mais recente que o destino.

• --size-only: Compara apenas o tamanho do arquivo. Sincroniza somente dados com tamanho de arquivo diferente.

• --checksum: Compara primeiro o tamanho do arquivo e depois o checksum CRC-64. Se o checksum estiver ausente em qualquer um dos lados, os arquivos são tratados como inconsistentes. Válido apenas para cópias de objeto para objeto.

• --ignore-existing: Ignora arquivos existentes.

Comandos com suporte a objetos únicos

--version-id string: O ID de versão do objeto.

Comandos com suporte ao modo de lista

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

--list-manifest-from: Lê a descrição do formato do arquivo de lista a partir de um arquivo. Este parâmetro é obrigatório quando o formato do arquivo de lista é inventory.

Opção local

Tipo de opção

Descrição

--encoding-type

string

Codificação para nomes de objetos ou arquivos de entrada. Valor válido: url.

--request-payer

string

Ativa o modo de pagamento pelo solicitante. Valor válido: requester.

--start-after

string

Retorna objetos em ordem alfabética após o valor especificado (exclusivo).

--end-with

string

Retorna objetos em ordem alfabética até o valor especificado (inclusivo).

--page-size

int

Máximo de objetos por página no processamento em lote. Padrão: 1000. Intervalo: 1 a 1000.

--include

stringArray

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

--include-from

stringArray

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

--exclude

stringArray

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

--exclude-from

stringArray

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

--filter

stringArray

Regra de filtro para caminhos ou nomes de arquivos.

--files-from

stringArray

Lê uma lista de nomes de arquivos de origem a partir de um arquivo. Linhas vazias ou de comentário são ignoradas. Aplica-se apenas a operações de filtragem de arquivos.

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de origem a partir de um arquivo. Aplica-se apenas a operações de filtragem de arquivos.

--max-age

Duration

Ignora arquivos mais antigos que esta idade. Unidade padrão: segundos. Suporta sufixos: ms, s, m, h, d, w, M, y. Padrão: desativado.

--min-age

Duration

Ignora arquivos mais recentes que esta idade. Unidade padrão: segundos. Suporta sufixos: ms, s, m, h, d, w, M, y. Padrão: desativado.

--max-mtime

Time

Ignora arquivos mais recentes que este timestamp UTC. Padrão: desativado.

--min-mtime

Time

Ignora arquivos mais antigos que este timestamp UTC. Padrão: desativado.

--max-size

SizeSuffix

Tamanho máximo de arquivo para transferir. Unidade padrão: bytes. Suporta sufixos: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

--min-size

SizeSuffix

Tamanho mínimo de arquivo para transferir. Unidade padrão: bytes. Suporta sufixos: B, K, M, G, T, P. 1 K (KiB) = 1024 B.

--metadata-exclude

stringArray

Regra de exclusão para metadados de objetos.

--metadata-include

stringArray

Regra de inclusão para metadados de objetos.

--metadata-filter

stringArray

Regra de filtro para metadados de objetos.

--metadata-filter-from

stringArray

Lê regras de filtro de metadados de objetos de um arquivo de regras.

--checksum

/

Copia apenas arquivos de origem cujo tamanho e checksum (se existir) sejam inconsistentes.

--size-only

/

Copia apenas arquivos de origem com tamanho inconsistente.

-u, --update

/

Copia apenas arquivos de origem mais recentes que os arquivos de destino.

-r, --recursive

/

Opera recursivamente em todos os objetos correspondentes no bucket. Sem esta opção, opera apenas no caminho especificado.

-d, --dirs

/

Lista apenas arquivos e subdiretórios na pasta atual, sem recursão.

-f, --force

/

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

--list-objects

/

Utiliza a API ListObjects para listar objetos.

--no-progress

/

Não exibe a barra de progresso.

-j, --job

int

Tarefas simultâneas para operações com múltiplos arquivos. Padrão: 3.

--checkers

int

Verificadores paralelos. Padrão: 16.

--parallel

int

Tarefas simultâneas para operações multipart de arquivo único.

--part-size

SizeSuffix

Tamanho da parte para operações multipart. Calculado automaticamente por padrão. Intervalo: 100 KiB a 5 GiB.

--bigfile-threshold

int

Limiar de tamanho para upload, download ou cópia multipart. Padrão: 104857600 (100 MiB).

--version-id

string

O ID de versão do objeto.

--storage-class

string

A classe de armazenamento do objeto. Valores válidos: Standard, IA, Archive, ColdArchive e DeepColdArchive.

--acl

string

As permissões de acesso do objeto. Valores válidos: private, public-read, public-read-write e default.

--cache-control

string

Controla o comportamento de cache do navegador quando o objeto é baixado.

--content-disposition

string

Formato de exibição do objeto.

--content-encoding

string

Codificação de conteúdo do objeto.

--content-type

string

O tipo de conteúdo do objeto.

--expires

string

Tempo de expiração absoluto para conteúdo em cache.

--copy-props

string

Propriedades a serem copiadas do objeto de origem. Valores válidos: none, metadata, default.

--tagging

string

Tags de objeto no formato chave=valor.

--tagging-directive

string

Como definir as tags do objeto de destino. Valores válidos: COPY, REPLACE.

--metadata

string

Metadados do usuário no formato chave=valor.

--metadata-directive

string

Como definir os metadados do objeto de destino. Valores válidos: COPY, REPLACE.

--list-format

string

O 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. Este parâmetro é obrigatório quando o formato do arquivo de lista é inventory.

Item

Descrição

Sintaxe da regra de filtro

• padrão de regra parâmetro de opção de regra: Um padrão de correspondência Glob.

• nome de arquivo de regra parâmetro de opção de regra: O caminho de um arquivo que contém regras de padrão de correspondência Glob.

• modificadores de regra padrão parâmetro de opção de regra: Um padrão de correspondência Glob instrucional. A instrução + indica uma regra de inclusão. Objetos que correspondem a esta regra são incluídos no resultado. A instrução - indica uma regra de exclusão. Objetos que correspondem a esta regra são excluídos do resultado.

Parâmetros de opção de regra de filtro

• --include

• --include-from

• --exclude

• --exclude-from

• --filter

• --filter-from

Opção

Descrição

--include

--exclude

O parâmetro é seguido por um padrão de correspondência. Cada opção representa uma regra. Para usar múltiplas regras, repita estas opções.

Por exemplo, --include ".txt" --include ".js" --exclude "*.jpg" inclui todos os arquivos .txt e .js, mas exclui todos os arquivos .jpg.

O comando de exemplo a seguir baixa recursivamente arquivos que correspondem às regras de filtro da pasta oss://examplebucket/exampledir/ no Alibaba Cloud OSS para a pasta localdir/. As regras incluem todos os arquivos .txt e .js, mas excluem todos os arquivos .jpg.

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --include "*.txt" --include "*.js" --exclude "*.jpg"

--filter

O parâmetro é seguido por um padrão de correspondência instrucional. Cada valor de opção representa uma regra. Para usar múltiplas regras, repita estas opções.

Por exemplo, --filter "+ .txt" --filter "+ .js" --filter "- *.jpg" inclui todos os arquivos .txt e .js, mas exclui todos os arquivos .jpg.

• O símbolo + indica uma regra de inclusão. Objetos que correspondem a esta regra são incluídos no resultado.

• O símbolo - indica uma regra de exclusão. Objetos que correspondem a esta regra são excluídos do resultado.

O comando de exemplo a seguir baixa recursivamente arquivos que correspondem às regras de filtro da pasta oss://examplebucket/exampledir/ no Alibaba Cloud OSS para a pasta localdir/. As regras excluem arquivos .txt e .js, e incluem apenas arquivos .png.

ossutil cp -r oss://examplebucket/exampledir/ localdir/ --filter "- *.txt" --filter "- *.js" --filter "+ *.png"

--include-from

--exclude-from

O parâmetro é seguido pelo caminho de um arquivo de regras. Cada linha no arquivo de regras representa um padrão de correspondência Glob. Para importar múltiplos arquivos de regras, repita estas opções.

Todas as regras importadas com --include-from são regras de inclusão. Todas as regras importadas com --exclude-from são regras de exclusão.

Por exemplo, --include-from include-file.txt --exclude-from exclude-file.txt inclui todos os arquivos .txt e .js, mas exclui todos os arquivos .jpg.

O conteúdo do arquivo de regras include-file.txt é o seguinte:

 *.txt
 *.js

O arquivo de regras include-file.txt contém o seguinte:

 *.jpg

--filter-from

O parâmetro é seguido pelo caminho de um arquivo de regras. Cada linha no arquivo de regras representa um padrão de correspondência Glob instrucional.

Para importar múltiplos arquivos de regras, repita estas opções.

Por exemplo, em --filter-from filter-file.txt, o conteúdo do arquivo de regras filter-file.txt é o seguinte:

 # a filter rule file
     + *.txt
     + *.js
     - **

Opção

Descrição

--files-from

Lê uma lista de caminhos/nomes de arquivos de um arquivo. Repita esta opção para usar múltiplos arquivos de lista.

Ao processar cada linha no arquivo de lista, espaços iniciais ou finais são removidos, e linhas de comentário começando com # ou ; são ignoradas.

--files-from-raw

Lê uma lista de caminhos/nomes de arquivos de um arquivo. Repita esta opção para usar múltiplos arquivos de lista.

Ao processar cada linha no arquivo de lista, espaços iniciais ou finais e linhas de comentário começando com # ou ; não são ignorados.

Parâmetro

Descrição

--min-age

Duration

Processa apenas arquivos modificados antes do intervalo especificado. Unidade padrão: segundos. Suporta sufixos de unidade, ex: 1h.

--max-age

Duration

Processa apenas arquivos modificados dentro do intervalo especificado. Unidade padrão: segundos. Suporta sufixos de unidade, ex: 1h.

--min-mtime

Time

Processa apenas arquivos modificados após o horário especificado.

--max-mtime

Time

Processa apenas arquivos modificados antes do horário especificado.

Parâmetro

Descrição

--min-size

Ignora arquivos menores que este tamanho. Unidade padrão: bytes. Exemplo: 1K (KiB) = 1024 bytes.

--max-size

Ignora arquivos maiores que este tamanho. Unidade padrão: bytes. Exemplo: 1K (KiB) = 1024 bytes.