---
title: "オブジェクトメタデータの設定"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/stratus/put-object-meta/
description: "このAPIは、バケットの署名を作成できるようにします。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# オブジェクトメタデータの設定

### 説明

このAPIは、バケットに保存されている必要な[オブジェクト](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/)にメタデータを追加できるようにします。バケットはその[一意のバケット名](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)で参照され、必要なオブジェクトはその名前を使用して参照されます。

> **注意:**

* メタデータの記述には、英数字、アンダースコア、またはスペース文字、およびハイフンを使用できます。上記以外の特殊文字は使用できません。

* `HEAD`リクエストメソッドを使用してオブジェクトのメタデータを取得できます。レスポンスでは、メタデータはキー '`x-user-meta`' に一覧表示されます。

* メタデータ全体の最大サイズ制限は**2047**文字です。サイズ制限を決定するために使用される文字数には、キーと値のペアを定義するために使用されるコロン ":"特殊文字も含まれます。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/bucket/object/metadata

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

#### リクエストJSON

以下に示すように、対応する値を含むJSONを送信する必要があります。

**サンプルペイロード**

```json

    {
    "meta_data": {
        "key1": "value1",
        "key2": "value2"
    }
    }

```

この**リクエストJSON**を**リクエストボディ**にフィードし、以下の値を提供する必要があります:

- **meta_data** ( , mandatory):  このJSONには、JSONキーバリューペアの形式で必要な[メタデータ](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#metadata)が含まれます。

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

- **bucket_name** (Alphanumeric, mandatory): [バケットの名前](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/buckets/name-bucket/#ideal-practices-to-name-a-bucket)

- **object_key** (String, mandatory): オブジェクトの完全な名前を含みます。

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

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

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.buckets.objects.CREATE

### レスポンス詳細

正常に実行されると、レスポンスには必要なオブジェクトにメタデータが追加されたことを示す成功メッセージが含まれます。

**リクエスト例**

```bash

curl -X PUT https://api.catalyst.zoho.com/baas/v1/project/10108000003823392/bucket/object/metadata?bucket_name=myBucketName&object_key=image2.png/
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57"
-H "Content-Type:application/json"
-\-data-raw $'{"{"meta_data" : {"key1" : "value1","key2" : "value2"}}"}'

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        "message": "Metadata added successfully"
    }
    }

```

### SDK Documentation

* [Put Object Meta Data - Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/put-object-meta/)
* [Put Object Meta Data - Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/put-object-meta/)
* [Put Object Meta Data - Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/stratus/put-object-meta/)
* [Stratus - Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/stratus/overview/)
* [Stratus - iOS SDK](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/stratus/overview/)
* [Stratus - Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/stratus/overview/)
* [Stratus - Flutter SDK](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/stratus/overview/)