---
title: "オブジェクトメタデータの設定"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/put-object-meta/
description: "このページでは、オブジェクトに格納されているオブジェクトのメタデータを追加するためのJava 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: "Object Metadata Help Documentation"
    url: /ja/cloud-scale/help/stratus/objects/introduction/#metadata
  - name: "Node.js SDK"
    url: /ja/sdk/nodejs/v2/cloud-scale/stratus/put-object-meta/
  - name: "Python SDK"
    url: /ja/sdk/python/v1/cloud-scale/stratus/put-object-meta/
  - name: "Web SDK"
    url: /ja/sdk/web/v4/cloud-scale/stratus/overview/
  - name: "iOS SDK"
    url: /ja/sdk/ios/v2/cloud-scale/stratus/overview/
  - name: "Android SDK"
    url: /ja/sdk/android/v2/cloud-scale/stratus/overview/
  - name: "Flutter SDK"
    url: /ja/sdk/flutter/v2/cloud-scale/stratus/overview/
  - name: "REST API"
    url: /ja/api/code-reference/cloud-scale/stratus/get-all-buckets/#GetAllBuckets
---

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

以下のSDKメソッドを使用して、Stratusのバケットに格納されている特定のオブジェクトに[メタ詳細](https://docs.catalyst.zoho.com/ja/cloud-scale/help/stratus/objects/introduction/#metadata)を追加できます。以下のコードスニペットで使用されているObject参照は、[コンポーネントインスタンス](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/stratus/create-object-instance/)です。

> **Info:** このSDKメソッドを使用するには、**Admin**スコープで初期化する必要があります。この要件の詳細については、こちらの[セクション](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/overview/#initialize-sdk-with-scopes)を参照してください。

メタ詳細はJSONのキーバリューペアとして渡されます。例：{"meta_key" : "meta_value"}

> **Note:**

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

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

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

#### サンプルコードスニペット

**Package Imports**

```java
import org.json.simple.JSONObject;
import java.util.HashMap;
```

```java
HashMap<String, String> objectMeta = new HashMap<>();
objectMeta.put("key1", "value1");
objectMeta.put("key2", "value2");
JSONObject res = object.putMeta(objectMeta);
System.out.println(res);
```

> **Note:** このメソッドを使用して既存の詳細を含めずに新しいメタ詳細を渡すと、既存の詳細が削除され、新しい詳細のみが設定されます。これを避けるには、既存のメタ詳細とともに新しいメタ詳細を渡してください。

**レスポンス例**

```json
{
    "message": "Metadata added successfully"
}
```