Télécharge un objet vers un compartiment.
Remarques d'utilisation
La taille de l'objet à télécharger ne doit pas dépasser 5 Go.
Par défaut, si un objet portant le même nom existe et que vous disposez des autorisations d'accès nécessaires, le nouvel objet l'écrase.
Autorisations
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 politiques RAM ou une stratégie de compartiment.
|
API |
Action |
Description |
|
PutObject |
|
Télécharge un objet. |
|
|
Requis si vous spécifiez des tags d'objet à l'aide de l'en-tête |
|
|
|
Requis si l'en-tête |
|
|
|
Syntaxe de la commande
ossutil api put-object --bucket value --key value [flags]|
Paramètre |
Type |
Description |
|
--body |
string |
Le corps de la requête. |
|
--bucket |
string |
Le nom du compartiment. |
|
--cache-control |
string |
Le comportement de mise en cache de l'objet. |
|
--content-disposition |
string |
Le nom de fichier de téléchargement de l'objet. |
|
--content-encoding |
string |
Le format d'encodage du contenu de l'objet. |
|
--expires |
string |
L'heure d'expiration. |
|
--forbid-overwrite |
boolean |
Indique s'il faut interdire l'écrasement d'un objet portant le même nom. |
|
--key |
string |
Le chemin complet de l'objet. |
|
--metadata |
stringArray |
Les métadonnées de l'objet. Utilisez des paramètres préfixés par x-oss-meta-* pour les métadonnées personnalisées. |
|
--object-acl |
string |
La liste de contrôle d'accès (ACL) de l'objet. |
|
--server-side-data-encryption |
string |
L'algorithme de chiffrement côté serveur pour l'objet. |
|
--server-side-encryption |
string |
La méthode de chiffrement côté serveur. |
|
--server-side-encryption-key-id |
string |
L'ID de la clé maître cliente (CMK) gérée par KMS. |
|
--storage-class |
string |
La classe de stockage de l'objet. |
|
--tagging |
string |
Les tags de l'objet. Spécifiez plusieurs tags au format TagA=A&TagB=B. |
La commande put-object correspond à l'opération d'API PutObject. Pour plus d'informations sur les paramètres de l'opération PutObject, consultez PutObject.
Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez Options de ligne de commande globales.
Exemples
-
Téléchargez un objet à partir d'une chaîne.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" -
Téléchargez un objet à partir d'un fichier local.
ossutil api put-object --bucket examplebucket --key exampleobject --body file://uploadFile -
Téléchargez une chaîne avec des métadonnées personnalisées.
ossutil api put-object --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com --body "hi oss" -
Téléchargez une chaîne avec des tags.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --tagging "TagA=A&TagB=B" -
Téléchargez une chaîne avec une ACL et une classe de stockage spécifiées.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --object-acl private --storage-class IA -
Téléchargez une chaîne avec un chiffrement côté serveur.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac**** -
Téléchargez une chaîne sans écraser un objet portant le même nom.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --forbid-overwrite true -
Téléchargez une chaîne avec des paramètres de contrôle du cache.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --cache-control no-cache -
Téléchargez une chaîne avec un nom de fichier de téléchargement personnalisé.
ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"