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

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Pour renvoyer une liste des buckets à 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, du AWS Command Line Interface, ou du AWS SDKs. Pour les ListBuckets demandes utilisant l'API REST AWS CLI AWS SDKs,, et Amazon S3, Comptes AWS qui utilisent le quota de service par défaut pour les compartiments (10 000 compartiments), prennent en charge les demandes paginées et 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 ListBuckets demandes renvoient à la fois le nom du compartiment et le nom correspondant Régions AWS pour chaque compartiment. Les exemples suivants, AWS Command Line Interface ainsi que ceux du AWS SDK, vous montrent comment utiliser la pagination dans votre ListBuckets demande. Notez que certains AWS SDKs facilitent la pagination.

Autorisations

Pour répertorier tous vos compartiments à usage général, vous devez en avoir l's3:ListAllMyBucketsautorisation. 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 ListBuckets demandes non paginées seront rejetées si le quota de Comptes AWS compartiments à usage général est supérieur à 10 000.

  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à 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, entrez un nom de compartiment dans le champ Rechercher des compartiments par nom.

AWS CLI Pour générer une liste de compartiments à usage général, vous pouvez utiliser les list-buckets commandes ls ou. 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 leuser input placeholders.

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 — Liste tous les buckets dans un Région AWS (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 répertorier vos compartiments à usage général à l'aide du AWS SDKs

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

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

s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=1,ContinuationToken="eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==EXAMPLE--")
SDK for Java
import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.ListBucketsPaginatedRequest;
import com.amazonaws.services.s3.model.ListBucketsPaginatedResult;

import java.util.List;

public class ListBuckets {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.DEFAULT_REGION).build();
        ListBucketsPaginatedRequest listBucketsPaginatedRequest = new ListBucketsPaginatedRequest().withMaxBuckets(1);
        ListBucketsPaginatedResult listBucketsPaginatedResult = s3.listBuckets(listBucketsPaginatedRequest);
        List<Bucket> buckets = listBucketsPaginatedResult.getBuckets();
        System.out.println("Your Amazon S3 buckets are:");
        for (Bucket b : buckets) {
            System.out.println("* " + b.getName() + " region: " + b.getRegion());
        }
        System.out.println("continuation token: " + listBucketsPaginatedResult.getContinuationToken());
    }
}
SDK for Java 2.x
import software.amazon.awssdk.auth.credentials.DefaultCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.Bucket;
import software.amazon.awssdk.services.s3.model.ListBucketsRequest;
import software.amazon.awssdk.services.s3.model.ListBucketsResponse;

import java.util.List;

public class ListBuckets {
    public static void main(String[] args) {
        // Create an S3 client
        S3Client s3 = S3Client.builder()
                .region(Region.US_EAST_1) // Replace with your preferred region
                .credentialsProvider(DefaultCredentialsProvider.create())
                .build();

        try {
            // List buckets
            ListBucketsRequest listBucketsRequest = ListBucketsRequest.builder()
                    .maxBuckets(10)
                    .build();
            ListBucketsResponse listBucketsResponse = s3.listBuckets(listBucketsRequest);
            List<Bucket> buckets = listBucketsResponse.buckets();

            // Print bucket names
            System.out.println("Your Amazon S3 buckets are:");
            for (Bucket bucket : buckets) {
                System.out.println(bucket.name());
                System.out.println(bucket.getBucketRegion());
            }

        } catch (Exception e) {
            System.err.println("Error listing buckets: " + e.getMessage());
            e.printStackTrace();
        } finally {
            // Close the S3 client to release resources
            s3.close();
        }
    }
}
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)
}