Elenco dei bucket Amazon S3 - Amazon Simple Storage Service

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elenco dei bucket Amazon S3

Per restituire un elenco di bucket generici di tua proprietà, puoi utilizzare. ListBuckets Puoi elencare i tuoi bucket utilizzando la console Amazon S3, AWS Command Line Interface il, o il. AWS SDKs Per ListBuckets le richieste che utilizzano l' AWS CLI API REST di Amazon S3, Account AWS che utilizzano la quota di servizio predefinita per i bucket (10.000 bucket), supporta sia le richieste impaginate che quelle non paginate. AWS SDKs Indipendentemente dal numero di bucket presenti nell'account, è possibile creare pagine di dimensioni comprese tra 1 e 10.000 bucket per elencare tutti i bucket. Per le richieste impaginate, le ListBuckets richieste restituiscono sia i nomi dei bucket che i corrispondenti per ogni bucket. Regioni AWS Gli esempi seguenti AWS Command Line Interface e quelli relativi all' AWS SDK mostrano come utilizzare l'impaginazione nella richiesta. ListBuckets Nota che alcuni AWS SDKs aiutano con l'impaginazione.

Autorizzazioni

Per elencare tutti i tuoi bucket, devi disporre dell'autorizzazione s3:ListAllMyBuckets. Se si verifica un errore HTTP Access Denied (403 Forbidden), consulta Risolvi i problemi relativi all'accesso negato (403 Forbidden) errori in Amazon S3.

Importante

Si consiglia vivamente di utilizzare solo richieste ListBuckets impaginate. Le richieste non impaginate di ListBuckets sono supportate solo per Account AWS impostato sulla quota predefinita di 10.000 bucket per uso generico. Se si dispone di una quota di bucket per uso generico approvata superiore a 10.000, è necessario inviare richieste ListBuckets impaginate per elencare i bucket del proprio account. Tutte le ListBuckets richieste non impaginate verranno rifiutate Account AWS con una quota di bucket generica superiore a 10.000.

  1. Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

  2. Nel pannello di navigazione a sinistra, scegli Buckets (Bucket).

  3. Nella scheda Bucket per uso generico è possibile visualizzare un elenco dei bucket per uso generico.

  4. Per trovare i bucket per nome, inserire il nome di un bucket nella casella di ricerca.

Per utilizzare il AWS CLI per generare un elenco di bucket generici, è possibile utilizzare i list-buckets comandi ls or. Gli esempi seguenti mostrano come creare una richiesta list-buckets impaginata e una richiesta ls non impaginata. Per utilizzare questi esempi, sostituire iluser input placeholders.

Esempio - Elenca tutti i bucket dell'account utilizzando ls (senza impaginazione)

Il seguente esempio di comando elenca tutti i bucket per uso generico dell'account in un'unica chiamata non impaginata. Questa chiamata restituisce un elenco di tutti i bucket dell'account (fino a 10.000 risultati):

$ aws s3 ls

Per ulteriori informazioni e esempi, consulta Elenco di bucket e oggetti.

Esempio - Elenca tutti i bucket dell'account utilizzando ls (con impaginazione)

Il seguente esempio di comando effettua una o più chiamate impaginate per elencare tutti i bucket per uso generico dell'account, restituendo 100 bucket per pagina:

$ aws s3 ls --page-size 100

Per ulteriori informazioni e esempi, consulta Elenco di bucket e oggetti.

Esempio - Elenca tutti i bucket dell'account (con impaginazione)

L'esempio seguente fornisce un comando impaginato list-buckets per elencare tutti i bucket per uso generico dell'account. Le opzioni --max-items e --page-size limitano il numero di bucket elencati a 100 per pagina. 

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

Se il numero di elementi in uscita (--max-items) è inferiore al numero totale di elementi restituiti dalle chiamate API sottostanti, l'output include un token di continuazione, specificato dall'argomento starting-token, che può essere trasmesso a un comando successivo per recuperare la serie successiva di elementi. L'esempio seguente mostra come utilizzare il valore starting-token restituito dall'esempio precedente. È possibile specificare starting-code per recuperare i 100 bucket successivi. 

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

Esempio — Elenca tutti i bucket in un file Regione AWS (impaginato)

Il seguente esempio di comando utilizza il parametro --bucket-region per elencare fino a 100 bucket in un account che si trovano nella Regione us-east-2. Le richieste effettuate a un endpoint regionale diverso dal valore specificato nel parametro --bucket-region non sono supportate. Ad esempio, se si vuole limitare la risposta ai propri bucket in us-east-2, si deve fare la richiesta a un endpoint in us-east-2.

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

Esempio - Elenca tutti i bucket che iniziano con un prefisso specifico del nome del bucket (con impaginazione)

Il seguente esempio di comando elenca fino a 100 bucket che hanno un nome che inizia con il prefisso amzn-s3-demo-bucket. 

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

I seguenti esempi mostrano come elencare i bucket per uso generico utilizzando il AWS SDKs

SDK for Python
Esempio — ListBuckets richiesta (impaginata)
import boto3

s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=100)
Esempio — ListBuckets risposta (impaginata)
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)
}