---
title: "オブジェクトメタデータの設定"
url: https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/stratus/put-object-meta/
description: "このページでは、オブジェクトに保存されているオブジェクトのメタデータを追加するためのNode.js SDKメソッドについて説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "Stratus コンポーネントヘルプドキュメント"
    url: /ja/cloud-scale/help/stratus/introduction
  - name: "オブジェクトメタデータヘルプドキュメント"
    url: /ja/cloud-scale/help/stratus/objects/introduction/#metadata
  - name: "Java SDK"
    url: /ja/sdk/java/v1/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/nodejs/v2/cloud-scale/stratus/create-object-instance/)です。

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

メタ情報はJSONのキーバリューペアとして渡します。例: {"meta_key" : "meta_value"}

> **注意:** 

* 以下のメソッドを使用して、既存の情報を含めずに新しいメタ情報を渡すと、既存の情報が削除され、新しい情報のみが設定されます。これを避けるには、新しいメタ情報と既存のメタ情報を一緒に渡してください。

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

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

* メタデータ全体に許可される最大文字数は**2047**文字です。文字数の算出には、キーバリューペアの定義に使用されるコロン「:」特殊文字も含まれます。

```javascript
const objectMeta = {
"key1": "value1" ,
"key2": "value2" 
};
const objMeta = await objectIns.putMeta(objectMeta);
console.log(objMeta);
```

**レスポンス例**

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