upload-part-copy - Object Storage Service: Central de Documentação do Alibaba Cloud

Esta operação faz upload de uma parte ao copiar dados de um objeto existente.

Observações de uso

Para copiar um objeto maior que 1 GB, use o comando upload-part-copy. Para copiar um objeto menor que 1 GB em uma única operação, consulte copy-object.
O bucket de origem e o bucket de destino devem estar na mesma região.
Antes de fazer upload de uma parte com esta operação, chame primeiro o comando initiate-multipart-upload para obter um ID de upload.

Permissões

Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.

API	Action	Descrição
UploadPartCopy	`oss:GetObject`	Lê dados do objeto de source durante o upload de uma parte por cópia de um objeto existente.
	`oss:PutObject`	Grava dados no objeto de destino durante o upload de uma parte por cópia de um objeto existente.
	`oss:GetObjectVersion`	Necessária para ler a versão especificada do objeto de source quando você define a versão do objeto via versionId no upload por cópia.

Sintaxe

ossutil api upload-part-copy --bucket value --key value --copy-source value --part-number value --upload-id value [flags]

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket de destino.
--key	string	Caminho completo do objeto de destino.
--copy-source	string	Endereço de source da operação de cópia (é necessária permissão de leitura na source), no formato `bucket/UrIEncode(key)`, em que o nome do objeto de source deve ter codificação URL.
--copy-source-if-match	string	Copia a parte apenas se o ETag do objeto de source corresponder ao ETag especificado. Caso contrário, retorna o erro 412 Precondition Failed.
--copy-source-if-modified-since	string	Copia a parte somente se o objeto de source tiver sido modificado após o horário indicado. Caso contrário, retorna o erro 304 Not Modified.
--copy-source-if-none-match	string	Copia a parte apenas se o ETag do objeto de source for diferente do ETag especificado. Caso contrário, retorna o erro 304 Not Modified.
--copy-source-if-unmodified-since	string	Copia a parte somente se o objeto de source não tiver sido modificado desde o horário especificado. Caso contrário, retorna o erro 412 Precondition Failed.
--copy-source-range	string	Intervalo de bytes do objeto de source a ser copiado.
--part-number	string	Número da parte, que deve ser exclusivo para cada parte no upload multipart.
--upload-id	string	ID do upload multipart.

Nota

O comando upload-part-copy encapsula a operação da API UploadPartCopy. Para mais detalhes sobre os parâmetros da API, consulte a documentação UploadPartCopy.
Para saber mais sobre as opções globais de linha de comando compatíveis, consulte Opções globais de linha de comando.

Exemplos

Faça upload de uma parte copiando dados da versão atual de srcobject no bucket srcbucket.

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1

Faça upload de uma parte por cópia e formate a saída como JSON.

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format json

Faça upload de uma parte copiando dados e formate a saída como YAML.

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --output-format yaml

Copie um intervalo específico de bytes (0 a 9) do objeto de source para fazer upload da parte.

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-range bytes=0-9

Faça upload da parte por cópia apenas se o ETag do objeto de source srcobject corresponder a 123.

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-match 123

Faça upload por cópia somente se o objeto de source srcobject não tiver sido modificado desde "Mon, 11 May 2020 08:16:23 GMT".

ossutil api upload-part-copy --bucket examplebucket --key exampleobject --copy-source /srcbucket/srcobject --upload-id 123 --part-number 1 --copy-source-if-unmodified-since "Mon, 11 May 2020 08:16:23 GMT"