Object Storage Service:cp (upload de arquivos)

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 para o objeto. Valores válidos:

• private: privado.

• public-read: leitura pública.

• public-read-write: leitura e gravação 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 é 1.024 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 upload, download ou cópia multipart de arquivos grandes. Valor padrão: 104857600.

--cache-control

string

Especifica o comportamento de cache quando o objeto é baixado por um navegador da web.

--content-disposition

string

Especifica como o objeto é exibido.

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

• Quando nenhum caminho de diretório de checkpoint é especificado, o upload resumível fica desativado.

• Ao especificar um diretório, o upload resumível é ativado e os arquivos de checkpoint são salvos no subdiretório .ossutil_checkpoint dentro do caminho especificado.

-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 nomes de arquivos de entrada. Valor válido: url.

--end-with

string

Retorna objetos que precedem ou correspondem 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 de expiração absoluto 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 linhas de comentário. 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 simultâneas. Valor padrão: 3.

--listObjects

/

Usa a API ListObjects para listar objetos.

--max-size

SizeSuffix

Tamanho máximo de arquivo a 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 chave=valor.

--metadata-directive

string

Especifica como definir os 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

Faz upload apenas de arquivos modificados antes do intervalo de tempo especificado. A unidade padrão é segundos. Você pode usar sufixos como h (horas). Exemplo: 1h significa 1 hora.

--max-age

Duration

Faz upload apenas de arquivos modificados dentro do intervalo de tempo especificado. A unidade padrão é segundos. Você pode usar sufixos como h (horas). Exemplo: 1h significa 1 hora.

--min-mtime

Time

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

--max-mtime

Time

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

--min-size

SizeSuffix

Tamanho mínimo de arquivo a 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: 1.000. Intervalo válido: 1 a 1.000.

--parallel

int

Número de tarefas simultâneas 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 adequado com base no tamanho do arquivo. Intervalo válido: 100 KiB a 5 GiB.

-r, --recursive

/

Realiza 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 solicitação. Defina este parâmetro se o bucket usar o modo de pagamento por solicitante. Valor válido: requester.

--size-only

/

Faz upload apenas dos arquivos de origem cujo tamanho difere dos arquivos de destino.

--storage-class

string

Classe de armazenamento do objeto. Valores válidos:

• Standard: armazenamento Standard.

• IA: armazenamento de acesso infrequente.

• Archive: armazenamento Archive.

• ColdArchive: armazenamento Cold Archive.

• DeepColdArchive: armazenamento Deep Cold Archive.

--tagging

strings

Tags para o objeto, no formato chave=valor.

--tagging-directive

string

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

• COPY

• REPLACE

-u, --update

/

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

--ignore-existing

/

Ignora arquivos que já existem no destino.