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](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.htm). 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 à chaque compartiment. Les exemples suivants AWS Command Line Interface et AWS ceux du SDK vous montrent comment utiliser la pagination dans votre `ListBuckets` demande. Notez que certains AWS SDKs facilitent la pagination.
**Permissions**
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](troubleshoot-403-errors.md).
**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.
## Utilisation de la console S3
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.
1. Dans l’onglet **Compartiments à usage général**, vous pouvez voir la liste de vos compartiments à usage général.
1. Pour rechercher des compartiments par nom, saisissez un nom de compartiment dans le champ **Rechercher des compartiments par nom**.
## À l'aide du AWS CLI
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 le{{user input placeholders}}.
**Example — 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets).
**Example — 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets).
**Example — 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==}}
```
**Example — 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}}
```
**Example — 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}}
```
## À l'aide du AWS SDKs
Les exemples suivants vous montrent comment répertorier vos compartiments à usage général à l'aide du AWS SDKs
------
#### [ SDK for Python ]
**Example — ListBuckets demande (paginée)**
```
import boto3
s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets={{100}})
```
**Example — ListBuckets réponse (paginée)**
```
import boto3
s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=1,ContinuationToken="{{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==EXAMPLE}}--")
```
------
#### [ SDK for Java ]
Pour des exemples expliquant comment répertorier les buckets avec le AWS SDK pour Java, [consultez la section List](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_ListBuckets_section.html) buckets du manuel *Amazon S3 API Reference*.
------
#### [ 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)
}
```
------