新規監視項目・サンプルの登録 (POST /v2/meters/{meter_name})
新しい監視項目、ならびに新規サンプルを登録します。
{meter_name}:登録する監視項目名を指定します。ただし、" fcx. (ドット)"から始まる監視項目名は指定できません。
注意:
アラームの評価(しきい値監視)は監視サービス内部の監視間隔(60秒)に従って行われます。そのため、サンプルを登録するタイミングによっては、登録したサンプルがアラームの評価の対象となるのは、現在の監視間隔ではなく、次回の監視間隔になる場合があります。
Request Headers
「API共通項目」を参照してください。
Request Parameter
ありません。
Request Body
登録するサンプルのリストをJSON形式で指定します。
一度に最大で20個のサンプルを指定可能です(監視項目名は全て同じにする必要があります)。
また、{meter_name}に指定する監視項目名と、Request Bodyのcounter_nameに指定する監視項目名は一致している必要があります。
内容の詳細は、「type OldSample」を参照してください。
Response Headers
ステータス
正常の場合は以下のステータスを返却します。
201:正常終了
異常の場合は、「API共通エラー情報」を参照してください。
Data Type | Cardinality |
---|---|
Int | 1..1 |
Response Elements
登録したサンプルのリストをJSON形式で返します。
内容の詳細は、「type OldSample」を参照してください。
Example of Request
例:監視項目名が"my_meter"のサンプルを登録する。
curl -X POST -H 'Content-Type: application/json' \
-H 'X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x...' \
-d <リクエストボディ> "https://telemetry.jp-east-1.cloud.global.fujitsu.com/v2/meters/my_meter"
【リクエストボディ(JSON形式)】
[
{
"counter_name": "my_meter",
"counter_type": "gauge",
"counter_unit": "instance",
"counter_volume": 2.0,
"resource_id": "my_resource",
"resource_metadata": {
"my_metadata": "test",
"my_metadata2": "test2"
},
"source": "my_source",
"timestamp": "2014-06-12T07:01:07.428799"
}
]
Example of Response
[
{
"counter_name": "my_meter",
"counter_type": "gauge",
"counter_unit": "instance",
"counter_volume": 2.0,
"message_id": "5a016f38-5b39-11e4-9966-fa163e0aad81",
"project_id": "39bd0d0341484a1a88f8ecdb1b21311c",
"resource_id": "my_resource",
"resource_metadata": {
"my_ metadata": "test",
"my_metadata2": "test2"
},
"source": "39bd0d0341484a1a88f8ecdb1b21311c:my_source",
"timestamp": "2014-06-12T07:01:07.428799",
"user_id": "9953aae1953a4caab3cc278e3018cf68"
}
]