URI | /v2/site/create.json |
Method | POST |
参数说明 | 可支持批量创建: $post_array = array( array( ‘task_name’=> ‘’, //监控项目名称 ‘task_type’=> ‘’, //任务类型 ‘frequency’ => ‘’, //监控频率(分钟) ‘retry’=> ‘’, //重复次数(1~3) ‘monitors’=> ‘’, //使用的监测点(监测点之间以半角逗号隔开.可通过/v2/site/monitors.json接口获得) ‘class_id’=> ‘’, //我的网站分组ID ‘isAgent’ => ‘’, //是否使用插件(0:不使用 1:使用) ‘plugin_task_uselist_id ’=>array(), // array(插件id1,id2,...) 当您要给任务设置告警设置时: ‘alert_setting’ =>array( ‘alert’=>array( ‘email’ =>‘user_id1,user_id2,…’, //email ‘sms’ =>‘user_id1,user_id2,…’, //手机 ‘msn’ =>‘user_id1,user_id2,…’, //msn ‘gtalk’ =>‘user_id1,user_id2,…’, //gtalk ‘remind’=>‘user_id1,user_id2,…’ //连续告警 ), ‘scope’=>‘’, //企业用户才需设置 ‘organization’=>’group_id1,group_id2,....’//(只当 ‘scope’设置为2时才需设置) ‘user_ids’=>’user_id1,user_id2,.....’//(只当‘scope’设置为4时才需设置) ), 当您不给任务设置告警设置时: ‘open_scope’=>‘’, //任务公开范围(1:全企业用户 2:指定用户组 3:仅限本人 4:部分用户) *企业用户才需要设置 ‘organization’=>‘id1,id2,…’, //指定用户组的分组ID(只当 ‘scope’设置为2时才需设置) *企业用户才需要设置 ‘user_ids’=>‘id1,id2,…’, //指定的部分用户的ID(只当 ‘scope’设置为4时才需设置) *企业用户才需要设置 redirect=》重定向(on是勾选,默认不勾选) HTTP监控 ‘submit_method’,HTTP请求方法 ‘param’ =>提交内容 (submit_method=1,post的时候该参数有效) DNS监控 dns_type=》DNS查询类型 use_dns_ip=>指定IP地址(当dns_type=1,也就是A的时候生效) metric_ip=》ip地址(当dns_type为A,并且use_dns_ip=1的时候生效) use_dns_domain=》指定域名地址(当dns_type=3,也就是NS的时候生效) metric_domain=》域名(当dns_type为NS,并且use_dns_domain=1的时候生效)
(其余字段请参考/v2/site/info/${task_id}.json接口的参数说明) ), ); $post_data = array(‘data’=>json_encode($post_array)); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); |
结果(json) | 成功将返回创建的任务的ID; 失败状态码:400 err_key->错误行 err_content->错误内容 注: 当返回400时,err_key表示创建失败的任务,其余任务是创建成功的。所以修改的时候只需要根据错误类型对该任务的post数据进行修改即可(服务器API和服务API也是一样)。 |
一个例子:
curl -H "application/x-www-form-urlencoded" --data 'data=[{"task_name":"接口创建","url":"http://www.jiankongbao.com","task_type":"http","frequency":"5","retry":"1", "monitors":"1,2,11,14,107,108,112,118,120,123","class_id":"","isAgent":"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":""}}]' "https://api.jiankongbao.com/v2/site/create.json?access_token=95e9be13be110ce7a6f3b5de91ad0af479096efb" 说明:access_token通过获取访问token得到。
返回结果:
[ { "task_id": 756201 } ]