API 文档
取消
文档目录
    加载中
文档中心 API 文档 设置记录状态

设置记录状态

文档中心 API 文档

注意：本页面提供 API 文档为 DNSPod 传统 API ，仅支持 DNSPod Token。仅限主账号调用，子账号不可用。 推荐使用 腾讯云 API 3.0 ，支持 CAM 权限管理，同时支持主账号、子账号调用。兼容腾讯云 API 密钥，提供 API Explorer、API 调用统计等工具，还可以与腾讯云其他产品更好协同使用。

1. 接口描述

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

2. 请求参数

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

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

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: 记录状态。
最近更新于 2022-01-24 11:42

DNSPod 域名检测工具

查询域名信息，快速排查网站问题

网站自助排障

快速判断问题、提供合适的解决方案

相关文档