monitor.edit

更改一个监测器

认证和信息传输

此功能需要进行认证authentification。可以通过一般的 HTTP协议或者 HTTPS安全协议

信息传输方法: HTTP POST.

参数

id (必选项)(注解 1)

监测器的ID。必须是整数。

name (注解 1)

监测器的名称。必须是字段 (string), 最多 64 个字符。

url (required)

监测器的链接。使用值: string(2048)

group_id (非必选项)

监测器所在的组的ID。它必须是一个整数并是一个已经存在的组。

group_name (非必选项), 注解 2)

监测器所在的组的名字。name必须是一个整数并最长不超过64个字符。

status (非必选项)

监测器的状态。使用值: 1 = 活动状态/ 0 = 非活动状态. 系统默认值:1

port (非必选项)

控制端口的号码。使用值: 整数(integer)

login (非必选项)

http认证所需要的用户名(username) 使用值: string(32)

password (非必选项)

密码. 使用值: string(32)

match (非必选项)

代表要查找的字段。WebCron在服务器给出的回答中检查是否有或是否包含要查找的字段。使用值: string(255)

contain (非必选项)

确定match给出的字段是否包含在服务器的回答里。使用值: 1 = 应该包含/ 0 = 不应该包含. 系统默认值::1

do_hash (非必选项)

通过比较hash MD5值是否有内容变化。如果您更换一个现有值,请使用1。使用值:1=检查hash / 0=不检查hash

frequence (非必选项)

两次监测的间隔时间,以分钟为单位。使用值: 1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 15 / 20 / 25 / 30 / 35 / 40 / 45 / 50 / 55 / 60 系统默认值::1

post (非必选项)

所有的信息都必须通过http post传输。格式如下:水果=苹果&饮料=咖啡&甜点=无 pie=apple&drink=coffee&desert=none

stations (not required)

Comma separated list of monitor station id's that will monitor. Allowed values: integer and existing id's. Default: all stations

add_stations (not required)

Add new stations automatically to the list of stations. Allowed values: 1 = yes / 0 = no. Default: 1

 

注解1: id和name可被同时使用。如果此情况出现, name不会被作为关键码来处理。如果您不使用name作为关键码,您无需更改name。

 

注解2: group_id和group_name可被同时使用。如果此情况出现, group_name不会被作为关键码来处理。

 

所有的新数值将覆盖原有数值。如果您没有更改监测器频率数值,原有数值将被继续使用。

查询请求实例

http://api.webcron.org/monitor.edit
传输的信息:
id=74978&status=0&frequence=3

服务器的反馈回答

<rsp status="ok">
   <monitor id="74978" modified="2009-02-26 19:23:06" />
</rsp>