API 文档
文档目录
    加载中
服务与支持 API 文档 设置记录状态

设置记录状态

1. 接口描述

本接口 Record.Status 用于设置记录状态。
接口请求地址:https://dnsapi.cn/Record.Status
HTTP请求方式:POST

2. 请求参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。

参数名称 是否必选 描述
domain_id 或 domain 分别对应域名ID和域名, 提交其中一个即可。
record_id 记录ID。
status { enable | disable } 新的状态。

3. 响应代码

以下请求参数列表仅列出了此接口请求响应代码,除此接口请求响应代码外。还包含 共通返回

响应码 描述
-15 域名已被封禁。
6 域名ID错误。
7 非域名所有者。
8 域名无效。
17 记录的值不正确。
21 域名被锁定。
22 子域名不合法。
23 子域名级数超出限制。
24 泛解析子域名错误。
500025 A记录负载均衡超出限制。
500026 CNAME记录负载均衡超出限制。
31 没有添加默认线路的记录、存在冲突的记录(A记录、CNAME记录、URL记录不能共存)
33 AAAA 记录数超出限制。
37 SRV记录超出限制。
41 URL的内容不符合DNSPod解析服务条款。
82 不能添加黑名单中的IP。
110 域名没有备案(显性URL和隐形URL类型) 。

4. 示例

curl -X POST https://dnsapi.cn/Record.Status -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&record_id=16894439&status=disable'

返回示例如下:

  • JSON:
{
    "status": {
        "code": "1",
        "message": "Action completed successful",
        "created_at": "2015-01-18 20:07:29"
    },
    "record": {
        "id": 16909160,
        "name": "@",
        "status": "disable"
    }
}
  • 字段说明:
  • id: 记录ID, 即为 record_id。
  • name: 子域名。
  • status: 记录状态。
最近更新于 2020-10-14 19:56