获取记录信息
注意:本页面提供 API 文档为 DNSPod 传统 API ,仅支持 DNSPod Token。仅限主账号调用,子账号不可用。 推荐使用 腾讯云 API 3.0 ,支持 CAM 权限管理,同时支持主账号、子账号调用。兼容腾讯云 API 密钥,提供 API Explorer、API 调用统计等工具,还可以与腾讯云其他产品更好协同使用。
1. 接口描述
本接口 Record.Info 用于获取记录信息。
接口请求地址:https://dnsapi.cn/Record.Info
HTTP请求方式:POST
2. 请求参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 公共请求参数页面。
参数名称 | 是否必选 | 类型 | 描述 |
---|---|---|---|
domain_id 或 domain | 是 | Integer 或 String | 分别对应域名ID和域名, 提交其中一个即可。 |
record_id | 是 | Integer | 记录ID。 |
remark | 是 | String | 域名备注,删除备注请提交空内容。 |
3. 响应代码
以下参数列表仅列出了此接口响应代码,除此接口请求响应代码外。还包含 共通返回码。
响应码 | 描述 |
---|---|
6 | 域名 ID 错误。 |
7 | 记录开始的偏移无效、非域名所有者。 |
8 | 域名无效。 |
13 | 当前域名有误,请返回重新操作。 |
4. 示例
curl -X POST https://dnsapi.cn/Record.Info -d 'login_token=LOGIN_TOKEN&format=json&domain_id=2317346&record_id=16894439'
返回示例如下:
- JSON:
{
"status": {
"code": "1",
"message": "Action completed successful",
"created_at": "2016-08-12 17:51:25"
},
"domain": {
"id": "9842292",
"domain": "yizerowu.com",
"domain_grade": "DP_Free"
"dnspod_ns": [
"ns3.dnsv3.com",
"ns4.dnsv3.com"
]
},
"record": {
"id": "44146112",
"sub_domain": "yizerowwwww",
"record_type": "A",
"record_line": "联通",
"record_line_id": "10=1",
"value": "12.3.3.3",
"weight": null,
"mx": "0",
"ttl": "600",
"enabled": "1",
"monitor_status": "",
"remark": "",
"updated_on": "2016-08-12 17:07:05",
"domain_id": "9842292"
}
}
字段说明:
-
domain:
-
id: 域名ID,即为 domain_id。
-
domain: 域名。
-
domain_grade: 域名等级,详见 Domain.List 或 Domain.Info 接口。
-
dnspod_ns: 域名等级对应的 ns 服务器地址。
-
record:
-
id: 记录ID编号。
-
sub_domain: 子域名(主机记录)。
-
record_type: 记录类型, 详见 Record.Type 接口。
-
record_line: 解析记录的线路, 详见 Record.Line 接口。
-
record_line_id: 解析记录的线路ID,详见 Record.Line 接口。
-
value: 记录值。
-
mx: 记录的 MX 记录值, 非 MX 记录类型,默认为 0。
-
ttl: 记录的 TTL 值。
-
enabled: 记录状态:
- “0”: 禁用
- “1”: 启用
-
monitor_status: 该记录的 D 监控状态:
- “Ok”: 服务器正常。
- “Warn”: 该记录有报警, 服务器返回 4XX。
- “Down”: 服务器宕机。
- “”: 该记录未开启D监控。
-
remark: 记录备注。
-
updated_on: 记录最后更新时间。
-
domain_id: 域名ID, 即为 domain_id。
DNSPod 域名检测工具
查询域名信息,快速排查网站问题
网站自助排障
快速判断问题、提供合适的解决方案