---
title: "アイテムの取得"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/nosql/fetch-item/
description: "このAPIを使用すると、NoSQLテーブルから既存のアイテムを取得できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# アイテムの取得

### 説明

このAPIを使用すると、プロジェクト内の[NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)テーブルからアイテムを取得できます。テーブルは一意のIDまたは名前で参照されます。

取得するアイテムの属性を指定でき、マスターまたはスレーブクラスターから取得する必要があるかどうかも指定できます。

### リクエスト詳細

#### リクエストURL

`GET` {api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item/fetch

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **tableIdentifier** (Numerical): テーブルの[一意のID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/create-manage-tables/)またはテーブル名

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.nosql.item.READ

> **注意:** この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、[Catalyst API前提条件セクション](https://docs.catalyst.zoho.com/ja/api/introduction/overview-and-prerequisites/#prerequisites)を参照してください。

### リクエストJSONプロパティ

- **keys** (json, mandatory): テーブルの[パーティションキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)とソートキーを示します。  

- **required_attributes** (json, optional): 返される属性のリスト。  

- **consistent_read** (json, optional): 読み取りをマスターまたはスレーブから行うかを宣言します。falseに設定すると、スレーブからクエリされます。許容される値：`true`、`false`。  

### レスポンス詳細

レスポンスには、取得操作のステータスと取得されたアイテムが返されます。アイテムのすべての属性または指定された属性が取得されます。

**リクエスト例**

```bash
curl -X GET \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item/fetch \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d '{
	keys:{
		partition_key:{
			"S":"Country"
		},
		sort_key:{
			"N":"EmpID"
		},
	}
	required_attributes: {
		"EmpID",
 	"FirstName",
	"LastName",
	"PriorExperience"
  	},
	consistent_read: "true"
	}'

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        fetched_attributes:{
	"item": {
 	"EmpID": {
  	"N": "10999"
  	},
 	"FirstName":{
  	"S": "Paul"
  	},
 	"LastName":{
  	"S": "Smith"
  	},
 	"PriorExperience":{
  	"BOOL": false
  	}
  	}
    }
	}
	}
    
```

### SDK Documentation

[Fetch Items- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/fetch-items/)</br></br>
[Fetch Items- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/fetch-items/)</br></br>
[Fetch Items- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/fetch-items/)
</br></br>