分頁顯示結果

本頁說明不同的 Cloud Storage 工具和程式庫如何將結果分頁。列出大量物件或值區時，必須使用分頁功能。

控制台

Google Cloud 控制台會自動在「Buckets」和「Bucket details」頁面中，將 bucket 和物件清單分頁。


開啟「Buckets」(儲存桶) 頁面

指令列

Google Cloud CLI 會自動分頁顯示 bucket 和物件清單。

用戶端程式庫

C++

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個迭代器的使用範例，請參閱 ListObjects() 的 C++ 參考文件。

C#

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個迭代器的使用範例，請參閱 ListObjects() 的 C# 參考文件。

Go

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個迭代器的使用範例，請參閱 Bucket.Objects 的 Go 參考文件。

Java

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回頁面符記。如需使用範例，請參閱 Java 參考說明文件。

Node.js

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個迭代器使用方式的範例，請參閱 getFiles() 的 Node.js 參考說明文件。

PHP

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個迭代器的使用範例，請參閱 Objects 的 PHP 參考文件。

Python

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個疊代器的使用範例，請參閱網頁疊代器的 Python 參考文件。

Ruby

用戶端程式庫預設會執行分頁作業。呼叫支援分頁的函式時，回應中會傳回迭代器。如需這個疊代器使用方式的範例，請參閱 Google::Cloud::Storage::File::List 的 Ruby 參考文件。

REST API

JSON API

呼叫支援分頁的函式時，如果清單不完整，回應中會傳回續傳符記 nextPageToken。nextPageToken 代表傳回的最後一個結果。將 nextPageToken 的值傳遞至後續要求的 pageToken 參數時，系統會傳回下一頁結果，從最後一個結果之後開始。

舉例來說，假設您要求列出名為 my-bucket 的值區中的物件，回應中包含 nextPageToken：

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

您會使用下列 HTTP 要求，繼續列出 my-bucket 中的物件：

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

如要進一步瞭解如何將結果分頁，請參閱 Objects: list 或 Buckets: list 的 JSON 參考說明文件。

XML API

呼叫支援分頁的函式時，如果清單不完整，回應中會傳回續傳符記 NextContinuationToken。NextContinuationToken 代表最後傳回的結果。將 NextContinuationToken 的值傳遞至後續要求的 continuation-token 參數時，系統會傳回下一頁的結果，從最後一個結果之後開始。

舉例來說，假設您要求列出名為 my-bucket 的值區中的物件，回應中包含 NextContinuationToken：

<?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>

請注意，如要列出物件時傳回 NextContinuationToken，list-type 必須設為 2。

您用來繼續列出 my-bucket 中物件的 HTTP 要求會包含下列項目：

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

如要進一步瞭解如何透過 bucket 中的結果進行分頁，請參閱 List Objects 的 XML 參考說明文件。

後續步驟