新增觸發器
請求方式:POST
URL: http(s)://api.onenet.hk.chinamobile.com/triggers
我只想看示例!!!
http請求參數
參數名稱 | 格式 | 是否必須 | 說明 |
title | string | 是 | 觸發器名稱 |
ds_id | string | 否 | 可選,數據流名稱,數據流名稱由{obj_id}_{obj_inst_id}_{res_id} 組成 |
dev_ids | array-string | 否 | 可選,設備ID |
ds_uuids | array-string | 否 | 可選,數據流uuid |
url | string | 是 | 告警通知地址 |
type | string | 是 | 觸發條件,見type說明列表 |
threshold | | 是 | 觸發條件門限值,與type配合使用,見type說明列表 |
參數說明
1、觸發器的含義是:當指定範圍內的數據點滿足觸發條件的要求時,會向url參數指定的地址發送post請求;
2、觸發器有三種工作觸發模式
1) 在請求參數中單獨指定了ds_id,不包括其他參數,那麼當前項目下所有設備的數據流中數據流名稱符合ds_id的
數據都會進入觸發判斷邏輯;
2) 在請求參數中單獨指定了ds_uuids數組,那麼只有這些指定的數據流會進入觸發判斷邏輯;
3) 在請求參數中指定了ds_id和dev_ids,那麼只有這些指定的設備的數據流會進入觸發判斷邏輯。
type說明列表
type | 說明 |
> | threshold必須為數值 |
< | threshold必須為數值 |
>= | threshold必須為數值 |
<=< td=""> | threshold必須為數值 |
inout | threshold設置為{"lolmt":40, "uplmt";52},表示數據值進入或離開閉區間[40 52]時觸發 |
change | threshold參數不用傳遞;當上載的值有改變時觸發告警 |
frozen | threshold為數值,指定多少秒內未上報數據觸發告警,同時被監控物件進入frozen狀態 |
live | threshold為數值,指定多少秒後上報數據觸發告警 |
返回參數
參數名稱 | 格式 | 說明 |
errno | int | 調用錯誤碼,為0表示調用成功 |
error | string | 錯誤描述,為"succ"表示調用成功 |
data | json | 介面調用成功之後返回的設備相關信息,見data描述表 |
data描述表
參數名稱 | 格式 | 說明 |
trigger_id | int | 觸發器ID |
請求头部示例
POST http://api.onenet.hk.chinamobile.com/triggers HTTP/1.1
api-key: YHC**************VqKA=
請求參數示例
{
"title": "trigger",
"ds_id": "gps",
"url": "http://aoic.choqf.com",
"type": ">",
"threshold": 100
}
返回示例
{
"errno":0,
"data": {
"trigger_id":123809
},
"error":"succ"
}
觸發數據示例
{
"trigger": {
"id": 123809,
"threshold": 9.0,
"type": ">"
},
"current_data": [{
"dev_id": "2656",
"ds_id": "gps",
"ds_uuid": "FWEF-ZFW-ZFW-ZFWW",
"at": "2009-09-07T12:16:02.001403Z",
"value": 100
}
]
}