Tous les produits
Search
Centre de documentation

Object Storage Service:listpart

Dernière mise à jour :Aug 18, 2026

Cette rubrique explique comment exécuter la commande listpart afin de répertorier les parties d'un objet dont le chargement en plusieurs parties est incomplet.

Notes d'utilisation

  • Pour répertorier les parties, vous devez disposer de l'autorisation oss:ListParts. Pour plus d'informations, consultez la section Accorder une stratégie personnalisée.

  • À partir de la version 1.6.16 d'ossutil, vous pouvez utiliser directement ossutil comme 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, vous devez ajuster le nom binaire selon votre système d'exploitation. Pour plus d'informations, consultez la section Démarrage rapide de l'outil de ligne de commande ossutil.

  • Pour en savoir plus sur les chargements en plusieurs parties, consultez la section Chargement en plusieurs parties.

Syntaxe de la commande

ossutil listpart oss://bucketname/objectname uploadid

Le tableau suivant décrit les paramètres mentionnés ci-dessus.

Paramètre

Description

bucketname

Nom du bucket contenant les parties que vous souhaitez répertorier.

objectname

Nom de l'objet dont le chargement en plusieurs parties est incomplet.

uploadid

ID de chargement identifiant la tâche de chargement en plusieurs parties. Cet ID est renvoyé lors du lancement de la tâche. Vous pouvez l'utiliser pour gérer le chargement en plusieurs parties, par exemple pour annuler ou consulter la tâche.

Important

Vous pouvez utiliser l'option -m avec la commande ls pour obtenir des informations sur les parties, telles que l'objet dont le chargement en plusieurs parties n'est pas terminé, l'heure de lancement de la tâche et l'ID de chargement. Pour plus d'informations, consultez la section ls.

Exemples

Exécutez la commande suivante pour répertorier les parties de l'objet exampleobject.txt dont le chargement en plusieurs parties est incomplet dans le bucket examplebucket :

ossutil listpart oss://examplebucket/exampleobject.txt 89A46B10E94A4ED5A7E9869F9409****

La sortie suivante illustre un exemple d'informations sur les parties, incluant le nombre de parties, les ETags et la taille des parties.

PartNumber      Etag                                    Size(Byte)      LastModifyTime
2               "BD106FED29B349A635BE289746DB****"      4443891         2021-07-21 09:01:33
3               "25DA5C7BB933DBD732B6C11111EB****"      4443891         2021-07-21 09:01:31
4               "AFDA91A8D4F476BAC972306873A3****"      4443891         2021-07-21 09:01:31
11              "2FFEE8D5049AB059D7EC801927BB****"      4443891         2021-07-21 09:01:32

total part count:4      total part size(MB):16.95

0.101978(s) elapsed

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e afin de spécifier le endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, indiquez l'AccessKey ID avec l'option -i et l'AccessKey Secret avec l'option -k.

Par exemple, exécutez la commande suivante pour interroger les parties de l'objet testobject.txt dont le chargement en plusieurs parties est incomplet. L'objet testobject.txt se trouve dans le bucket testbucket, situé dans la région Chine (Hangzhou) et appartenant à un autre compte Alibaba Cloud.

ossutil listpart oss://testbucket/testobject.txt 46C56B10E94A4ED6G8U9869F9409**** -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.