Object Storage Service:cp (upload files)

Parâmetro

Tipo

Descrição

source

string

Caminho do arquivo local. Aceita caminhos relativos, absolutos e -. Quando definido como -, os dados são lidos da entrada padrão.

dest

string

Caminho do arquivo no bucket de destino. Exemplo: oss://bucket[/prefix].

--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. A unidade padrão é B/s.

Ao definir este parâmetro, especifique uma unidade conforme necessário. As unidades válidas incluem B (bytes), K (kilobytes), M (megabytes) e G (gigabytes). Por exemplo, 50 M define o limite de largura de banda para 50 MB/s.

--bigfile-threshold

SizeSuffix

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

--cache-control

string

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

--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

Determina quais propriedades copiar do objeto de origem. Valores válidos:

• none

• metadata

• default

--checkpoint-dir

string

• Se nenhum caminho de diretório de checkpoint for especificado, o upload retomável fica desativado.

• Se um diretório for especificado, o upload retomável será ativado e os arquivos de checkpoint serão salvos no subdiretório .ossutil_checkpoint dentro do caminho indicado.

-d, --dirs

string

Lista arquivos e subdiretórios no diretório atual sem listar recursivamente todos os arquivos nos subdiretórios.

--encoding-type

string

Método de codificação para nomes de objetos ou arquivos de entrada. 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 de regras.

--expires

stringArray

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

--files-from

stringArray

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

--files-from-raw

stringArray

Lê uma lista de nomes de arquivos de origem a partir 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 de regras.

-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 de regras.

-j, --job

int

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

--listObjects

/

Usa a API ListObjects para listar objetos.

--max-size

SizeSuffix

Tamanho máximo de arquivo para transferir. A unidade padrão é bytes. Você também pode usar sufixos: B|K|M|G|T|P. Observação: 1K (KiB) = 1024B.

--metadata

strings

Metadados definidos pelo usuário para o objeto, no formato key=value.

--metadata-directive

string

Especifica como definir 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 de regras.

--metadata-include

stringArray

Regras de inclusão para metadados de objetos.

--min-age

Duration

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

--max-age

Duration

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

--min-mtime

Time

Envia apenas arquivos modificados após o horário especificado, por exemplo, 2006-01-02T15:04:05.

--max-mtime

Time

Envia apenas arquivos modificados antes do horário especificado, por exemplo, 2006-01-02T15:04:05.

--min-size

SizeSuffix

Tamanho mínimo de arquivo para transferir. A unidade padrão é bytes. Você também pode usar sufixos: 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 upload em lote. Valor 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 upload multipart. Por padrão, o ossutil calcula um tamanho de parte apropriado com base no tamanho do arquivo. Intervalo válido: 100 KiB–5 GiB.

-r, --recursive

/

Executa a operação 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 este parâmetro se o bucket utilizar o modo pay-by-requester. Valor válido: requester.

--size-only

/

Envia apenas arquivos de origem cujo tamanho difere dos arquivos de destino.

--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: Cold Archive storage.

• DeepColdArchive: Deep Cold Archive storage.

--tagging

strings

Tags para o objeto, no formato key=value.

--tagging-directive

string

Especifica como definir tags para o objeto de destino. Valores válidos:

• COPY

• REPLACE

-u, --update

/

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

--ignore-existing

/

Ignora arquivos que já existem no destino.

--enable-symlink-dir

/

Segue e envia subdiretórios com links simbólicos (symlink) durante o upload. Por padrão, o comando cp ignora subdiretórios com symlink ao enviar um diretório. Quando esta opção é especificada, o comando envia recursivamente o conteúdo desses subdiretórios.

Parâmetro

Valor recomendado

Descrição

-j, --job

10

Número de tarefas concorrentes para upload de múltiplos arquivos. Valor padrão: 3. Esta opção só tem efeito quando você também especifica -f, --update, --size-only ou --ignore-existing.

--parallel

10

Número de tarefas concorrentes para operações internas (como uploads multipart) em um único arquivo. Aumentar este valor acelera o upload de um único arquivo grande.

--checkpoint-dir

/path/to/checkpoint

Diretório usado para upload retomável.