Object Storage Service:cp (Download objects)

Ação da API

Descrição

oss:GetObject

Necessária para baixar um objeto.

oss:GetObjectVersion

Opcional. Necessária para baixar uma versão específica de um objeto de origem usando a opção --version-id.

kms:GenerateDataKey

Opcional. Necessária se o objeto baixado estiver criptografado no lado do servidor usando o KMS.

kms:Decrypt

oss:ListObjects

Opcional. Necessária para downloads em lote (operações recursivas).

Parâmetro

Descrição

cloud_url

O caminho de origem do objeto do OSS. O formato é oss://bucket[/prefix]. Por exemplo, oss://examplebucket/examplefile.txt.

file_url

O caminho de destino para o arquivo local. Se o destino for um diretório, o caminho deve terminar com um separador (/ ou \). Por exemplo, um caminho no Linux é /localfolder/examplefile.txt e um caminho no Windows é D:\localfolder\examplefile.txt.

-r, --recursive

Aplica a operação recursivamente a todos os objetos correspondentes sob o prefixo especificado. Caso contrário, a operação se aplica apenas ao único objeto especificado.

-f --force

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

-u, --update

Baixa o objeto apenas se o arquivo de destino não existir ou se a hora da última modificação do objeto de origem for posterior à do arquivo de destino.

--maxdownspeed

A velocidade máxima de download em KB/s. O valor padrão é 0, o que significa que não há limite de velocidade.

--disable-ignore-error

Desativa a opção de ignorar erros durante operações em lote.

--only-current-dir

Baixa apenas os objetos no diretório atual e ignora subdiretórios e os objetos dentro deles.

--bigfile-threshold

O limiar de tamanho em bytes para um download retomável.

Padrão: 100 MB

Intervalo de valores: 0 a 9223372036854775807

--part-size

O tamanho da parte em bytes. Por padrão, o ossutil calcula automaticamente um tamanho de parte adequado com base no tamanho do objeto.

Intervalo de valores: 1 a 9223372036854775807

--checkpoint-dir

O diretório onde o ossutil armazena as informações de ponto de verificação para um download retomável. Se um download retomável falhar, o ossutil cria um diretório .ossutil_checkpoint para registrar as informações do ponto de verificação. O ossutil exclui este diretório após o sucesso do download. Certifique-se de que o diretório especificado possa ser excluído.

--range

Baixa um intervalo de bytes especificado do objeto e o salva como um novo arquivo. A numeração de bytes começa em zero.

• Especifique um intervalo

  Por exemplo, 3-9 baixa os bytes do 3º ao 9º byte, inclusive.

• Especifique uma posição inicial

  Por exemplo, 3- baixa do 3º byte até o final do objeto, inclusive.

• Especifique uma posição final

  Por exemplo, -9 baixa do 0º byte ao 9º byte, inclusive.

--encoding-type

O tipo de codificação do nome do objeto. Defina esta opção como url. Se esta opção não for especificada, o nome do objeto não será codificado.

--include

Inclui todos os objetos que correspondem ao padrão especificado.

Para mais informações, consulte include and exclude options.

--exclude

Exclui todos os objetos que correspondem ao padrão especificado.

Para mais informações, consulte include and exclude options.

--meta

Define os metadados do objeto. O formato é header:value#header:value. Exemplo: Cache-Control:no-cache#Content-Encoding:gzip. Para mais informações sobre metadados, consulte set-meta (Manage object metadata).

--acl

A lista de controle de acesso (ACL) do objeto. Valores válidos:

• default (padrão): O objeto herda a ACL do bucket.

• private: Apenas o proprietário do bucket tem permissões de leitura e gravação. Outros usuários não podem acessar os objetos no bucket.

• public-read: Apenas o proprietário do bucket tem permissões de gravação. Todos os outros usuários, incluindo usuários anônimos, têm permissões somente leitura nos objetos do bucket. Isso pode levar a vazamentos de dados e aumento de custos. Use esta ACL com cautela.

• public-read-write: Qualquer pessoa, incluindo usuários anônimos, pode ler e gravar objetos no bucket. Isso pode levar a vazamentos de dados, aumento de custos e possíveis responsabilidades legais se conteúdo malicioso for carregado. Exceto para casos de uso específicos, não configure permissões de leitura e gravação públicas.

--snapshot-path

O diretório onde o ossutil salva as informações de snapshot durante o download. Para o próximo download, o ossutil lê as informações de snapshot deste diretório para realizar um download incremental.

--disable-crc64

Desativa a verificação de redundância cíclica de 64 bits (CRC-64). Por padrão, o ossutil ativa o CRC-64 para todas as transferências de dados.

--payer

O método de pagamento da solicitação. Para que o solicitante pague pelo tráfego e pelas solicitações geradas ao acessar o caminho especificado, defina esta opção como requester.

--partition-download

Especifica uma partição do objeto a ser baixada. O valor está no formato Partition number:Total partitions. Por exemplo, 1:5 indica que este comando ossutil baixa a partição 1 de um total de 5 partições. Os números das partições começam em 1. O algoritmo interno da ferramenta determina como o ossutil particiona o objeto. Esta opção permite dividir um objeto em várias partições e baixá-las em paralelo usando vários comandos ossutil. Cada comando baixa sua partição atribuída.

-j, --job

O número de tarefas simultâneas para operações com múltiplos objetos. Padrão: 3. Intervalo de valores: 1 a 10.000.

--parallel

O número de tarefas simultâneas para operações com um único objeto. Intervalo de valores: 1 a 10.000. Se esta opção não for definida, o ossutil determina o valor com base no tipo de operação e no tamanho do objeto.

--version-id

Baixa uma versão específica de um objeto. Use a opção --version-id apenas com um bucket com versionamento ativado. Para ativar o versionamento de um bucket, consulte bucket-versioning (Versioning).

--start-time

Um carimbo de data e hora UNIX. Se você especificar esta opção, os objetos com hora da última modificação anterior a este carimbo serão ignorados.

--end-time

Um carimbo de data e hora UNIX. Se você especificar esta opção, os objetos com hora da última modificação posterior a este carimbo serão ignorados.