Cette rubrique explique comment exécuter la commande appendfromfile pour ajouter du contenu à un objet de type « appendable » dans Object Storage Service (OSS).
Notes d'utilisation
Pour effectuer un chargement par ajout, vous devez disposer des autorisations
oss:GetObjectetoss:PutObject. Pour plus d'informations, consultez la section Accorder une stratégie personnalisée.À partir de la version 1.6.16 d'ossutil, utilisez directement
ossutilcomme nom binaire dans la ligne de commande. Il n'est pas nécessaire d'adapter le nom binaire en fonction du système d'exploitation. Pour les versions antérieures à 1.6.16, adaptez le nom binaire selon votre système d'exploitation. Pour plus d'informations, consultez le guide Prise en main rapide de l'outil de ligne de commande ossutil.
Pour en savoir plus sur les chargements par ajout, consultez la rubrique Chargement par ajout.
Syntaxe de la commande
ossutil appendfromfile localfilename oss://bucketname/objectname
[--meta <value>]Le tableau suivant décrit les paramètres et options mentionnés ci-dessus.
|
Paramètre/Option |
Description |
|
localfilename |
Le chemin d'accès complet au fichier local que vous souhaitez charger. |
|
bucketname |
Le nom du bucket contenant l'objet auquel vous souhaitez ajouter du contenu. |
|
objectname |
Le nom de l'objet auquel vous souhaitez ajouter du contenu. Lors de l'exécution de la commande appendfromfile pour un chargement par ajout, vous pouvez conserver le nom d'origine du fichier local pour l'objet ou spécifier un autre nom. |
|
--meta |
Une fois les métadonnées configurées pour l'objet, vous pouvez exécuter la commande set-meta (Gérer les métadonnées des objets) pour modifier les métadonnées de l'objet. |
Exemples
Dans les exemples suivants, la commande appendfromfile est d'abord utilisée pour charger un fichier local nommé exampleobject.txt situé dans le répertoire racine vers le bucket examplebucket, en le stockant sous le nom d'objet exampleobject.txt. Ensuite, la commande appendfromfile sert à ajouter du contenu à l'objet exampleobject.txt.
-
Exécutez la commande suivante pour charger exampleobject.txt et définir la liste de contrôle d'accès (ACL) de l'objet chargé sur « private » :
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt --meta "x-oss-object-acl:private"La sortie d'exemple suivante indique que le fichier local a été chargé dans le bucket et stocké en tant qu'objet exampleobject.txt. La taille de l'objet exampleobject.txt est de 5 octets.
total append 5(100.00%) byte,speed is 0.00(KB/s) local file size is 5,the object new size is 5,average speed is 0.04(KB/s) -
Exécutez la commande suivante pour ajouter le contenu d'un fichier nommé dest.txt à exampleobject.txt.
Si vous souhaitez ajouter davantage de contenu à exampleobject.txt, remplacez dest.txt par le nom du fichier dont vous souhaitez ajouter le contenu à exampleobject.txt :
ossutil appendfromfile dest.txt oss://examplebucket/exampleobject.txtLa sortie d'exemple suivante indique que du contenu a été ajouté à exampleobject.txt et que la taille de l'objet après l'opération de chargement par ajout est de 150 octets.
total append 150(100.00%) byte,speed is 0.00(KB/s) local file size is 150,the object new size is 150,average speed is 1.19(KB/s)
Options courantes
Pour accéder à un bucket situé dans une autre région, utilisez -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez -i pour l'AccessKey ID et -k pour l'AccessKey Secret.
Par exemple, exécutez la commande suivante pour charger le fichier exampleobject.txt par ajout dans le bucket examplebucket, situé dans la région Chine (Shanghai) et appartenant à un autre compte Alibaba Cloud :
ossutil appendfromfile exampleobject.txt oss://examplebucket/exampleobject.txt -e shanghai.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret