monitor.state

监测器的状态.

认证和信息传输

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

信息传输方法: HTTP GET.

参数

id (非必选项)

一个或多个监测器的ID。必须使用整数并且监测器必须存在。

name (非必选项)

如果您使用监测器的名称来获得信息,您只能获得一个监测器的状态。您不能像使用id 或group_id一样向多个监测器发出指令。逗号不可以被使用。使用值只能是 :string (64).

group_id (非必选项)

监测器组的ID。 如果您使用组ID,该组内所有的监测器的状态会被接收。您只能使用一个整数,并且该组必须存在。

state (非必选项)

状态。 使用值 : ok / error

如果没有此参数,您获得所有监测器的状态。

查询请求实例

http://api.webcron.org/monitor.state/id:74978,83445,83446

服务器的反馈回答

<rsp status="ok" total="2">
   <monitor id="74978" name="Server A" enabled="1" state="ok" />
   <monitor id="83445" name="Server B" enabled="0" />
   <monitor id="83446" name="Server C" enabled="1" state="error" since="2009-02-26 16:02:14" />
</rsp>