---
title: "オブジェクトの取得"
url: https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/stratus/get-object/
description: "このページでは、バケットからオブジェクトを取得するためのFlutter SDKメソッドを説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus Component Help Documentation"
    url: /ja/cloud-scale/help/stratus/introduction
  - name: "Java SDK"
    url: /ja/sdk/java/v1/cloud-scale/stratus/get-objects/
  - name: "Node.js SDK"
    url: /ja/sdk/nodejs/v2/cloud-scale/stratus/get-objects/
  - name: "Python SDK"
    url: /ja/sdk/python/v1/cloud-scale/stratus/get-objects/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/get-object/
  - name: "iOS SDK"
    url: /ja/sdk/ios/v2/cloud-scale/stratus/create-bucket-instance/
  - name: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/get-object/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-objects/#GetAllObjects
---

# オブジェクトの取得

このSDKメソッドは、バケットからオブジェクトを取得するために使用できます。レスポンスは**blob**形式で返されます。

バケットで[バージョニング](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/stratus-config/general-settings/#versioning)が有効になっている場合：

* `versionId`を渡さない場合、**最新のオブジェクト**のみが返されます。
* 特定のバージョンを取得するには、有効なバージョンを値として`versionId`クエリパラメータを使用します。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
      <th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`name`</td>
			<td>**String**</td>
      <td>**必須**パラメータ。オブジェクトの名前を保持します。</td>
		</tr>
		<tr>
			<td>`versionId`</td>
      <td>**String**</td>
			<td>**任意**パラメータ。必要なオブジェクトのバージョンの一意のバージョンIDを保持します。</td>
		</tr>
	</tbody>
</table>

```javascript
try {
    ZCatalystBucket bucket = stratus.bucket("testing");
    var (response, object) = await bucket.getObject("SunSet.jpeg", "01hter85pvexb8s2s2842rpswh");
    print('Object Name : ${object.name}');
}
on ZCatalystException catch (ex) {
    print(ex.toString());
}
```

### すべてのオブジェクトの取得

このSDKメソッドは、ページネーション技術を使用してバケット内のすべてのオブジェクトを取得するために使用できます。

**使用パラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w20p">パラメータ名</th>
			<th class="w20p">データ型</th>
      <th class="w60p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`prefix`</td>
			<td>**String**</td>
			<td>**任意**パラメータ。プレフィックス値に一致するオブジェクトを取得します。</td>
		</tr>
		<tr>
			<td>`maxKeys`</td>
			<td>**Number**</td>
			<td>**任意**パラメータ。ページネーションで一覧表示できるオブジェクトの最大数を含みます。</td>
		</tr>
		<tr>
			<td>`continuationToken`</td>
			<td>**String**</td>
			<td>**任意**パラメータ。レスポンスが切り詰められた場合、次のオブジェクトセットを取得するために、このキーの値を同じメソッドに`continuationToken`として渡す必要があります。</td>
		</tr>
	</tbody>
</table>

```javascript
try {
    ZCatalystBucket bucket = app.stratus.bucket("testing");
    var (response, objects, resInfo) = await bucket.getObjects(maxKeys: 5);
    for (var object in objects) {
        print('Object Name : ${object.name}');
    }
    print('Res Info MaxKeys:${resInfo.maxKeys}');
    print('\n\n');
}
on ZCatalystException catch (ex) {
    print(ex.toString());
}
```