Tous les produits
Search

Ce produit

    Object Storage Service:list-objects (get-bucket)

    Centre de documentation

    Object Storage Service:list-objects (get-bucket)

    Dernière mise à jour :Aug 18, 2026

    Répertorie tous les objets d'un compartiment Object Storage Service (OSS) spécifié.

    Notes d'utilisation

    • Par défaut, un compte Alibaba Cloud est autorisé à répertorier tous les objets d'un compartiment. Pour effectuer cette opération avec un utilisateur RAM ou via le Security Token Service (STS), vous devez disposer de l'autorisation oss:ListObjects. Pour plus d'informations, consultez la rubrique Grant a custom policy.

    • La commande list-objects (get-bucket) a évolué vers une version plus récente : list-objects-v2 (get-bucket-v2). Nous vous recommandons d'utiliser list-objects-v2 (get-bucket-v2) pour le développement de vos applications. OSS conserve la prise en charge de la commande list-objects (get-bucket) afin d'assurer la rétrocompatibilité.

    • La commande list-objects (get-bucket) ne renvoie pas les métadonnées utilisateur des objets.

    Syntaxe de la commande

    ossutil api list-objects --bucket value [flags]

    Paramètre

    Type

    Description

    --bucket

    string

    Nom du compartiment.

    --delimiter

    string

    Caractère utilisé pour regrouper les objets par nom.

    --encoding-type

    string

    Type d'encodage des noms d'objets dans la réponse.

    --marker

    string

    Nom de l'objet à partir duquel l'opération list-objects commence. Si ce paramètre est spécifié, seuls les objets dont le nom suit alphabétiquement la valeur de marker sont renvoyés.

    --max-keys

    int

    Nombre maximal d'objets à renvoyer.

    --prefix

    string

    Préfixe que les noms des objets renvoyés doivent contenir.
    Remarque

    • La commande list-objects équivaut à l'opération API GetBucket (ListObjects). Pour plus de détails sur cette opération API, consultez la rubrique GetBucket (ListObjects).

    • Pour obtenir la liste des options de ligne de commande globales prises en charge, reportez-vous à la section Command-line options.

    Exemples

    Répertorie tous les objets du compartiment nommé examplebucket.

    ossutil api list-objects --bucket examplebucket

    Répertorie tous les objets du compartiment nommé examplebucket et formate la sortie en JSON.

    ossutil api list-objects --bucket examplebucket --output-format json

    Répertorie tous les objets du compartiment nommé examplebucket et formate la sortie en YAML.

    ossutil api list-objects --bucket examplebucket --output-format yaml

    Répertorie tous les objets dont le nom commence par le préfixe dir dans le compartiment nommé examplebucket.

    ossutil api list-objects --bucket examplebucket --prefix dir

    Répertorie les 100 premiers objets dont le nom commence par le préfixe dir dans le compartiment nommé examplebucket.

    ossutil api list-objects --bucket examplebucket --prefix dir --max-keys 100

    Répertorie tous les objets situés dans le répertoire courant du compartiment nommé examplebucket.

    ossutil api list-objects --bucket examplebucket --delimiter /

    Répertorie les objets dont le nom suit alphabétiquement test.txt dans le compartiment nommé examplebucket.

    ossutil api list-objects --bucket examplebucket --marker test.txt

    Répertorie tous les objets du compartiment nommé examplebucket et encode les noms d'objets au format URL dans la réponse.

    ossutil api list-objects --bucket examplebucket --encoding-type url