Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Daftar ember tujuan umum Amazon S3
Untuk mengembalikan daftar ember tujuan umum yang Anda miliki, Anda dapat menggunakannya [ListBuckets](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.htm). 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 REST API, Akun AWS yang menggunakan kuota layanan default untuk bucket (10.000 bucket), mendukung permintaan paginasi dan unpaginasi. 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 Region AWS untuk setiap bucket. Contoh berikut AWS Command Line Interface dan AWS SDK menunjukkan cara menggunakan pagination dalam permintaan Anda`ListBuckets`. Perhatikan bahwa beberapa AWS SDKs membantu dengan pagination.
**Izin**
Untuk membuat daftar semua ember tujuan umum Anda, Anda harus memiliki `s3:ListAllMyBuckets` izin. Jika Anda mengalami `HTTP Access Denied (403 Forbidden)` kesalahan, lihat. [Memecahkan masalah kesalahan akses ditolak (403 Forbidden) di Amazon S3](troubleshoot-403-errors.md)
**penting**
Kami sangat menyarankan hanya menggunakan `ListBuckets` permintaan paginasi. `ListBuckets`Permintaan 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.
## Menggunakan konsol S3
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Di panel navigasi kiri, pilih **Bucket tujuan umum**.
1. Pada tab **Bucket tujuan umum**, Anda dapat melihat daftar bucket tujuan umum Anda.
1. Untuk menemukan bucket berdasarkan nama, masukkan nama bucket di bidang **Temukan bucket dengan nama**.
## Menggunakan AWS CLI
Untuk menggunakan AWS CLI untuk membuat 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}}.
**Example — 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets).
**Example — 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets).
**Example — Daftar semua bucket di akun Anda (paginated)**
Contoh berikut menyediakan `list-buckets` perintah paginasi untuk mencantumkan semua bucket tujuan umum di akun Anda. `--page-size`Opsi `--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 panggilan API yang mendasarinya, output menyertakan token lanjutan, 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==}}
```
**Example — Daftar semua ember dalam AWS Region (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 Anda`us-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}}
```
**Example — 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}}
```
## Menggunakan AWS SDKs
Contoh berikut menunjukkan kepada Anda cara membuat daftar bucket tujuan umum Anda dengan menggunakan AWS SDKs
------
#### [ SDK for Python ]
**Example — ListBuckets permintaan (paginated)**
```
import boto3
s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets={{100}})
```
**Example — ListBuckets respon (paginated)**
```
import boto3
s3 = boto3.client('s3')
response = s3.list_buckets(MaxBuckets=1,ContinuationToken="{{eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ==EXAMPLE}}--")
```
------
#### [ SDK for Java ]
Untuk contoh cara membuat daftar bucket dengan AWS SDK for Java, [lihat Daftar](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_ListBuckets_section.html) bucket di Referensi API Amazon *S3*.
------
#### [ 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)
}
```
------