upload-part-copy - Object Storage Service - Centre de documentation Alibaba Cloud

Cette opération télécharge une partie en copiant les données d'un objet existant.

Notes d'utilisation

Pour copier un objet de plus de 1 Go, utilisez la commande upload-part-copy. Pour copier un objet de moins de 1 Go en une seule opération, consultez la rubrique copy-object.
Le bucket source et le bucket de destination doivent se trouver dans la même région.
Avant de télécharger une partie avec cette opération, appelez la commande initiate-multipart-upload pour obtenir un ID de téléchargement.

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des stratégies RAM ou une Bucket Policy.

API	Action	Description
UploadPartCopy	`oss:GetObject`	Lit les données de l'objet source lors du téléchargement d'une partie par copie depuis un objet existant.
	`oss:PutObject`	Écrit les données dans l'objet de destination lors du téléchargement d'une partie par copie depuis un objet existant.
	`oss:GetObjectVersion`	Lors du téléchargement d'une partie par copie depuis un objet existant, si vous spécifiez la version de l'objet via versionId, cette autorisation est requise pour lire la version spécifiée de l'objet source.

Syntaxe

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

Paramètre

Type

Description

--bucket

string

Nom du bucket de destination.

--key

string

Chemin complet de l'objet de destination.

--copy-source

string

Adresse source pour l'opération de copie (vous devez disposer d'une autorisation de lecture sur la source). Le format est bucket/UrIEncode(key), où le nom de l'objet source doit être encodé en URL.

--copy-source-if-match

string

Copie la partie uniquement si l'ETag de l'objet source correspond à l'ETag spécifié. Sinon, une erreur 412 Precondition Failed est renvoyée.

--copy-source-if-modified-since

string

Copie la partie uniquement si l'objet source a été modifié depuis l'heure spécifiée. Sinon, une erreur 304 Not Modified est renvoyée.

--copy-source-if-none-match

string

Copie la partie uniquement si l'ETag de l'objet source ne correspond pas à l'ETag spécifié. Sinon, une erreur 304 Not Modified est renvoyée.

--copy-source-if-unmodified-since

string

Copie la partie uniquement si l'objet source n'a pas été modifié depuis l'heure spécifiée. Sinon, une erreur 412 Precondition Failed est renvoyée.

--copy-source-range

string

Plage d'octets de l'objet source à copier.

--part-number

string

Numéro de la partie, qui doit être unique pour chaque partie du téléchargement multipartie.

--upload-id

string

ID de téléchargement pour le téléchargement multipartie.

Remarque

La commande upload-part-copy encapsule l'opération API UploadPartCopy. Pour plus de détails sur les paramètres de l'API, consultez la documentation relative à UploadPartCopy.
Pour en savoir plus sur les options de ligne de commande globales prises en charge, consultez la section Global command-line options.

Exemples

Téléchargez une partie en copiant les données de la version actuelle de srcobject dans le bucket srcbucket.

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

Téléchargez une partie en copiant les données et formatez la sortie au format JSON.

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

Téléchargez une partie en copiant les données et formatez la sortie au format YAML.

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

Téléchargez une partie en copiant une plage d'octets spécifique (0 à 9) depuis l'objet source.

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

Téléchargez une partie en copiant les données uniquement si l'ETag de l'objet source srcobject correspond à 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

Téléchargez une partie en copiant les données uniquement si l'objet source srcobject n'a pas été modifié depuis "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"