URI | /v2/site/create.json |
Method | POST |
参数 |
支持批量创建监控任务 'data' = [ { 'task_name' => 监控任务名称, 'url' => 监控URL(创建网址(http/https)任务需要的参数), 'domain' => 监控域名(创建DNS任务需要的参数), 'dns_type' => DNS查询类型(1:A记录 2:MX记录 3:NS记录 4:CNAME记录 5:TXT记录 6:ANY类型 创建DNS任务需要的参数), 'host' => 主机(填写域名或者IP地址, 创建PING、TCP、UDP、FTP、SMTP、TraceRoute任务需要的参数), 'tcp_port' => TCP端口(创建TCP任务需要的参数), 'ftp_port' => FTP端口(创建FTP任务需要的参数), 'smtp_port' => SMTP端口(创建SMTP任务需要的参数), 'ftp_anonymous' => FTP身份验证选项(0:需要身份验证 1:匿名登登录 创建FTP任务需要的参数), 'udp_port' => UDP端口(创建UDP任务需要的参数), 'request_format' => UDP请求内容格式(0:Binary格式 1:文本格式 创建UDP任务需要的参数) 'request_str' => UDP请求内容(创建UDP任务需要的参数), 'pattern_format' => 匹配响应内容格式(0:Binary格式 1:文本格式 创建UDP任务需要的参数), 'pattern_str' => 匹配响应内容(创建UDP任务需要的参数), 'task_type' => 任务类型(http、ping、dns等), 'frequency' => 监控频率(分钟), 'retry' => 重复次数(1~3), 'monitors' => 使用的监测点 (监测点之间以半角逗号隔开,通过网站监控任务可使用的监测点获得), 'class_id' => 我的网站分组ID(可通过网站监控分组列表获得), 'isAgent' => 是否使用插件(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可通过列出所有用户获得) } ] |
结果(json) |
成功状态码:200 ,将返回创建的任务task_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 } ]