Object Storage Service:cp (baixe arquivos)

Parâmetro

Tipo

Descrição

local-path

string

Aceita caminhos relativos, absolutos e -. Quando definido como -, direciona a saída para a saída padrão.

prefix

string

Prefixo do objeto. Se terminar com "/", apenas operações em lote são suportadas. Caso contrário, o comando determina se deve executar um download de objeto único ou em lote com base nas opções da linha de comando.

--acl

string

Permissões de acesso ao objeto. Valores válidos:

• private: privado.

• public-read: leitura pública.

• public-read-write: leitura e escrita públicas.

• default: herdar do bucket.

--bandwidth-limit

SizeSuffix

Limita a largura de banda da rede para controlar a taxa de transferência de dados. O valor mínimo é 1024 B/s e a unidade padrão é B/s.

É possível especificar uma unidade para o valor da largura de banda. As unidades suportadas incluem B (bytes), K (kilobytes), M (megabytes) e G (gigabytes). Por exemplo, 50 M define o limite como 50 MB/s.

--bigfile-threshold

SizeSuffix

Limiar para ativar upload, download ou cópia multipart para arquivos grandes (padrão: 104857600).

--cache-control

string

Define o comportamento de cache quando um navegador web baixa o objeto.

--checkers

int

Número de verificadores concorrentes (padrão: 16).

--checkpoint-dir

string

Diretório para armazenar informações de checkpoint de download retomável (padrão: .ossutil_checkpoint/).

--content-disposition

string

Especifica como exibir o objeto.

--content-encoding

string

Declara o método de codificação do objeto.

--content-type

string

Tipo de conteúdo do objeto.

--copy-props

string

Controla a cópia de metadados e tags. Valores válidos:

• none: não copiar.

• metadata: copiar metadados.

• default: copiar metadados e tags.

-d, --dirs

string

Baixa arquivos e subdiretórios no diretório atual sem baixar recursivamente todos os arquivos em subdiretórios aninhados.

--encoding-type

string

Método de codificação para nomes de objetos de entrada ou nomes de arquivos. Valor válido: url.

--end-with

string

Retorna objetos anteriores ou correspondentes ao valor especificado em ordem alfabética.

--exclude

stringArray

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

--exclude-from

stringArray

Lê regras de exclusão de um arquivo.

--expires

string

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

--files-from

stringArray

Lê uma lista de nomes de arquivos de source de um arquivo, ignorando linhas vazias ou de comentário. Aplica-se apenas a cenários de filtragem.

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de source de um arquivo. Aplica-se apenas a cenários de filtragem.

--filter

stringArray

Regras de filtragem para caminhos ou nomes de arquivos.

--filter-from

stringArray

Lê regras de filtragem de um arquivo.

-f, --force

/

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

--include

stringArray

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

--include-from

stringArray

Lê regras de inclusão de um arquivo.

-j, --job

int

Número de tarefas concorrentes (padrão: 3).

--list-objects

/

Usa a API ListObjects para listar objetos.

--max-size

SizeSuffix

Tamanho máximo de arquivo a transferir. A unidade padrão é bytes. É possível adicionar um sufixo: B|K|M|G|T|P. Observação: 1K (KiB) = 1024B.

--metadata

strings

Metadados definidos pelo usuário para o objeto, no formato chave=valor.

--metadata-directive

string

Define como configurar metadados para o objeto de destino. Valores válidos:

• COPY

• REPLACE

--metadata-exclude

stringArray

Regras de exclusão para metadados de objetos.

--metadata-filter

stringArray

Regras de filtragem para metadados de objetos.

--metadata-filter-from

stringArray

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

--metadata-include

stringArray

Regras de inclusão para metadados de objetos.

--min-age

Duration

Baixa apenas arquivos modificados antes do intervalo de tempo especificado. A unidade padrão é segundos. É possível usar sufixos como h (horas). Por exemplo, 1h significa 1 hora.

--max-age

Duration

Baixa apenas arquivos modificados dentro do intervalo de tempo especificado. A unidade padrão é segundos. É possível usar sufixos como h (horas). Por exemplo, 1h significa 1 hora.

--min-mtime

Time

Baixa apenas arquivos modificados após o horário especificado. Formato de hora: UTC (por exemplo, 2006-01-02T15:04:05).

--max-mtime

Time

Baixa apenas arquivos modificados antes do horário especificado. Formato de hora: UTC (por exemplo, 2006-01-02T15:04:05).

--min-size

SizeSuffix

Tamanho mínimo de arquivo a transferir. A unidade padrão é bytes. É possível adicionar um sufixo: B|K|M|G|T|P. Observação: 1K (KiB) = 1024B.

--no-progress

/

Não exibe a barra de progresso.

--page-size

int

Número máximo de objetos listados por página durante o download em lote (padrão: 1000). Intervalo válido: 1–1000.

--parallel

int

Número de tarefas concorrentes para operações internas em um único arquivo.

--part-size

SizeSuffix

Tamanho da parte para operações multipart. Por padrão, o ossutil calcula um tamanho adequado com base no tamanho do arquivo. Intervalo válido: 100 KiB–5 GiB.

-r, --recursive

/

Executa operações recursivamente. Quando esta opção é especificada, o comando opera em todos os objetos correspondentes no bucket. Caso contrário, opera apenas no objeto especificado pelo caminho.

--request-payer

string

Método de pagamento da requisição. Defina como requester se o bucket usar o modo pay-by-requester.

--size-only

/

Baixa apenas arquivos de source cujos tamanhos diferem dos arquivos de destino.

--start-after

string

Retorna objetos posteriores ao valor especificado em ordem alfabética, excluindo o próprio valor.

--storage-class

string

Classe de armazenamento do objeto. Valores válidos:

• Standard: Armazenamento padrão.

• IA: Armazenamento de acesso pouco frequente.

• Archive: Archive Storage.

• ColdArchive: Armazenamento Cold Archive.

• DeepColdArchive: Armazenamento Deep Cold Archive.

--tagging

strings

Tags para o objeto, no formato chave=valor.

--tagging-directive

string

Define como configurar tags para o objeto de destino. Valores válidos:

• COPY

• REPLACE

-u, --update

/

Ignora arquivos que já existem no destino e possuem tempo de modificação mais recente que os arquivos de source.

--ignore-existing

/

Ignora arquivos que já existem no destino.

--version-id

string

ID da versão do objeto.

--write-buffer-size

SizeSuffix

Tamanho do buffer de memória usado para gravações. Alinhado automaticamente a limites de 4 KB. Suporta sufixos B / K / M (padrão: 128 KiB). Intervalo válido: 0–32 MiB.