POST /reference_data/map_of_sets/{name} 非推奨

セットのリファレンス・マップのエレメントを追加または更新します。

表 1. POST /reference_data/map_of_sets/{name} リソース詳細
MIME タイプ

application/json

表 2. POST /reference_data/map_of_sets/{name} 要求パラメーター詳細
パラメーター タイプ 必須/オプション データ・タイプ MIME タイプ 説明

name

path

必須

ストリング

text/plain

必須 - エレメントを追加または更新するセットのリファレンス・マップの名前。

key

query

必須

ストリング

text/plain

必須 - 追加または更新するセットのキー。

value

query

必須

ストリング

text/plain

必須 - セットのリファレンス・マップで追加または更新する値。注: 日付値は、1970 年 1 月 1 日の UNIX エポックから経過したミリ秒数で表す必要があります。

source

query

オプション

ストリング

text/plain

オプション - データの発生元を示します。デフォルト値は「reference data api」です。

fields

query

オプション

ストリング

text/plain

オプション - このパラメーターを使用して、応答で返すようにしたいフィールドを指定します。指定されないフィールドは除外されます。サブフィールドは大括弧で囲んで指定し、同じオブジェクト内の複数のフィールドはコンマで区切ります。

表 3. POST /reference_data/map_of_sets/{name} 応答コード
HTTP 応答コード 固有のコード 説明

200

セットのリファレンス・マップでエレメントが追加または更新されました

404

1002

セットのリファレンス・マップが存在しません

422

1005

要求パラメーターが無効です

500

1020

セットのリファレンス・マップでデータを追加または更新するときにエラーが発生しました

応答の説明

エレメントが追加または更新されたセットのリファレンス・マップに関する情報。セットのリファレンス・マップに関する情報が返されますが、含まれているデータは返されません。

応答サンプル

{
    "creation_time": 42,
    "element_type": "String <one of: ALN, NUM, IP, PORT, ALNIC, DATE>",
    "key_label": "String",
    "name": "String",
    "number_of_elements": 42,
    "time_to_live": "String",
    "timeout_type": "String <one of: UNKNOWN, FIRST_SEEN, LAST_SEEN>",
    "value_label": "String"
}