URI | /v2/server/create.json |
Method | POST |
参数说明 | Contenty-Type: application/json
$post_data = array( array('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,可通过插件API来获得采集器的信息 当您为任务设置告警时: ‘alert_setting’=>array( ‘alert’=>array( ‘email’=>’user_id1,user_id2,....’, ‘sms’=>’user_id1,user_id2,....’, ‘msn’=>’user_id1,user_id2,....’, ‘gtalk’=>’user_id1,user_id2,....’, ‘remind’=>’user_id1,user_id2,....’, ), ‘scope’=>‘’,//任务公开范围(1:全企业用户 2:指定用户组 3:仅限本人 4:部分用户) *企业用户才需要设置 ‘organization’=>‘id1,id2,…’,//指定用户组的分组ID(只当'scope'设置为2时才需设置) *企业用户才需要设置 ‘user_ids’=>’uid1,uid2,...’//指定用户(只当‘scope’设置为4时才需设置) *企业用户才需要设置 ), ), 当您不为任务设置告警时: ‘open_scope’=>‘’,//任务公开范围(1:全企业用户 2:指定用户组 3:仅限本人 4:部分用户) *企业用户才需要设置 ‘organization’=>‘id1,id2,…’,//指定用户组的分组ID(只当'scope'设置为2时才需设置) *企业用户才需要设置 ‘user_ids’=>’uid1,uid2,...’//指定用户(只当‘scope’设置为4时才需设置) *企业用户才需要设置 ‘task_type’=>array(‘cpu’,‘mem’,...),//服务器监控的任务指标(请参考下面注明) ), Array(……..) , ……. ); //支持批量创建 $data = array('data'=>json_encode($post_data)); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); 注: Window服务器监控任务指标: 'cpu_windows' -> cpu 'mem_windows' -> 内存 'netio', -> 网络流量 'diskstore' -> 磁盘空间 'procsum' -> 系统进程 Linux服务器监控任务指标: 'cpu' -> cpu 'load' -> cpu负载 'mem' -> 内存 'netio' -> 网络流量 'diskstore' -> 磁盘空间 'procsum' -> 系统进程 'diskio' -> 磁盘I/O |
结果(json) | 成功将返回创建的任务的ID 失败状态码:400 err_key->错误行 err_content->错误内容 |
一个例子:
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 } ]