Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Paginasi
Banyak operasi AWS layanan dapat mengembalikan lebih banyak hasil daripada cocok dalam satu respons. Ketika ini terjadi, respons menyertakan token pagination yang menunjukkan lebih banyak hasil yang tersedia. Untuk mengambil halaman hasil berikutnya, Anda menyertakan token itu dalam permintaan berikutnya. Proses ini berulang sampai tidak ada token yang dikembalikan, menunjukkan bahwa Anda telah menerima semua hasil.
Cara kerja pagination
Saat Anda memanggil operasi API paginasi, layanan akan mengembalikan jumlah item maksimum tetap per respons. Jika jumlah total item melebihi maksimum ini, layanan menyertakan token pagination dalam respons. Nama spesifik token ini bervariasi menurut layanan—nama umum termasukNextToken,,Marker, ContinuationToken dan. ExclusiveStartKey Untuk meminta halaman berikutnya, Anda meneruskan nilai token ini dalam parameter permintaan yang sesuai dari panggilan Anda berikutnya.
Sebagian besar operasi paginasi juga mendukung parameter yang mengontrol jumlah maksimum item yang dikembalikan per halaman. Nama umum untuk parameter ini termasukMaxResults,MaxItems,MaxKeys,MaxRecords, danLimit.
Token pagination hanya valid jika Anda menerimanya dalam respons sebelumnya dari operasi yang sama. Jika respons tidak menyertakan token, tidak ada lagi hasil untuk diambil.
Menggunakan paginator
Daripada melacak token pagination secara manual, semua AWS SDK menyediakan abstraksi paginator. Sebuah paginator menangani manajemen token secara otomatis, membuat panggilan API berturut-turut dan menghasilkan hasil sampai semua halaman telah diambil. Menggunakan paginator menyederhanakan kode Anda dan mengurangi risiko kesalahan seperti lupa melewatkan token atau menggunakannya secara tidak benar.
Karakteristik utama paginator di seluruh SDK:
-
Paginator menerima parameter input yang sama dengan operasi API yang mendasarinya.
-
Paginator secara otomatis mendeteksi ketika lebih banyak halaman tersedia dan mengambilnya.
-
Paginator berhenti membuat permintaan ketika tidak ada token pagination yang dikembalikan dalam respons.
-
Beberapa SDK juga menyediakan mekanisme untuk membatasi jumlah halaman atau item yang diambil.
Konsultasikan panduan pengembang SDK spesifik Anda untuk sintaks paginator dan pola penggunaan yang tersedia dalam bahasa Anda.
Support oleh AWS SDK dan alat
SDK berikut mendukung fitur dan pengaturan yang dijelaskan dalam topik ini. Setiap pengecualian sebagian dicatat. Setiap pengaturan properti sistem JVM didukung oleh AWS SDK untuk Java dan satu-satunya. AWS SDK for Kotlin
| SDK | Didukung | Catatan atau informasi lebih lanjut |
|---|---|---|
| AWS CLI v2 | Ya | Built-in pagination otomatis untuk semua perintah. Gunakan --no-paginate untuk menonaktifkan. |
| SDK for C++ | Tidak | Diperlukan penanganan token manual. |
| SDK for Go V2 (1.x) | Ya | Gunakan New<OperationName>Paginator tipe. |
| SDK for Go 1.x (V1) | Ya | Gunakan <OperationName>Pages metode. |
| SDK for Java 2.x | Ya | Gunakan <operationName>Paginator metode pada klien. |
| SDK for Java 1.x | Ya | |
| SDK untuk 3.x JavaScript | Ya | Gunakan paginate<OperationName> fungsi. |
| SDK untuk 2.x JavaScript | Tidak | Diperlukan penanganan token manual. |
| SDK para Kotlin | Ya | Gunakan fungsi <operationName>Paginated ekstensi. |
| SDK for .NET 4.x | Ya | Gunakan IPaginator antarmuka. |
| SDK for .NET 3.x | Ya | Gunakan IPaginator antarmuka. |
| SDK for PHP 3.x | Ya | Gunakan getPaginator pada klien. |
| SDK untuk Python (Boto3) | Ya | Gunakan get_paginator pada klien. |
| SDK for Ruby 3.x | Ya | Gunakan .each pada tanggapan yang mendukung pagination. |
| SDK untuk Rust | Ya | Gunakan .into_paginator() berdasarkan permintaan pembangun. |
| SDK para Swift | Ya | Gunakan PaginatedSequence tipe. |
| Alat untuk PowerShell V5 | Ya | Built-in pagination otomatis. Gunakan -NoAutoIteration untuk menonaktifkan. |
| Alat untuk PowerShell V4 | Ya |
