Daftar ember Amazon S3 - Amazon Simple Storage Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Daftar ember Amazon S3

Untuk mengembalikan daftar ember tujuan umum yang Anda miliki, Anda dapat menggunakannya ListBuckets. Anda dapat membuat daftar bucket Anda dengan menggunakan konsol Amazon S3, AWS Command Line Interface the, atau. AWS SDKs Untuk ListBuckets permintaan yang menggunakan AWS CLI, AWS SDKs, dan Amazon S3 RESTAPI, Akun AWS yang menggunakan kuota layanan default untuk bucket (10.000 bucket), mendukung permintaan paginasi dan tanpa paginasi. Terlepas dari berapa banyak bucket yang Anda miliki di akun Anda, Anda dapat membuat ukuran halaman antara 1 dan 10.000 bucket untuk mencantumkan semua bucket Anda. Untuk permintaan paginasi, ListBuckets permintaan mengembalikan nama bucket dan yang sesuai Wilayah AWS untuk setiap bucket. Berikut AWS Command Line Interface dan AWS SDK contoh menunjukkan cara menggunakan pagination dalam ListBuckets permintaan Anda. Perhatikan bahwa beberapa AWS SDKs membantu dengan pagination.

Izin

Untuk mendaftarkan semua bucket, Anda harus memiliki izin s3:ListAllMyBuckets. Jika Anda mengalami HTTP Access Denied (403 Forbidden) kesalahan, lihat. Memecahkan masalah akses ditolak (403 Forbidden) kesalahan di Amazon S3

penting

Kami sangat menyarankan hanya menggunakan ListBuckets permintaan paginasi. ListBucketsPermintaan tanpa paginasi hanya didukung untuk Akun AWS disetel ke kuota bucket tujuan umum default sebesar 10.000. Jika Anda memiliki kuota bucket tujuan umum yang disetujui di atas 10.000, Anda harus mengirim ListBuckets permintaan paginasi untuk mencantumkan bucket akun Anda. Semua ListBuckets permintaan tanpa paginasi akan ditolak Akun AWS dengan kuota bucket tujuan umum lebih dari 10.000.

  1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di. https://console.aws.amazon.com/s3/

  2. Di panel navigasi kiri, pilih Bucket.

  3. Pada tab Bucket tujuan umum, Anda dapat melihat daftar bucket tujuan umum Anda.

  4. Untuk menemukan bucket berdasarkan nama, masukkan nama bucket di kotak pencarian.

Untuk menggunakan AWS CLI untuk menghasilkan daftar bucket tujuan umum, Anda dapat menggunakan list-buckets perintah ls atau. Contoh berikut menunjukkan cara membuat permintaan paginasi dan list-buckets permintaan tanpa ls paginasi. Untuk menggunakan contoh-contoh ini, ganti user input placeholders.

contoh — Daftar semua bucket di akun Anda dengan menggunakan ls (unpaginated)

Contoh perintah berikut mencantumkan semua bucket tujuan umum di akun Anda dalam satu panggilan non-paginasi. Panggilan ini menampilkan daftar semua bucket di akun Anda (hingga 10.000 hasil):

$ aws s3 ls

Untuk informasi dan contoh selengkapnya, lihat Mendaftarkan bucket dan objek.

contoh — Daftar semua bucket di akun Anda dengan menggunakan ls (paginated)

Contoh perintah berikut membuat satu atau beberapa panggilan paginasi untuk mencantumkan semua bucket tujuan umum di akun Anda, mengembalikan 100 bucket per halaman:

$ aws s3 ls --page-size 100

Untuk informasi dan contoh selengkapnya, lihat Mendaftarkan bucket dan objek.

contoh — Daftar semua bucket di akun Anda (paginated)

Contoh berikut menyediakan list-buckets perintah paginasi untuk mencantumkan semua bucket tujuan umum di akun Anda. --page-sizeOpsi --max-items dan membatasi jumlah ember yang terdaftar hingga 100 per halaman.

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

Jika jumlah item output (--max-items) lebih sedikit dari jumlah total item yang dikembalikan oleh API panggilan yang mendasarinya, output menyertakan token kelanjutan, yang ditentukan oleh starting-token argumen, yang dapat Anda berikan ke perintah berikutnya untuk mengambil set item berikutnya. Contoh berikut menunjukkan bagaimana menggunakan starting-token nilai yang dikembalikan oleh contoh sebelumnya. Anda dapat menentukan starting-code untuk mengambil 100 ember berikutnya.

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

contoh — Daftar semua ember dalam Wilayah AWS (paginated)

Contoh perintah berikut menggunakan --bucket-region parameter untuk daftar hingga 100 bucket dalam akun yang berada di us-east-2 Region. Permintaan yang dibuat ke titik akhir Regional yang berbeda dari nilai yang ditentukan dalam --bucket-region parameter tidak didukung. Misalnya, jika Anda ingin membatasi respons ke bucket Andaus-east-2, Anda harus membuat permintaan ke titik akhir di. us-east-2

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

contoh — Buat daftar semua bucket yang dimulai dengan awalan nama bucket tertentu (paginated)

Contoh perintah berikut mencantumkan hingga 100 bucket yang memiliki nama yang dimulai dengan amzn-s3-demo-bucket awalan.

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

Contoh berikut menunjukkan kepada Anda cara membuat daftar bucket tujuan umum Anda dengan menggunakan AWS SDKs

SDK for Python
contoh — ListBuckets permintaan (paginated)
import boto3 s3 = boto3.client('s3') response = s3.list_buckets(MaxBuckets=100)
contoh — ListBuckets respon (paginated)
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) }