退出登录
API 文档
取消
文档目录
服务与支持 API 文档 监控修改
监控修改
文档中心 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 选项：

  1. pass 只监控，不切换。
  2. pause 老版智能暂停功能，详见/Kb/showarticle/tsid/179%E3%80%82
  3. pause2 智能暂停v2, 发现ip宕机后直接暂停该记录，无其它规则。
  4. auto 智能切换。
  5. 用逗号分隔的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
相关文档