Loading...

お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

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

説明

このAPIは、バケットに保存されている必要なオブジェクトにメタデータを追加できるようにします。バケットはその一意のバケット名で参照され、必要なオブジェクトはその名前を使用して参照されます。

注意:

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

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

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

リクエスト詳細

リクエストURL

POST

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

copy

project_id
Numerical
プロジェクトの一意のID

リクエストJSON

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

サンプルペイロード
copy
{
"meta_data": {
    "key1": "value1",
    "key2": "value2"
}
}
View more

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

meta_data
mandatory
このJSONには、JSONキーバリューペアの形式で必要なメタデータが含まれます。

クエリパラメータ

bucket_name Alphanumeric
mandatory
object_key String
mandatory
オブジェクトの完全な名前を含みます。

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}

オプションヘッダー

CATALYST-ORG: {org_id}

Environment: Development

スコープ

ZohoCatalyst.buckets.objects.CREATE

レスポンス詳細

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

リクエスト例
copy

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”}}"}'

レスポンス例
copy
{
"status": "success",
"data": {
    "message": "Metadata added successfully"
}
}
View more