Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membuat daftar kunci objek secara terprogram
Di Amazon S3, kunci dapat didaftarkan dengan prefiks. Anda dapat memilih prefiks umum untuk nama kunci terkait dan menandai kunci tersebut dengan karakter khusus yang membatasi hierarki. Anda kemudian dapat menggunakan operasi daftar untuk memilih dan menelusuri kunci secara hierarki. Hal ini mirip dengan bagaimana file disimpan dalam direktori dalam sistem file.
Amazon S3 mengekspos operasi daftar yang memungkinkan Anda menghitung kunci yang terdapat dalam bucket. Kunci yang dipilih untuk pendaftaran didasarkan pada bucket dan prefiks. Misalnya, bayangkan sebuah bucket bernama "`dictionary`" yang berisi kunci untuk setiap kata dalam bahasa Inggris. Anda dapat membuat panggilan untuk mencantumkan semua kunci dalam bucket yang dimulai dengan huruf "q". Hasil daftar selalu ditampilkan dalam urutan biner UTF-8.
Operasi daftar SOAP dan REST mengembalikan dokumen XML yang berisi nama kunci yang cocok dan informasi tentang objek yang diidentifikasi oleh setiap kunci.
**catatan**
SOAP APIs untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDKs.
Kelompok kunci yang berbagi prefiks yang diakhiri oleh pembatas khusus dapat digabungkan dengan prefiks umum tersebut untuk tujuan pencatatan. Hal ini memungkinkan aplikasi untuk mengatur dan menelusuri kuncinya secara hierarki, seperti cara Anda mengatur file ke dalam direktori dalam sistem file.
Misalnya, untuk memperluas bucket kamus agar berisi lebih dari sekadar kata-kata bahasa Inggris, Anda dapat membentuk kunci dengan mengawali setiap kata dengan bahasanya dan pembatas, seperti "`French/logical`". Dengan menggunakan skema penamaan ini dan fitur daftar hierarki, Anda hanya dapat mengambil daftar kata-kata dalam bahasa Prancis. Anda juga dapat menelusuri daftar bahasa tingkat atas yang tersedia tanpa harus mengulangi semua kunci intervensi leksikografis. Untuk informasi selengkapnya tentang aspek pendaftaran ini, lihat [Organisasi objek menggunakan prefiks](using-prefixes.md).
**API REST**
Jika aplikasi Anda memerlukannya, Anda dapat mengirimkan permintaan REST secara langsung. Anda dapat mengirimkan permintaan GET untuk mengembalikan beberapa atau semua objek dalam bucket atau Anda dapat menggunakan kriteria pemilihan untuk mengembalikan subset objek dalam bucket. Untuk informasi selengkapnya, lihat [GET Bucket (List Objects) Version 2](https://docs.aws.amazon.com/AmazonS3/latest/API/v2-RESTBucketGET.html) dalam *Referensi API Amazon Simple Storage Service*.
**Membuat daftar implementasi efisiensi**
Performa daftar tidak terpengaruh langsung oleh jumlah kunci dalam bucket Anda. Hal ini juga tidak terpengaruh dengan ada atau tidak adanya argumen `prefix`, `marker`, `maxkeys`, atau `delimiter`.
**Iterasi melalui hasil multihalaman**
Karena bucket dapat berisi kunci dalam jumlah yang hampir tidak terbatas, hasil lengkap dari kueri daftar bisa sangat besar. Untuk mengelola kumpulan hasil yang besar, API Amazon S3 mendukung penomoran halaman untuk membaginya menjadi beberapa respons. Setiap respons kunci daftar mengembalikan halaman hingga 1.000 kunci dengan indikator yang menunjukkan apakah respons terpotong. Anda mengirim serangkaian permintaan kunci daftar sampai Anda menerima semua kunci. AWS Pustaka pembungkus SDK menyediakan pagination yang sama.
## Contoh
Saat mendaftarkan semua objek di dalam bucket Anda, perhatikan bahwa Anda harus memiliki izin `s3:ListBucket`.
------
#### [ CLI ]
**daftar-objek**
Contoh berikut menggunakan `list-objects` perintah untuk menampilkan nama-nama semua objek dalam bucket yang ditentukan:
```
aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}'
```
Contoh menggunakan `--query` argumen untuk memfilter output `list-objects` turun ke nilai kunci dan ukuran untuk setiap objek
Untuk informasi selengkapnya tentang objek, lihat [Bekerja dengan objek di Amazon S3](uploading-downloading-objects.md).
+ Untuk detail API, lihat [ListObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html)di *Referensi AWS CLI Perintah*.
**ls**
Contoh berikut mencantumkan semua objek dan awalan dalam ember dengan menggunakan perintah. `ls`
Untuk menggunakan perintah contoh ini, ganti **amzn-s3-demo-bucket** dengan nama bucket Anda.
```
$ aws s3 ls s3://amzn-s3-demo-bucket
```
+ Untuk informasi selengkapnya tentang perintah tingkat tinggi`ls`, lihat [Daftar bucket dan objek](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-listing-buckets) di *AWS Command Line Interface Panduan Pengguna*.
------
#### [ PowerShell ]
**Alat untuk PowerShell V4**
**Contoh 1: Perintah ini mengambil informasi tentang semua item di bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Contoh 2: Perintah ini mengambil informasi tentang item "sample.txt" dari bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Contoh 3: Perintah ini mengambil informasi tentang semua item dengan awalan “sample” dari bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Untuk detail API, lihat [ListObjects](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*.
**Alat untuk PowerShell V5**
**Contoh 1: Perintah ini mengambil informasi tentang semua item di bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket
```
**Contoh 2: Perintah ini mengambil informasi tentang item "sample.txt" dari bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt
```
**Contoh 3: Perintah ini mengambil informasi tentang semua item dengan awalan “sample” dari bucket “test-files”.**
```
Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
```
+ Untuk detail API, lihat [ListObjects](https://docs.aws.amazon.com/powershell/v5/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V5)*.
------