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
Dukungan SOAP melalui HTTP tidak digunakan lagi, tetapi SOAP masih tersedia melalui HTTPS. Fitur Amazon S3 baru tidak mendukung SOAP. Alih-alih menggunakan SOAP, kami sarankan Anda menggunakan REST API atau AWS SDK.
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.
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 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
Contoh kode berikut menunjukkan cara menggunakanListObjects.
