Tous les produits
Search

Ce produit

    Object Storage Service:append-object

    Centre de documentation

    Object Storage Service:append-object

    Dernière mise à jour :Aug 18, 2026

    Téléverse un objet en ajoutant des données de manière incrémentielle.

    Remarques d'utilisation

    • La taille finale de l'objet créé par la commande append-object ne doit pas dépasser 5 Go.

    • La commande append-object ne prend pas en charge le chiffrement côté serveur avec Key Management Service (KMS) utilisant un ID de clé maître client (CMK) spécifié.

    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

    AppendObject

    oss:PutObject

    Appelez cette opération pour téléverser un objet en l'ajoutant à un objet existant.

    oss:PutObjectTagging

    Lors du téléversement d'un objet en l'ajoutant à un objet existant, si vous spécifiez des tags d'objet via x-oss-tagging, cette autorisation est requise.

    Syntaxe de la commande

    ossutil api append-object --bucket value --key value --position value [flags]

    Paramètre

    Type

    Description

    --body

    string

    Le corps de la requête.

    --bucket

    string

    Le nom du bucket.

    --cache-control

    string

    Le comportement de mise en cache de l'objet.

    --content-disposition

    string

    Le nom d'affichage de l'objet lors du téléchargement.

    --content-encoding

    string

    Le format d'encodage de l'objet.

    --content-md5

    string

    Le hachage MD5 du contenu de l'objet, utilisé pour vérifier l'intégrité des données.

    --expires

    string

    L'heure d'expiration.

    --key

    string

    Le chemin complet de l'objet.

    --metadata

    stringArray

    Les métadonnées de l'objet. Spécifiez des métadonnées personnalisées avec des paramètres préfixés par x-oss-meta-*.

    --object-acl

    string

    La liste de contrôle d'accès (ACL) de l'objet.

    --position

    string

    La position à partir de laquelle commencer l'ajout des données, en octets.

    --server-side-encryption

    string

    La méthode de chiffrement côté serveur.

    --storage-class

    string

    La classe de stockage de l'objet.

    --tagging

    string

    Les tags de l'objet. Vous pouvez spécifier plusieurs tags. Exemple : TagA=A&TagB=B.
    Remarque

    • La commande append-object correspond à l'opération API AppendObject. Pour plus d'informations sur les paramètres de l'opération API, consultez AppendObject.

    • Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez Options de ligne de commande globales.

    Exemples

    • Ajoutez une chaîne à l'objet exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss"

    • Ajoutez des données depuis un fichier à l'objet exampleobject.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body file://appendFile

    • Ajoutez une chaîne à l'objet exampleobject avec des métadonnées personnalisées.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • Ajoutez une chaîne à l'objet exampleobject avec des tags d'objet.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --tagging "TagA=A&TagB=B"

    • Ajoutez une chaîne à l'objet exampleobject et définissez l'ACL ainsi que la classe de stockage.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --object-acl private --storage-class IA

    • Ajoutez une chaîne à l'objet exampleobject avec un chiffrement côté serveur.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --body "hi oss" --server-side-encryption AES256

    • Ajoutez une chaîne et définissez le comportement de cache-control pour l'objet.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --cache-control no-cache

    • Ajoutez une chaîne et définissez le nom de fichier de téléchargement pour l'objet.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"

    • Ajoutez une chaîne à l'objet exampleobject avec une vérification d'intégrité Content-MD5.

      ossutil api append-object --bucket examplebucket --key exampleobject --position 0 --body "hi oss" --content-md5 ohhnqLBJFiKkPSBO1eNaUA==