Tous les produits
Search
Centre de documentation

Object Storage Service:list-parts

Dernière mise à jour :Sep 22, 2026

La commande list-parts répertorie tous les composants (parts) téléchargés associés à un ID de chargement spécifique.

Remarques d'utilisation

  • Object Storage Service (OSS) trie les résultats renvoyés par ordre croissant des numéros de composant.

  • Des erreurs peuvent survenir lors de la transmission réseau. N'utilisez pas les numéros de composant ni les valeurs ETag figurant dans les résultats de l'opération ListParts pour générer la liste des composants téléchargés.

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 Bucket Policy.

API

Action

Description

ListParts

oss:ListParts

Répertorie tous les composants téléchargés à l'aide d'un ID de chargement.

Syntaxe de la commande

ossutil api list-parts --bucket value --key value --upload-id value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--key

string

Chemin complet de l'objet.

--encoding-type

string

Type d'encodage du nom de l'objet dans la réponse.

--max-parts

int

Nombre maximal de composants dans la réponse d'OSS.

--part-number-marker

int

Position à partir de laquelle commence la liste. Tous les composants dont le numéro est supérieur à la valeur de ce paramètre sont répertoriés.

--upload-id

string

ID de la tâche de chargement en plusieurs parties.

Remarque
  • La commande list-parts correspond à l'opération ListParts. Pour plus d'informations sur les paramètres de l'opération ListParts, consultez la rubrique ListParts.

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

Exemples

  • Répertoriez tous les composants téléchargés dans le bucket examplebucket dont le nom est exampleobject et dont l'ID de chargement est 123.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123
  • Répertoriez tous les composants téléchargés dans le bucket examplebucket dont le nom est exampleobject et dont l'ID de chargement est 123, puis affichez la sortie au format JSON.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format json
  • Répertoriez tous les composants téléchargés dans le bucket examplebucket dont le nom est exampleobject et dont l'ID de chargement est 123, puis affichez la sortie au format YAML.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --output-format yaml
  • Répertoriez les 100 premiers composants du bucket examplebucket.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --max-parts 100
  • Répertoriez tous les composants du bucket examplebucket et encodez les noms des objets renvoyés au format URL.

    ossutil api list-parts --bucket examplebucket --key exampleobject --upload-id 123 --encoding-type url