---
title: "キャッシュ値の取得"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/cache/get-cache-value/
description: "このAPIを使用すると、キャッシュ内のセグメントからキャッシュアイテムの値を取得できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# キャッシュキーの値の取得

### 説明

このAPIを使用すると、[キャッシュ内のセグメント](https://docs.catalyst.zoho.com/ja/cloud-scale/help/cache/introduction/)からキャッシュアイテムの値を取得できます。セグメントは一意のセグメントIDで参照され、リクエストにはキャッシュアイテムのキーを渡す必要があります。

このAPIを使用すると、キャッシュセグメントにキー・バリューのペアをキャッシュアイテムとして挿入できます。セグメントは一意のIDで参照されます。キーは属性を表し、バリューはキャッシュアイテムのデータです。

キャッシュアイテムの有効期限を任意で指定することもできます。キャッシュアイテムのデフォルトおよび最大有効期間は2日間です。

### リクエスト詳細

#### リクエストURL

`GET` {api-domain}/baas/v1/project/{project_id}/segment/{segment_id}/cache?cacheKey={cache_key}

- **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/)

- **segment_id** (Numerical): キャッシュセグメントの[一意のID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/cache/implementation/#create-a-segment) 

#### クエリパラメーター

- **cache_key** (String): 値を取得するセグメント内の[一意のキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/cache/key-concepts/#cache-items) 

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

**任意のヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.cache.READ

### レスポンス詳細

レスポンスには、`cache_name`、`cache_value`、`expires_in`などのキャッシュアイテムの詳細と、セグメントの詳細が返されます。

**リクエスト例**

```bash
curl -X GET  \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/segment/31000000006023/cache?cacheKey=counter \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        "cache_name": "counter",
        "cache_value": "1344",
        "project_details": {
            "id": 4000000006007,
            "project_name": "ShipmentTracking",
            "project_type": "Live"
        },
        "segment_details": {
            "id": 31000000006023,
            "segment_name": "MailCounters"
        },
        "expires_in": "2019-03-13T18:36:02+05:30",
        "expiry_in_hours": 3,
        "ttl_in_milliseconds": 81187000
    }
}

```

### SDK Documentation

[Retrieve Data from Cache- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/cache/retrieve-data-from-cache)</br></br>
[Retrieve Data from Cache- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/cache/retrieve-data-from-cache)</br></br>
[Retrieve Data from Cache- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/cache/retrieve-data-from-cache)</br></br>