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.

Cette fonctionnalité n’est pas disponible depuis Cockpit. Cette documentation décrit uniquement la procédure à l’aide d’AWS CLI.

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

Exemple de requête
$ aws s3api list-objects \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --prefix PREFIX/OBJECT \
    [--delimiter NOT_SPECIFIED] \
    --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 Utiliser 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.

  • (optionnel) delimiter : Une lettre pour filtrer vos objets. Cet attribut exclut les objets qui contiennent ou qui commencent par la lettre que vous spécifiez.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

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

  • 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, voir À propos d’OOS > Objets.

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

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

    • ETag : L’ETag de l’objet.

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

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

    • 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.

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

Exemple de résultat
{
    "CommonPrefixes": [
        {
            "Prefix": "PREFIX/OBJECT"
        }
    ],
    "Contents": [
        {
            "LastModified": "2017-02-02T09:31:25.790Z",
            "ETag": "\"93494ed0663d6a689b5e1f90d9e29d41\"",
            "StorageClass": "STANDARD",
            "Key": "PREFIX/OBJECT_1",
            "Owner": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            },
            "Size": 42
        },

        {
            "LastModified": "2017-03-02T14:12:41.173Z",
            "ETag": "\"a9e872119bfa18db39ed9207c3c5b81f\"",
            "StorageClass": "STANDARD",
            "Key": "PREFIX/OBJECT_2",
            "Owner": {
                "DisplayName": "ACCOUNT_ID",
                "ID": "USER_ID"
            },
            "Size": 200
        }
    ]
}
  • Vous pouvez également effectuer cette action en utilisant une commande s3 suivant cette syntaxe :

    $ aws s3 ls --profile YOUR_PROFILE s3://YOUR_BUCKET --endpoint https://oos.eu-west-2.outscale.com
  • Vous pouvez également 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.