API 文档
取消
文档目录
监控修改
1. 接口描述
本接口 Monitor.Modify 用于监控修改。
接口请求地址:https://dnsapi.cn/Monitor.Modify
HTTP请求方式:POST
2. 请求参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。
参数名 | 是否必须 | 参数描述 |
---|---|---|
monitor_id | 是 | 监控编号。 |
port | 是 | 监控端口,比如80。 |
monitor_interval | 是 | 监控间隔,支持{60 |
monitor_type | 是 | 监控类型,支持{http |
monitor_path | 是 | 监控路径,比如/。 |
points | 是 | 监控节点,用,分隔多个,只能选择列表中的节点,并且有数量限制。 |
bak_ip | 是 | 宕机备用,必选,支持任选以下选项。 |
host | 否 | 监控主机头,比如 www.dnspod.cn。 |
keep_ttl {yes | no} | 否 |
sms_notice | 否 | 短信通知,me域名所有者,share共享用户,用,分隔多选择,比如me,share。 |
email_notice | 否 | 邮件通知,me域名所有者,share共享用户,用,分隔多选择,比如me,share。 |
less_notice {yes | no} | 否 |
callback_url | 否 | 回调URL,宕机了会将相关的参数提交到此设置的URL,具体参考回调URL说明。 |
allback_key | 否 | 回调密钥,如果设置了回调URL请设置此参数以保证安全。 |
bak_ip 选项:
- pass 只监控,不切换。
- pause 老版智能暂停功能,详见/Kb/showarticle/tsid/179%E3%80%82
- pause2 智能暂停v2, 发现ip宕机后直接暂停该记录,无其它规则。
- auto 智能切换。
- 用逗号分隔的IP 设置备用IP。
3. 响应代码
以下请求参数列表仅列出了此接口请求响应代码,除此接口请求响应代码外。还包含 共通返回。
响应码 | 描述 |
---|---|
7 | 监控编号错误。 |
8 | 监控主机头错误。 |
9 | 监控端口错误,端口只能是正整数1~6553510 监控类型不正确。 |
11 | 监控路径不正确。 |
12 | 监控间隔不正确。 |
13 | 监控节点不正确。 |
14 | 监控节点数量超出限制。 |
15 | 备用IP不正确。 |
16 | 备用url不正确。 |
17 | 备用IP不正确。 |
18 | 短信设置不正确。 |
19 | 邮件设置不正确。 |
22 | 回调URL不正确。 |
4. 示例
curl -X POST https://dnsapi.cn/Monitor.Modify -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&monitor_id=51fc9a20-363c-11e2-bab7-0819a6248970&port=80&monitor_type=http&monitor_path=/&monitor_interval=360&points=ctc,cuc&bak_ip=pass'
返回示例如下:
- JSON:
{
"status": {
"code": "1",
"message": "Action completed successful",
"created_at": "2012-11-24 21:41:31"
}
}
最近更新于 2020-10-15 09:46