Object Storage Service:cp (Baixar objetos)

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 com a opção --version-id.

kms:GenerateDataKey

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

kms:Decrypt

oss:ListObjects

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

Parâmetro

Descrição

cloud_url

Caminho de origem do objeto no OSS. O formato é oss://bucket[/prefix]. Exemplo: oss://examplebucket/examplefile.txt.

file_url

Caminho de destino do arquivo local. Se o destino for um diretório, o caminho deve terminar com um separador (/ ou \). Exemplo: um caminho Linux é /localfolder/examplefile.txt e um caminho 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 aplica-se apenas ao objeto único indicado.

-f --force

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

-u，--update

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

Velocidade máxima de download em KB/s. O valor padrão é 0, que indica ausência de limite de velocidade.

--disable-ignore-error

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

--only-current-dir

Baixa apenas os objetos do diretório atual e ignora subdiretórios e seu conteúdo.

--bigfile-threshold

Limiar de tamanho em bytes para ativar o download retomável.

Padrão: 100 MB

Intervalo de valores: 0 a 9223372036854775807

--part-size

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

Intervalo de valores: 1 a 9223372036854775807

--checkpoint-dir

Diretório onde o ossutil armazena informações de checkpoint para downloads retomáveis. Se um download retomável falhar, o ossutil cria um diretório .ossutil_checkpoint para registrar as informações de checkpoint. O ossutil exclui esse diretório após a conclusão bem-sucedida do download. Certifique-se de que o diretório especificado possa ser excluído.

--range

Baixa um intervalo específico de bytes do objeto e salva-o como um novo arquivo. A numeração dos bytes começa em zero.

• Especificar um intervalo

  Exemplo: 3-9 baixa os bytes do 3º ao 9º byte, inclusive.

• Especificar uma posição inicial

  Exemplo: 3- baixa do 3º byte até o final do objeto, inclusive.

• Especificar uma posição final

  Exemplo: -9 baixa do byte 0 até o 9º byte, inclusive.

--encoding-type

Tipo de codificação do nome do objeto. Defina esta opção como url. Se não 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 opções include e exclude.

--exclude

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

Para mais informações, consulte opções include e exclude.

--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 (Gerenciar metadados de objetos).

--acl

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 escrita. Outros usuários não podem acessar os objetos no bucket.

• public-read: Apenas o proprietário do bucket tem permissão de escrita. Todos os outros usuários, incluindo anônimos, têm permissão somente de leitura nos objetos do bucket. Isso pode causar vazamento 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. Essa configuração pode resultar em vazamento de dados, custos elevados e possíveis responsabilidades legais caso conteúdo malicioso seja enviado. Exceto para casos de uso específicos, não configure permissões públicas de leitura e escrita.

--snapshot-path

Diretório onde as informações de snapshot são salvas durante o download. No próximo download, o ossutil lê essas informações desse diretório para executar 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

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 segue o formato Partition number:Total partitions. Exemplo: 1:5 indica que este comando do ossutil baixará a partição 1 de um total de 5 partições. A numeração das partições começa 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 múltiplos comandos do ossutil. Cada comando baixa sua partição atribuída.

-j，--job

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

--parallel

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 buckets que tenham versionamento ativado. Para ativar o versionamento de um bucket, consulte bucket-versioning (Versionamento).

--start-time

Timestamp UNIX. Ao especificar esta opção, objetos com hora de última modificação anterior a este timestamp são ignorados.

--end-time

Timestamp UNIX. Ao especificar esta opção, objetos com hora de última modificação posterior a este timestamp são ignorados.