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-09-08 11:24