URI | /v2/server/create.json |
Method | POST |
参数 |
支持批量创建监控任务 'data' = [ { 'server_name' => 任务名称, 'private_ip' => 服务器IP, 'server_ip' => SNMP IP, 'server_systype' => 系统类型(0:linux 1:windows), 'frequency' => 监控频率(分钟), 'snmp_port' => SNMP代理端口, 'snmp_v' => SNMP传输协议版本(0:2C 1:3), 'snmp_comm' => Community, 'snmp_user' => Security Name, 'snmp_pass' => Pass Phrase, 'snmp_authtype' => Auth Protocol(0:MD5 1:SHA), 'use_agent' => 是否使用插件(0:不适用 1:使用), 'plugin_task_uselist_id' => 选择使用的插件 (插件id可通过插件列表获得,为空数组则不使用插件), 'alert_setting' => 告警设置 { 'alert' => 告警方式 { 'email' => 邮件告警设置(值为用户ID,可通过列出所有用户获得), 'sms' => 短信告警设置(值为用户ID,可通过列出所有用户获得), 'msn' => MSN告警设置(值为用户ID,可通过列出所有用户获得), 'gtalk' => Gtalk告警设置(值为用户ID,可通过列出所有用户获得), 'remind' => 连续告警设置(值为用户ID,可通过列出所有用户获得) }, 'scope' => 设置告警时任务公开范围 (1:全企业用户 2:指定用户组 3:仅限本人 4:部分用户), 'organization' => 指定用户组的分组ID (只当 'scope'设置为2时才需设置,分组ID可通过用户分组信息获得), 'user_ids' => 指定的部分用户的ID (只当 'scope'设置为4时才需设置,用户ID可通过列出所有用户获得) }, 'task_type' => 服务器监控的任务指标(请参考下面注明) Linux服务器监控任务指标: [ 'cpu' => cpu使用率, 'load' => cpu负载, 'mem' => 内存使用率, 'netio' => 网络流量, 'diskstore' => 磁盘空间使用率, 'procsum' => 系统进程数, 'diskio' => 磁盘I/O ] Window服务器监控任务指标: [ 'cpu_windows' => cpu使用率, 'mem_windows' => 内存使用率, 'netio' => 网络流量, 'diskstore' => 磁盘空间使用率, 'procsum' => 系统进程数, ] }, ......... ] |
结果(json) |
成功状态码:200 ,将返回创建的任务task_id 失败状态码:400 ,err_key->错误行 err_content->错误内容 注:当返回400时,err_key表示创建失败的任务,其余任务是创 建成功的。所以修改的时候只需要根据错误类型对该任务的 post数据进行修改即可(服务器API和服务API也是一 样)。 |
一个例子
curl -H "application/x-www-form-urlencoded" --data 'data=[{"server_name":"servername","private_ip":"服务器IP","server_ip":"SNMP IP","server_systype":"0","frequency":"2","snmp_port":"161","snmp_v":"1","snmp_comm":"","snmp_user":"test","snmp_pass":"123456","snmp_authtype":"0","use_agent":"0","plugin_task_uselist_id":"","alert_setting":{"alert":{"email":"286276,288389","sms":"286276,288389","msn":"286276,288389","gtalk":"286276,288389","remind":"286276,288389"},"scope":"1","organization":"","user_ids":""},"task_type":["cpu","load","mem","netio","diskstore","procsum',"diskio"]}]' "https://api.jiankongbao.com/v2/server/create.json?access_token=95e9be13be110ce7a6f3b5de91ad0af479096efb"
说明:access_token通过获取访问token得到。
返回结果
[ { "task_id": 60067 } ]