Halaman ini diterjemahkan oleh Cloud Translation API.

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#

Go

Java

Library klien melakukan penomoran halaman secara default. Saat Anda memanggil fungsi yang mendukung penomoran halaman, token halaman akan ditampilkan sebagai respons. Untuk contoh cara penggunaannya, lihat dokumentasi referensi Java.

Node.js

PHP

Python

Ruby

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.

Misalnya, permintaan Anda untuk mencantumkan objek dalam bucket bernama my-bucket berisi nextPageToken dalam respons:

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

Permintaan HTTP yang akan Anda gunakan untuk terus mencantumkan objek di my-bucket adalah sebagai berikut:

GET https://storage.googleapis.com/storage/v1/b/my-bucket/o?pageToken=CgtzaGliYS0yLmpwZw==

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.

Misalnya, permintaan Anda untuk mencantumkan objek dalam bucket bernama my-bucket berisi 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>

Perhatikan bahwa list-type harus ditetapkan ke 2 untuk menampilkan NextContinuationToken saat mencantumkan objek.

Permintaan HTTP yang akan Anda gunakan untuk terus mencantumkan objek di my-bucket akan mencakup hal berikut:

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

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