--- title: "バケット内のオブジェクト一覧取得" url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/list-objects/ description: "このページでは、バケットに格納されているオブジェクトを取得するためのJava SDKメソッドを説明します。" last_updated: 2026-03-30T08:10:30Z service: Cloud Scale type: general related_links: - name: "Stratus Component Help Documentation" url: /ja/cloud-scale/help/stratus/introduction - name: "Node.js SDK" url: /ja/sdk/nodejs/v2/cloud-scale/stratus/list-objects/ - name: "Python SDK" url: /ja/sdk/python/v1/cloud-scale/stratus/list-objects/ - name: "Web SDK" url: /ja/sdk/web/v4/cloud-scale/stratus/overview/ - name: "iOS SDK" url: /ja/sdk/ios/v2/cloud-scale/stratus/get-object/ - name: "Android SDK" url: /ja/sdk/android/v2/cloud-scale/stratus/get-object/ - name: "Flutter SDK" url: /ja/sdk/flutter/v2/cloud-scale/stratus/get-object/ - name: "REST API" url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets --- # バケット内のオブジェクト一覧取得 ### ページネーションによる全オブジェクトの一覧取得 このSDKメソッドを使用すると、特定のバケットに存在するすべてのオブジェクトをページネーションで取得できます。以下のコードスニペットで使用されているBucket参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/create-bucket-instance/)です。 > **Info:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、こちらの[セクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)を参照してください。 各呼び出しでは、限られた数のオブジェクトが返され、次の呼び出しはcontinuationトークンが返された場合にのみ開始されます。 **使用パラメータ**
パラメータ名 データ型 定義
`maxKey` **String** **必須**パラメータです。ページネーションで一覧取得できるオブジェクトの最大数を指定します。
`nextToken` **String** **必須**パラメータです。次のオブジェクトセットを取得するためのトークンを保持します。
`prefix` **String** **任意**パラメータです。プレフィックス値に一致するオブジェクトを一覧取得します。
`orderBy` **String** **任意**パラメータです。オブジェクトを昇順または降順で一覧取得します。**デフォルト値**：`asc`
取得したレスポンスには、バケットの以下のプロパティが含まれ、`moreOptions`に格納されます： * `key count`：返されるオブジェクトの数の値を保持します * `max keys`：返すことができるオブジェクトの最大数 * `Truncated`：バケットがトランケートされているかどうかを通知するステータスを保持します * `contents`：オブジェクトの詳細のリスト * `continuation_token`：リクエストで`continuation_token`を送信した場合、レスポンスに表示されます * `next_continuation_token`：レスポンスがトランケートされた場合、このキーの値を次のオブジェクトセットを取得するために同じメソッドに`continuation_token`として渡す必要があります 各イテレーションで`maxKey`の数のオブジェクトを一覧取得し、`nextToken`が作成されたかどうかを確認します。`nextToken`を使用して、すべてのオブジェクトが一覧取得されるまでイテレーションを続行します。 **以下のパッケージがインポートされていることを確認してください：** ```java import com.zc.component.stratus.ZCBucket; import com.zc.component.stratus.ZCStratus; import com.zc.component.stratus.beans.ZCListObjectOptions; import com.zc.component.stratus.beans.ZCPagedObjectResponse; import com.zc.component.stratus.ZCObject; ``` ```java String nextToken = null; String maxKey = "10"; String prefix = "Sam"; do { ZCListObjectOptions options = new ZCListObjectOptions(); options.setMaxKey(maxKey); // デフォルト: 1000 options.setContinuationToken(nextToken); // 次のページを取得 options.setFolderListing("true"); // デフォルト: false options.setOrderBy("desc"); // デフォルト: "asc" options.setPrefix(prefix); // オプション ZCPagedObjectResponse res = bucket.listPagedObjects(options); System.out.println("Object count: " + res.getKeyCount()); System.out.println("Max key: " + res.getMaxKey()); System.out.println("Is truncated: " + res.getTruncated()); for (ZCObject key : res.getContents()) { System.out.println("Object name: " + key.getKey()); System.out.println("Content type: " + key.getContentType()); System.out.println("Size: " + key.getSize()); System.out.println("Metadata: " + key.getMetaData()); System.out.println("Version ID: " + key.getVersionId()); System.out.println("ETag: " + key.getEtag()); System.out.println("Object type: " + key.getKeyType()); System.out.println("Cached URL: " + key.getCachedUrl()); } nextToken = res.getNextToken(); } while (nextToken != null); ``` ### イテレーションによるオブジェクトの一覧取得 このSDKメソッドを使用すると、イテレーション技法を使用して単一のAPI呼び出しでバケット内のすべてのオブジェクトを取得できます。以下のコードスニペットで使用されているBucket参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/create-bucket-instance/)です。 > **Info:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、こちらの[セクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)を参照してください。 **以下のパッケージがインポートされていることを確認してください：** ```java import java.util.Iterator; import com.zc.component.stratus.ZCObject; import com.zc.component.stratus.beans.ZCListObjectOptions; import java.util.List; ``` ```java ZCListObjectOptions options = new ZCListObjectOptions(); options.setFolderListing("true"); // デフォルト: false options.setMaxKey("2"); // デフォルト: 1000 options.setOrderBy("desc"); // デフォルト: "asc" // イテラブルオブジェクトリストを取得する Iterable<List<ZCObject>> paginationIterable = bucket.listIterableObjects(options); Iterator<List<ZCObject>> iterator = paginationIterable.iterator(); while (iterator.hasNext()) { List<lZCObject> objectList = iterator.next(); for (ZCObject obj : objectList) { System.out.println(obj.getKey()); } } ```