Lister les objets d’un bucket

Vous pouvez lister les objets contenus dans vos buckets, ou dans les buckets pour lesquels vous avez les permissions appropriées. Pour en savoir plus, voir Configurer l’ACL d’un objet.

Cette action renvoie également des informations à propos de la date et de l’heure à laquelle vous avez déposé ou copié un objet sur votre bucket.

Si vous avez organisé une architecture virtuelle dans votre bucket en utilisant les clés des objets, vous pouvez retrouver les ressources que vous avez nommées avec un format xxx/yyy en utilisant les attributs prefix et delimiter. Pour en savoir plus, voir À propos d’OOS > Objets.

Lister les objets d’un bucket avec AWS CLI (s3api)

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Cette page présentait précédemment la commande list-objects, qui a été dépréciée au profit de la commande plus récente list-objects-v2. La commande list-objects est toujours opérationnelle mais possède moins de fonctionnalités que la nouvelle commande.

Pour lister les objets contenus dans un bucket, utilisez la commande list-objects-v2 en suivant cette syntaxe :

Exemple de requête
$ aws s3api list-objects-v2 \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --prefix "bank-data/2023/" \
    --delimiter "/" \
    --encoding-type url \
    --fetch-owner \
    --start-after NOT_SPECIFIED \
    --page-size 100 \
    --max-items 500 \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • bucket : Le nom du bucket pour lequel vous voulez la liste des objets.

  • (optionnel) prefix : Une lettre ou une chaîne de caractères pour filtrer vos objets. Cet attribut renvoie les objets qui commencent avec la lettre ou la chaîne de caractères que vous spécifiez.

    Si vous spécifiez un préfixe, les objets ne commençant pas par le préfixe spécifié seront entièrement exclus du résultat.

  • (optionnel) delimiter : Un caractère ou un groupe de caractères pour filtrer vos objets en les excluant de la liste renvoyée si le délimiteur apparaît dans leur nom de clé. Cet attribut est utile pour les systèmes de nommage hiérarchiques.

  • (optionnel) encoding-type : Spécifie le format d’encodage des noms de clés d’objets (toujours url).

  • (optionnel) fetch-owner ou no-fetch-owner : Indique si vous souhaitez récupérer les informations sur le propriétaire des objets. S’il n’est pas inclus, le propriétaire n’est pas renvoyé.

  • (optionnel) start-after : Filtre la liste des objets de votre bucket en n’affichant que les objets venant après la clé que vous avez spécifiée, dans l’ordre alphabétique.

  • (optionnel) page-size : Détermine le nombre de requêtes effectuées lors d’un appel. Une taille de page plus petite augmente le nombre d’appels mais aide à éviter les dépassements de délai en récupérant moins d’éléments à chaque requête. Par exemple, si vous avez un bucket de 120 objets et que vous fixez la taille de la page à 10, la CLI devra effectuer 12 requêtes pour récupérer tous les objets. Si vous fixez la taille de la page à 60, seulement 2 requêtes seront nécessaires.

    • La valeur par défaut est 1000.

    • Les valeurs minimales et maximales sont 1 and 1000.

  • (optionnel) max-items : Le nombre maximum d’objets à renvoyer.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande list-objects-v2 renvoie les éléments suivants :

  • Contents : Informations à propos du contenu de votre bucket. Cet élément contient les informations suivantes :

    • Key : Le nom de l’objet dans le bucket.

    • LastModified : La date et l’heure à laquelle l’objet a été déposé ou copié sur le bucket.

    • ETag : L’ETag de l’objet.

    • Size : La taille de votre objet, en octets.

    • StorageClass : La classe de stockage de votre objet (toujours STANDARD).

    • Owner : Informations à propos du propriétaire de l’objet. Cet élément contient les informations suivantes :

      • DisplayName : L’ID du compte OUTSCALE du propriétaire de l’objet.

      • ID : L’ID utilisateur S3 du propriétaire de l’objet.

  • CommonPrefixes : Informations à propos des common prefixes. Cet élément contient les informations suivantes :

    • Prefix : Le délimiteur que vous avez spécifié, ou la chaîne de caractères contenant le préfixe suivi du délimiteur. Pour en savoir plus sur les préfixes, voir À propos d’OOS > Objets.

  • RequestCharged : Indique si le demandeur a été facturé pour la requête. Si la valeur est requester, cela signifie que le coût de l’opération a été facturé au compte qui en a fait la demande. Une valeur null indique qu’aucune facturation n’a été appliquée au demandeur pour l’opération.

Exemple de résultat
{
    "Contents": [
        {
            "Key": "bank-data/2023/annual-overview.txt",
            "LastModified": "2024-01-04T16:42:52.922000+00:00",
            "ETag": "\"93494ed0663d6a689b5e1f90d9e29d41\"",
            "Size": 2048,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            }
        },
        {
            "Key": "bank-data/2023/report-summary.txt",
            "LastModified": "2024-01-04T16:42:53.694000+00:00",
            "ETag": "\"b4fb2aaa356797d9a28bfc640a973720\"",
            "Size": 1024,
            "StorageClass": "STANDARD",
            "Owner": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            }
        }
    ],
    "CommonPrefixes": [
        {
            "Prefix": "bank-data/2023/monthly-reports/"
        },
        {
            "Prefix": "bank-data/2023/transaction-logs/"
        }
    ],
    "RequestCharged": null
}

Lister les objets d’un bucket avec AWS CLI (s3)

Avant de commencer : Installez et configurez AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour lister les objets contenus dans un bucket, utilisez la commande ls en suivant cette syntaxe :

$ aws s3 ls s3://YOUR_BUCKET \
    --profile YOUR_PROFILE \
    --debug \
    --summarize \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • s3://YOUR_BUCKET : The name of the bucket whose objects you want to list.

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • (optionnel) debug : Si inclus, renvoie un rapport détaillé de l’opération. Cet attribut est utile pour analyser et résoudre les problèmes que vous pouvez rencontrer.

  • (optionnel) summarize : Si inclus, la réponse renvoie également le nombre d’objets contenus dans le bucket et la taille totale qu’ils représentent.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

The ls command returns a list of objects, their date and time of creation (in local time), and size (in bytes).

Result Sample
2023-11-29 09:51:46 111 object1
2024-01-30 10:30:46 222 object2
2024-01-30 15:59:21 333 object3

Lister les objets d’un bucket avec s3cmd

Vous pouvez gérer vos ressources de stockage objet en utilisant des commandes s3cmd. Pour en savoir plus, voir s3cmd.

Page connexe

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF