---
title: "Objectの取得"
url: https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/stratus/get-object/
description: "このページでは、BucketからObjectまたはObjectを取得するためのiOS 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: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/get-object/
  - name: "Flutter SDK"
    url: /ja/sdk/flutter/v1/cloud-scale/stratus/get-object/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-objects/#GetAllObjects
---

# Objectの取得

このSDKメソッドは、BucketからObjectを取得するために使用できます。レスポンスは**blob**形式で返されます。

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

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

**使用するパラメータ**

<table class="content-table">
	<thead>
		<tr>
			<th class="w30p">パラメータ名</th>
      <th class="w70p">定義</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>`objectKey`</td>
			<td>**必須**パラメータです。Object名を含みます。</td>
		</tr>
		<tr>
			<td>`versionId`</td>
			<td>**オプション**パラメータです。必要なObjectのバージョンの一意のバージョンIDを保持します。</td>
		</tr>
	</tbody>
</table>

```bash
bucketInstance.getObject( objectKey : "{object_name}", versionId : "{version_id}" ) { result in
	switch result {
		case .success( let object ) :
			print( "File Name : \( object.fileName )" )
		case .error(let error) :
			print("Error : \( error )")
	}
}
```

必要なObjectが返されます。

**発生する可能性のある例外**

* **404**: ObjectまたはBucketが見つかりません

### すべてのObjectの取得

このSDKメソッドは、ページネーション技術を使用してBucket内に存在するすべてのObjectを取得するために使用できます。

**使用するパラメータ**

<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>**オプション**パラメータです。プレフィックス値に一致するObjectを取得します。</td>
		</tr>
		<tr>
			<td>`maxKeys`</td>
			<td>**Number**</td>
			<td>**オプション**パラメータです。ページネーションで一覧表示できるObjectの最大数を含みます。</td>
		</tr>
		<tr>
			<td>`continuation_token`</td>
			<td>**String**</td>
			<td>**オプション**パラメータです。レスポンスが切り捨てられた場合、次のObjectのセットを取得するために、このキーの値を同じメソッドに`continuation_token`として渡す必要があります。</td>
		</tr>
	</tbody>
</table>

```bash
var params = ZCatalystQuery.ObjectParams()
params.maxKeys = 10
params.continuationToken = "{continuation_token}"
parmas.prefix = "{prefix}"
bucketInstance.getObjects( withParams : params ) { result in
	switch result {
		case .success( let objects, let response ) :
			for object in objects {
				print("File Name : \( object.fileName  )")
			}
		case .error( let error ) :
			print("Error : \( error )")
	}
}
```

必要なObjectがBlob形式の配列として返されます。

**発生する可能性のある例外**

* **404**: ObjectまたはBucketが見つかりません