このページは Cloud Translation API によって翻訳されました。

結果をページ分けする

このページでは、さまざまな Cloud Storage ツールとライブラリの処理結果を複数のページに分割する方法について説明します。大量のオブジェクトまたはバケットを一覧表示する場合は、ページ分けが必要になります。

Console

Google Cloud コンソールでは、[バケット] ページと [バケットの詳細] ページに、バケットやオブジェクトのリストが自動的にページ分けされます。

[バケット] ページを開く

コマンドライン

Google Cloud CLI では、バケットとオブジェクトのリストが自動的にページ分けされます。

クライアントライブラリ

C++

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、C++ リファレンスドキュメントで ListObjects() をご覧ください。

C#

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、C# リファレンスドキュメントで ListObjects() をご覧ください。

Go

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、Go リファレンスドキュメントで Bucket.Objects をご覧ください。

Java

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでページトークンが返されます。使用例については、Java リファレンスドキュメントをご覧ください。

Node.js

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、Node.js リファレンスドキュメントで getFiles() をご覧ください。

PHP

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、PHP リファレンスドキュメントで Objects をご覧ください。

Python

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、Python リファレンスドキュメントでページイテレータをご覧ください。

Ruby

クライアントライブラリは、デフォルトでページ分けを実行します。ページ分けをサポートする関数を呼び出すと、レスポンスでイテレータが返されます。このイテレータの使用例については、Ruby リファレンスドキュメントで Google::Cloud::Storage::File::List をご覧ください。

REST API

JSON API

ページ分けをサポートする関数を呼び出したとき、リスト出力が未完了の場合は、レスポンスで継続トークン nextPageToken が返されます。nextPageToken は、返された最後の結果を表します。nextPageToken の値を後続のリクエストの pageToken パラメータに渡すと、最後の結果の後に続く次の結果ページが返されます。

たとえば、my-bucket という名前のバケット内のオブジェクトを一覧表示するリクエストのレスポンスに nextPageToken が含まれているとします。

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

my-bucket でオブジェクトのリスト表示を続行するために使用する HTTP リクエストは次のとおりです。

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

結果のページ分けの詳細については、JSON リファレンスドキュメントで Objects: list または Buckets: list をご覧ください。

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 に設定する必要があります。