Amazon S3 S3-Allzweck-Buckets auflisten - Amazon Simple Storage Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon S3 S3-Allzweck-Buckets auflisten

Um eine Liste der Allzweck-Buckets zurückzugeben, die Sie besitzen, können Sie Folgendes verwenden. ListBuckets Sie können Ihre Buckets mit der Amazon S3 S3-Konsole AWS Command Line Interface, dem oder dem AWS SDKs auflisten. Für ListBuckets Anfragen AWS CLI, die die, AWS SDKs, und die Amazon S3 S3-REST-API verwenden, die AWS-Konten das Standard-Servicekontingent für Buckets (10.000 Buckets) verwenden, werden sowohl paginierte als auch unpaginierte Anfragen unterstützt. Unabhängig davon, wie viele Buckets Sie in Ihrem Konto haben, können Sie Seitengrößen zwischen 1 und 10 000 Buckets erstellen, um alle Ihre Buckets aufzulisten. Bei paginierten Anfragen geben Anfragen sowohl die Bucket-Namen als auch die entsprechenden Namen für jeden Bucket zurück. ListBuckets AWS-Regionen Die folgenden Beispiele AWS Command Line Interface und AWS SDK-Beispiele zeigen Ihnen, wie Sie die Paginierung in Ihrer ListBuckets Anfrage verwenden. Beachten Sie, dass einige AWS SDKs bei der Paginierung helfen.

Berechtigungen

Um all Ihre Allzweck-Buckets aufzulisten, benötigen Sie die s3:ListAllMyBuckets entsprechende Genehmigung. Wenn bei Ihnen ein HTTP Access Denied (403 Forbidden)-Fehler auftritt, finden Sie weitere Informationen unter Beheben von „Zugriff verweigert“-Fehlern (403 Forbidden) in Amazon S3.

Wichtig

Wir empfehlen dringend, nur paginierte ListBuckets-Anfragen zu verwenden. Nicht paginierte ListBuckets-Anforderungen werden nur für AWS-Konten unterstützt, wenn das standardmäßige Allzweck-Bucket-Kontingent auf 10 000 festgelegt ist. Wenn Sie ein genehmigtes Kontingent für Allzweck-Buckets von mehr als 10 000 haben, müssen Sie paginierte ListBuckets-Anfragen senden, um die Buckets Ihres Kontos aufzulisten. Alle ListBuckets Anfragen ohne Seitennummerierung werden abgelehnt, wenn das allgemeine Bucket-Kontingent mehr als 10.000 beträgt. AWS-Konten

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die Amazon S3 S3-Konsole unter https://console.aws.amazon.com/s3/.

  2. Wählen Sie im linken Navigationsbereich Allzweck-Buckets aus.

  3. Auf der Registerkarte Allzweck-Buckets finden Sie eine Liste Ihrer Allzweck-Buckets.

  4. Um Buckets nach Namen zu suchen, geben Sie einen Bucket-Namen in das Feld Buckets nach Namen suchen ein.

Um mit dem eine Liste von Allzweck-Buckets AWS CLI zu generieren, können Sie die list-buckets Befehle ls oder verwenden. Die folgenden Beispiele zeigen, wie Sie eine paginierte list-buckets-Anfrage und eine unpaginierte ls-Anfrage erstellen. Um diese Beispiele zu verwenden, ersetzen Sie denuser input placeholders.

Beispiel – Alle Buckets in Ihrem Konto mithilfe von ls (unpaginiert) auflisten

Mit dem folgenden Beispielbefehl werden alle Allzweck-Buckets in Ihrem Konto in einem einzigen nicht paginierten Aufruf aufgelistet. Dieser Aufruf gibt eine Liste aller Buckets in Ihrem Konto zurück (bis zu 10 000 Ergebnisse):

$ aws s3 ls

Weitere Informationen finden Sie unter Auflisten von Buckets und Objekten.

Beispiel – Alle Buckets in Ihrem Konto mithilfe von ls (paginiert) auflisten

Der folgende Beispielbefehl führt einen oder mehrere paginierte Aufrufe durch, um alle Allzweck-Buckets in Ihrem Konto aufzulisten, wobei 100 Buckets pro Seite zurückgegeben werden:

$ aws s3 ls --page-size 100

Weitere Informationen finden Sie unter Auflisten von Buckets und Objekten.

Beispiel – Alle Buckets in Ihrem Konto auflisten (paginiert)

Das folgende Beispiel enthält einen paginierten list-buckets-Befehl, mit dem Sie alle Allzweck-Buckets in Ihrem Konto auflisten können. Die Optionen --max-items und --page-size begrenzen die Anzahl der aufgelisteten Buckets auf 100 pro Seite.

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

Wenn die Anzahl der ausgegebenen Elemente (--max-items) geringer als die Gesamtanzahl der Elemente ist, die von den zugrunde liegenden API-Aufrufen zurückgeliefert werden, enthält die Ausgabe ein Fortsetzungs-Token, angegeben durch ein starting-token-Argument. Dieses können Sie in einem anschließenden Befehl zum Abrufen der nächsten Gruppe von Elementen übergeben. Im folgenden Beispiel wird gezeigt, wie Sie den im vorherigen Beispiel zurückgegebenen starting-token-Wert verwenden. Sie können starting-code angeben, dass die nächsten 100 Buckets abgerufen werden sollen.

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

Beispiel — Listet alle Buckets in einer AWS-Region (paginierten) Liste auf

Der folgende Beispielbefehl verwendet den --bucket-region-Parameter, um bis zu 100 Buckets in einem Konto aufzulisten, die sich in derRegion us-east-2 befinden. Anfragen an einen regionalen Endpunkt, der sich von dem im --bucket-region-Parameter angegebenen Wert unterscheidet, werden nicht unterstützt. Wenn Sie beispielsweise die Antwort auf Ihre Buckets in us-east-2 beschränken möchten, müssen Sie Ihre Anfrage an einen Endpunkt in us-east-2 richten.

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

Beispiel – Alle Buckets auflisten, die mit einem bestimmten Bucket-Namenspräfix beginnen (paginiert)

Der folgende Beispielbefehl listet bis zu 100 Buckets auf, deren Name mit dem Präfix amzn-s3-demo-bucket beginnt.

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

Die folgenden Beispiele zeigen Ihnen, wie Sie Ihre Allzweck-Buckets auflisten können, indem Sie AWS SDKs

SDK for Python
Beispiel — ListBuckets Anfrage (paginiert)
import boto3 s3 = boto3.client('s3') response = s3.list_buckets(MaxBuckets=100)
Beispiel — ListBuckets Antwort (paginiert)
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) }