initiate-multipart-upload - Object Storage Service - Centre de documentation Alibaba Cloud

La commande initiate-multipart-upload lance une tâche de chargement en plusieurs parties.

Notes d'utilisation

Lorsque vous exécutez la commande initiate-multipart-upload, Object Storage Service (OSS) crée et renvoie un ID de chargement globalement unique pour identifier la tâche de chargement en plusieurs parties. Vous pouvez utiliser cet ID pour effectuer des opérations connexes, telles que l'abandon ou la requête du chargement en plusieurs parties.
L'envoi d'une demande d'initialisation de chargement en plusieurs parties n'affecte pas un objet existant portant le même nom.

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 les politiques RAM ou la politique de bucket.

API	Action	Description
InitiateMultipartUpload	`oss:PutObject`	Initialise les tâches de chargement en plusieurs parties.
	`oss:PutObjectTagging`	Lors de l'initialisation d'une tâche de chargement en plusieurs parties, si vous spécifiez des tags d'objet via x-oss-tagging, cette autorisation est requise.
	`kms:GenerateDataKey`	Lors du chargement d'un objet, si les métadonnées de l'objet contiennent X-Oss-Server-Side-Encryption: KMS, ces deux autorisations sont requises.
	`kms:Decrypt`

Syntaxe de la commande

ossutil api initiate-multipart-upload --bucket value --key value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--key

string

Chemin complet de l'objet.

--encoding-type

string

Spécifie l'encodage du contenu renvoyé.

--content-encoding

string

Format d'encodage du contenu de l'objet lors du téléchargement.

--content-type

string

Type de contenu de l'objet.

--content-disposition

string

Nom de l'objet lors du téléchargement.

--cache-control

string

Comportement de mise en cache de la page web lors du téléchargement de l'objet.

--metadata

stringArray

Métadonnées utilisateur de l'objet au format clé=valeur. Pour spécifier des métadonnées personnalisées, vous devez configurer des paramètres préfixés par x-oss-meta-*.

--server-side-data-encryption

string

Algorithme de chiffrement de l'objet.

--server-side-encryption

string

Méthode de chiffrement côté serveur utilisée pour chiffrer chaque partie de l'objet que vous souhaitez charger.

--server-side-encryption-key-id

string

ID de la clé maître cliente (CMK) gérée par Key Management Service (KMS).

--storage-class

string

Classe de stockage de l'objet.

--tagging

string

Tags de l'objet.

--expires

string

Délai d'expiration en millisecondes.

--forbid-overwrite

string

Indique s'il faut écraser un objet portant le même nom lors de l'appel de l'opération CompleteMultipartUpload.

Remarque

La commande initiate-multipart-upload correspond à l'opération API InitiateMultipartUpload. Pour plus d'informations sur les paramètres de l'opération API, consultez InitiateMultipartUpload.
Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez Options de ligne de commande globales prises en charge.

Exemples

Lancez une tâche de chargement en plusieurs parties.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject

Lancez une tâche de chargement en plusieurs parties et affichez le résultat au format JSON.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json

Lancez une tâche de chargement en plusieurs parties et affichez le résultat au format YAML.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml

Lancez une tâche de chargement en plusieurs parties et spécifiez des métadonnées personnalisées.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com

Lancez une tâche de chargement en plusieurs parties et spécifiez des tags d'objet.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"

Lancez une tâche de chargement en plusieurs parties et spécifiez la méthode de chiffrement côté serveur pour l'objet.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****

Lancez une tâche de chargement en plusieurs parties et empêchez l'écrasement d'un objet portant le même nom.
```
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true
```
Lancez une tâche de chargement en plusieurs parties et spécifiez le comportement de mise en cache de la page web lors du téléchargement de l'objet.
```
ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach
```

Lancez une tâche de chargement en plusieurs parties et spécifiez le nom de l'objet lors de son téléchargement.

ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"