Liste des compartiments à usage général Amazon S3 - Amazon Simple Storage Service

Liste des compartiments à usage général Amazon S3

Pour renvoyer une liste des compartiments à usage général que vous possédez, vous pouvez utiliser ListBuckets. Vous pouvez répertorier vos compartiments à l’aide de la console Amazon S3, de l’AWS Command Line Interface ou des kits AWS SDK. Pour les demandes ListBuckets effectuées via l’AWS CLI, les kits AWS SDK et l’API REST Amazon S3, les Comptes AWS qui utilisent le quota de service par défaut pour les compartiments (10 000 compartiments) prennent en charge à la fois les demandes paginées et les demandes non paginées. Quel que soit le nombre de compartiments présents dans votre compte, vous pouvez créer des formats de page compris entre 1 et 10 000 compartiments pour afficher tous vos compartiments. Pour les demandes paginées, les demandes ListBuckets renvoient à la fois le nom du compartiment et les Régions AWS correspondantes pour chaque compartiment. Les exemples suivants avec l’AWS Command Line Interface et le kit AWS SDK montrent comment utiliser la pagination dans une demande ListBuckets. Notez que certains kits AWS SDK facilitent la pagination.

Autorisations

Pour répertorier tous vos compartiments à usage général, vous devez disposer de l’autorisation s3:ListAllMyBuckets. Si vous rencontrez une erreur HTTP Access Denied (403 Forbidden), consultez Résolution des erreurs d’accès refusé (403 Forbidden) dans Amazon S3.

Important

Nous vous recommandons vivement de n’utiliser que des demandes ListBuckets paginées. Les demandes ListBuckets non paginées ne sont prises en charge que pour les Comptes AWS dont le quota de compartiments à usage général par défaut a été défini sur 10 000. Si vous avez un quota de compartiments à usage général approuvé supérieur à 10 000, vous devez envoyer des demandes ListBuckets paginées pour répertorier les compartiments de votre compte. Toutes les demandes ListBuckets non paginées seront rejetées si le quota de compartiments à usage général pour les Comptes AWS est supérieur à 10 000.

  1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon S3 à l’adresse https://console.aws.amazon.com/s3/.

  2. Dans le volet de navigation de gauche, choisissez Compartiments à usage général.

  3. Dans l’onglet Compartiments à usage général, vous pouvez voir la liste de vos compartiments à usage général.

  4. Pour rechercher des compartiments par nom, saisissez un nom de compartiment dans le champ Rechercher des compartiments par nom.

Pour utiliser l’AWS CLI afin de générer une liste de compartiments à usage général, vous pouvez utiliser les commandes ls ou list-buckets. Les exemples suivants montrent comment créer une demande list-buckets paginée et une demande ls non paginée. Pour utiliser ces exemples, remplacez les espaces réservés aux entrées utilisateur.

Exemple — Afficher tous les compartiments de votre compte avec ls (appel non paginé)

L’exemple de commande suivant répertorie tous les compartiments à usage général de votre compte en un seul appel non paginé. Cet appel renvoie une liste de tous les compartiments de votre compte (jusqu’à 10 000 résultats) :

$ aws s3 ls

Pour plus d’informations et pour obtenir des exemples, consultez Liste des compartiments et des objets.

Exemple — Afficher tous les compartiments de votre compte avec ls (appel paginé)

L’exemple de commande suivant effectue un ou plusieurs appels paginés pour afficher tous les compartiments à usage général de votre compte. Il renvoie 100 compartiments par page :

$ aws s3 ls --page-size 100

Pour plus d’informations et pour obtenir des exemples, consultez Liste des compartiments et des objets.

Exemple — Afficher tous les compartiments de votre compte (appel paginé)

L’exemple suivant fournit une commande list-buckets paginée qui répertorie tous les compartiments à usage général de votre compte. Les options --max-items et --page-size limitent le nombre de compartiments répertoriés à 100 par page. 

$ aws s3api list-buckets /
    --max-items 100 / 
    --page-size 100

Si le nombre d’éléments en sortie (--max-items) est inférieur au nombre total d’éléments renvoyés par les appels d’API sous-jacents, la sortie inclut un jeton de continuation, spécifié par l’argument starting-token. Vous pourrez transmettre ce jeton dans une commande ultérieure pour extraire le prochain ensemble d’éléments. L’exemple suivant montre comment utiliser la valeur starting-token renvoyée par l’exemple précédent. Vous pouvez spécifier starting-code pour récupérer les 100 prochains compartiments. 

$ aws s3api list-buckets / 
    --max-items 100 / 
    --page-size 100 /
    --starting-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==

Exemple — Afficher tous les compartiments d’une Région AWS (appel paginé)

L’exemple de commande suivant utilise le paramètre --bucket-region pour répertorier jusqu’à 100 compartiments situés dans la région us-east-2 pour un compte. Les demandes adressées à un point de terminaison régional différent de la valeur spécifiée dans le paramètre --bucket-region ne sont pas prises en charge. Par exemple, si vous souhaitez limiter la réponse aux compartiments qui se trouvent dans la région us-east-2, vous devez envoyer votre demande à un point de terminaison dans us-east-2.

$ aws s3api list-buckets /
    --region us-east-2 /
    --max-items 100 / 
    --page-size 100 /
    --bucket-region us-east-2

Exemple — Afficher tous les compartiments commençant par un préfixe de nom de compartiment spécifique (appel paginé)

L’exemple de commande suivant répertorie jusqu’à 100 compartiments dont le nom commence par le préfixe amzn-s3-demo-bucket. 

$ aws s3api list-buckets /
    --max-items 100 /
    --page-size 100 /
    --prefix amzn-s3-demo-bucket

Les exemples suivants vous montrent comment afficher les compartiments à usage général à l’aide des kits AWS SDK.

SDK for Python
Exemple — Demande ListBuckets (paginée)
import boto3

s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=100)
Exemple — Réponse ListBuckets (paginée)
import boto3

s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=1,ContinuationToken="eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==EXAMPLE--")
SDK for Java

Pour voir des exemples expliquant comment répertorier les compartiments à l’aide du kit AWS SDK pour Java, consultez Liste des compartiments de la Référence des API Amazon S3.

SDK for Go
package main
import (
 "context"
 "fmt"
 "log"
 "github.com/aws/aws-sdk-go-v2/aws"
 "github.com/aws/aws-sdk-go-v2/config"
 "github.com/aws/aws-sdk-go-v2/service/s3"
)
func main() {
 cfg, err := config.LoadDefaultConfig(context.TODO(), config.WithRegion("us-east-2"))
 if err != nil {
  log.Fatal(err)
 }
 client := s3.NewFromConfig(cfg)
 maxBuckets := 1000
 resp, err := client.ListBuckets(context.TODO(), management portals3.ListBucketsInput{MaxBuckets: aws.Int32(int32(maxBuckets))})
 if err != nil {
  log.Fatal(err)
 }
 fmt.Println("S3 Buckets:")
 for _, bucket := range resp.Buckets {
     fmt.Println("- Name:", *bucket.Name)
     fmt.Println("-BucketRegion", *bucket.BucketRegion)
 }
 fmt.Println(resp.ContinuationToken == nil)
 fmt.Println(resp.Prefix == nil)
}