CA App Synthetic Monitor API 24.7.7/24.7.7 : rule_don

Check an existing rule, maximum num times, and return results. Cache if needed. Does not trigger notifications, does not perform second opinion check.

price: (varies)
Monitor Type Cost
script_firefox 10 check credit(s)
browser 5 check credit(s)
script 5 check credit(s)
other 1 check credit
cache only 0.1 check credit

Monitor Type	Cost
script_firefox	10 check credit(s)
browser	5 check credit(s)
script	5 check credit(s)
other	1 check credit
cache only	0.1 check credit

<<back to index

parameter	type	default / required*	notes
nkey	token	*	Session key or token. Automatically assigned (only if optional) or obtained via acct_login/acct_token call.
acct	string		Account e-mail. If left empty, then the request is on behalf of the account that is logged in (nkey).
name	string (80)	*	Name of monitor (rule).
format	enum (xml, csv, xls, tab, stream)	xml	Output format for this call.
num	unsigned int	3	Number of results to return.
cache_only	boolean	n	Use cached data only.
callback	string		Callback function for JSONP style calls. When this parameter is given, the result will be JSON instead of XML.
view	enum (xml, json)	xml	Specifies the desirable representation of the output (XML or JSON). HTTP Accept header can be used and has precedence.

Result:

<result>
  <message> string </message>
  <probes>
    <probe>
      <start> datetime </start>
      <result> int </result>
      <descr> string </descr>
      <loc> string </loc>
      <source> unsigned int </source>
      <rtime> unsigned int </rtime>
      <ctime> unsigned int </ctime>
      <ptime> unsigned int </ptime>
      <dtime> unsigned int </dtime>
      <ttime> unsigned int </ttime>
      <dsize> unsigned int </dsize>
      <utime> unsigned int </utime>
    </probe>
    ...
  </probes>
</result>

(presence of output fields depends on input parameters)

Error codes:

code	description
0	okay
1000	authentication error
1001	call syntax error
1002	undefined name or id
1003	account limit exceeded
1004	database error
1005	duplicate entry
1006	upgrade account
1007	not yours (anymore)
1008	session expired
1009	insufficient credits
1010	messaging error
1011	undefined result
1012	cannot perform that operation
1013	illegal parameter value
1014	TOS restriction
1015	unconfirmed address
1016	contact helpdesk first
9999	unsupported feature
1017	value not allowed

<<back to index