アラーム更新 (PUT /v2/alarms/{alarm_id})

既存のアラームの内容を変更します。

{alarm_id}:対象のアラームのIDを指定します。

Request Headers

API共通項目」を参照してください。

Request Parameter

ありません。

Request Body

変更するアラームの情報をJSON形式で指定します。

必須フィールド("name", "type", "threshold_rule", "meter_name", "threshold")は省略できません。その他のフィールドは、省略した場合はデフォルトの値になります。

内容の詳細は、「type Alarm」を参照してください。

Response Headers

ステータス

正常の場合は以下のステータスを返却します。

200:正常終了

異常の場合は、「API共通エラー情報」を参照してください。

Data Type Cardinality
Int 1..1

Response Elements

変更したアラームの情報をJSON形式で返します。

内容の詳細は、「type Alarm」を参照してください。

Example of Request

例:対象のアラーム評価を有効から無効に変更します。


curl -X PUT -H 'Content-Type: application/json' \
-H 'X-Auth-Token: ImFkbWluVVJMIjogImh0dHA6Ly8xMC4x...' \
-d <リクエストボディ> 'https://telemetry.jp-east-1.cloud.global.fujitsu.com/v2/alarms/8278b049-ca2b-4e05-99c9-641c0b692edd'

【リクエストボディ(JSON形式)】
{
    "enabled": false,
    "name": "my_alarm",
    "threshold_rule": {
        "comparison_operator": "gt",
        "meter_name": "my_meter",
        "threshold": 0.0
    },
    "type": "threshold"
}
     

Example of Response


{
    "alarm_actions": [],
    "alarm_id": "8278b049-ca2b-4e05-99c9-641c0b692edd",
    "description": "Alarm when my_meter is gt a avg of 0.0 over 60 seconds",
    "enabled": false,
    "insufficient_data_actions": [],
    "name": "my_alarm",
    "ok_actions": [],
    "project_id": "39bd0d0341484a1a88f8ecdb1b21311c",
    "repeat_actions": false,
    "state": "insufficient data",
    "state_timestamp": "2014-10-24T08:43:30.682976",
    "threshold_rule": {
        "comparison_operator": "gt",
        "evaluation_periods": 1,
        "exclude_outliers": false,
        "meter_name": "my_meter",
        "period": 60,
        "query": [],
        "statistic": "avg",
        "threshold": 0.0
    },
    "time_constraints": [],
    "timestamp": "2014-10-24T08:51:14.940014",
    "type": "threshold",
    "user_id": "9953aae1953a4caab3cc278e3018cf68"
}