Memberi nomor halaman pada hasil

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.


Buka halaman 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.

Langkah berikutnya