État du service

Le service Object Storage Unit (OSU) est à présent en FIN DE SUPPORT ET MAINTENANCE. Pour en savoir plus, voir Politique de fin de vie.

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 uploadé 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 du stockage objet > Objets.

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

Page connexe
  • 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 ENDPOINT

    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 commence 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 au service (oos ou osu) et à la Région auxquels vous voulez envoyer la requête, selon le format suivant : https://<SERVICE>.<REGION>.outscale.com


    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 du stockage objet > 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é uploadé 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 : Le prénom et le nom du propriétaire de l'objet.
        • ID : L'ID utilisateur S3 du propriétaire de l'objet si oos a été spécifié comme endpoint, ou son ID de compte OUTSCALE si osu a été spécifié comme endpoint.
      • 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": "USER_ID"
                },
                "Size": 42
            },
    
            {
                "LastModified": "2017-03-02T14:12:41.173Z",
                "ETag": "\"a9e872119bfa18db39ed9207c3c5b81f\"",
                "StorageClass": "STANDARD",
                "Key": "PREFIX/OBJECT_2",
                "Owner": {
                    "DisplayName": "ACCOUNT",
                    "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 ENDPOINT
    • Vous pouvez également gérer vos ressources de stockage objet en utilisant des commandes s3cmd. Pour en savoir plus, voir s3cmd (disponible en anglais uniquement).


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.