Halaman ini berisi penjelasan tentang cara penomoran halaman hasil di berbagai alat dan library Cloud Storage. Penomoran halaman diperlukan saat mencantumkan sejumlah besar objek atau bucket.
Konsol
Konsol Google Cloud akan otomatis memberi nomor halaman pada daftar bucket dan objek di halaman Bucket dan Detail bucket.
Command line
Google Cloud CLI akan otomatis memberi nomor halaman pada daftar objek dan bucket.
Library klien
C++
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi C++ untuk ListObjects()
.
C#
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi C# untuk ListObjects()
.
Go
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi Go untuk Bucket.Objects
.
Java
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi Java untuk Storage.Objects.list
.
Node.js
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi Node.js untuk getFiles()
.
PHP
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi PHP untuk Objects
.
Python
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk contoh cara penggunaan iterator ini, lihat dokumentasi referensi Phyton untuk iterator halaman.
Ruby
Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi
yang mendukung penomoran halaman, iterator akan ditampilkan sebagai respons. Untuk
contoh cara penggunaan iterator ini, lihat dokumentasi
referensi Ruby untuk Google::Cloud::Storage::File::List
.
REST API
JSON API
Saat Anda memanggil fungsi yang mendukung penomoran halaman, token
lanjutan nextPageToken
akan ditampilkan dalam respons jika listingan belum
lengkap. nextPageToken
mewakili
hasil terakhir yang ditampilkan. Jika Anda meneruskan nilai nextPageToken
ke parameter pageToken
dari permintaan berikutnya, halaman hasil berikutnya
akan ditampilkan, dimulai setelah hasil terakhir.
Contoh respons
{ "kind": "storage#objects", "nextPageToken": "CgtzaGliYS0yLmpwZw==", "items": [ objects Resource … ] }
Untuk informasi lebih lanjut tentang objects Resource
, lihat
Dokumentasi referensi objek.
Contoh permintaan
GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME&pageToken=NEXT_PAGE_TOKEN HTTP/1.1 Authorization: Bearer ACCESS_TOKEN Accept: application/json
Dengan keterangan:
- NEXT_PAGE_TOKEN adalah nilai
nextPageToken
dari respons sebelumnya. - BUCKET_NAME adalah nama bucket penyimpanan Anda.
- ACCESS_TOKEN adalah token akses yang Anda terima dari OAuth 2.0 Playground.
Untuk informasi selengkapnya tentang penomoran halaman hasil, lihat dokumentasi
referensi JSON untuk Objects: list
atau Buckets: list
.
XML API
Saat Anda memanggil fungsi yang mendukung penomoran halaman, token
lanjutan NextContinuationToken
akan ditampilkan dalam respons jika listingan
belum lengkap. NextContinuationToken
mewakili hasil terakhir
yang ditampilkan. Jika Anda meneruskan nilai
NextContinuationToken
ke parameter continuation-token
dari
permintaan berikutnya, halaman hasil berikutnya akan ditampilkan, dimulai setelah
hasil terakhir.
Contoh respons
HTTP/1.1 200 OK X-goog-metageneration: 5 Content-location: https://example-bucket.storage.googleapis.com?max-keys=2&list-type=2 Expires: Wed, 02 Mar 2022 15:58:11 GMT Content-length: 781 X-guploader-uploadid: ADPycdvFss2qs9wyMrrM2fIIZzTFFnZZM9i9k8TMbHipsxz8PqUjS5Xh_4tLsvb3_YYHTT0HmSYVv1Gtr816HQFnk28HMglyWA Cache-control: private, max-age=0 Date: Wed, 02 Mar 2022 15:58:11 GMT Content-type: application/xml; charset=UTF-8 <?xml version='1.0' encoding='UTF-8'?> <ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'> <Name>example_bucket</Name> <NextContinuationToken>CgtzaGliYS0yLmpwZw==</NextContinuationToken> <KeyCount>2</KeyCount> <MaxKeys>2</MaxKeys> <IsTruncated>true</IsTruncated> <Contents> ... </Contents> ... </ListBucketResult>
Perlu diingat, list-type
harus ditetapkan ke 2
untuk menampilkan
NextContinuationToken
.
Contoh permintaan
GET /?continuation-token=NEXT_CONTINUATION_TOKEN&prefix=t&marker=test&list-type=2 HTTP/1.1 \ Host: BUCKET_NAME.storage.googleapis.com Date: Wed, 02 Mar 2022 16:00:00 GMT Content-Length: 0 Authorization: AUTHENTICATION_STRING
Dengan keterangan:
- NEXT_CONTINUATION_TOKEN adalah nilai
NextContinuationToken
yang Anda terima dari respons sebelumnya. - BUCKET_NAME adalah nama bucket penyimpanan Anda.
- AUTHENTICATION_STRING adalah token akses yang Anda terima dari OAuth 2.0 Playground.
Untuk petunjuk yang lebih mendetail tentang penomoran halaman hasil dari
bucket, lihat dokumentasi referensi XML untuk List Objects
.