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)
Pour lister les objets contenus dans un bucket, utilisez la commande list-objects suivant cette syntaxe :
$ 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 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. -
(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 (toujoursSTANDARD
). -
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.
-
{
"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
}
]
}
Lister les objets d’un bucket avec AWS CLI (s3)
Vous pouvez 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
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.