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, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman dengan menentukan opsi dalam permintaan. 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, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman dengan menentukan opsi dalam permintaan. 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, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman menggunakan opsi kueri atau penomoran halaman. 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, metode ini akan menampilkan token halaman. Anda dapat mengontrol ukuran halaman menggunakan opsi pageSize. Untuk contoh cara penggunaannya, lihat dokumentasi referensi Java.

Node.js

Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi yang mendukung penomoran halaman, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman menggunakan opsi kueri (seperti maxResults). 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, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman menggunakan opsi seperti maxResults. 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, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman menggunakan opsi seperti max_results atau page_size. Untuk contoh cara penggunaan iterator ini, lihat dokumentasi referensi Python untuk iterator halaman.

Ruby

Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi yang mendukung penomoran halaman, metode ini akan menampilkan iterator. Anda dapat mengontrol ukuran halaman menggunakan opsi seperti max. Untuk contoh cara penggunaan iterator ini, lihat dokumentasi referensi Ruby untuk Google::Cloud::Storage::File::List.

REST API

JSON API

Untuk mengontrol jumlah hasil yang ditampilkan per halaman, gunakan parameter kueri maxResults dalam permintaan ke Objects: list atau Buckets: list. Misalnya, untuk mencantumkan maksimum 5 objek sekaligus:

GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o?maxResults=5

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.

Misalnya, permintaan untuk mencantumkan objek di BUCKET_NAME dapat menampilkan nextPageToken dalam respons:

{
  "kind": "storage#objects",
  "nextPageToken": "CgtzaGliYS0yLmpwZw==",
  "items": [
    {
      OBJECT_1_METADATA
    },
    {
      OBJECT_2_METADATA
    },
    …
  ]
}

Untuk menampilkan halaman hasil berikutnya, dimulai setelah hasil terakhir, teruskan nilai nextPageToken ke parameter pageToken dari permintaan berikutnya:

GET https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o?pageToken=CgtzaGliYS0yLmpwZw==

Anda dapat menggabungkan maxResults dan pageToken dalam permintaan yang sama untuk melanjutkan pencantuman dengan ukuran halaman tertentu.

Untuk informasi selengkapnya tentang penomoran halaman hasil, lihat dokumentasi referensi JSON untuk Objects: list atau Buckets: list.

XML API

Untuk mengontrol jumlah hasil yang ditampilkan per halaman, gunakan parameter kueri max-keys dalam permintaan ke List Objects. Misalnya, untuk mencantumkan maksimum 5 objek sekaligus:

GET /?max-keys=5 HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com

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.

Misalnya, permintaan untuk mencantumkan objek di BUCKET_NAME dapat menampilkan NextContinuationToken dalam respons:

<?xml version='1.0' encoding='UTF-8'?>
<ListBucketResult xmlns='http://doc.s3.amazonaws.com/2006-03-01'>
  <Name>my-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 saat mencantumkan objek.

Untuk menampilkan halaman hasil berikutnya, dimulai setelah hasil terakhir, teruskan nilai NextContinuationToken ke parameter continuation-token dari permintaan berikutnya:

GET /?continuation-token=CgtzaGliYS0yLmpwZw==&list-type=2 HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com

Anda dapat menggabungkan max-keys dan continuation-token dalam permintaan yang sama.

Untuk petunjuk yang lebih mendetail tentang penomoran halaman hasil dari bucket, lihat dokumentasi referensi XML untuk List Objects.

Langkah berikutnya