更新时间:2023-09-15 17:02:14
1.新增解析记录
接口描述
用于添加域名的解析记录。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName String 是 需要添加解析记录的域名
dcName String 是 主机记录
dcType String 是 记录类型
CloudDNS支持的记录类型:A、AAAA、CNAME、TXT、SRV、MX
dcView Int 是 线路
线路的对应表请参考附录
dcValue String 是 记录值
(SRV类型特殊格式:优先级、空格、权重、空格、端口号、空格、目标地址)
(RP格式:邮箱、空格、域名)
mxPri Int 否 MX优先级
如果“记录类型”选择“MX”,则需配置该参数。
取值范围为1~1000,默认为5。数值越小,则优先级越高。
ttl Int 是 指缓存的生存时间。默认可配置为600s。
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码。resCode的详细说明请参见“调度业务状态码”。
msg string 状态码的详细说明。
recordId List 主机记录的ID,用于标识该记录。
请求示例
#!/bin/bash
username=“example_username”
apiKey=“example_apiKey”
date=env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"
password=echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64
curl -i --url “https://open.chinanetcenter.com/clouddns/AddRecord”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”:“earth12.com.cn”,
“dcName”: “www”,
“dcType”: “A”,
“dcView”: “*”,
“dcValue”: “211.32.43.21”,
“ttl”: 600
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: {
“recordId”:231009
}
}
2.修改解析记录
接口描述
用于修改解析记录。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
recordId Int 是 主机记录ID
domainName String 是 需要添加解析记录的域名
dcName String 是 主机记录
dcType String 是 记录类型
CloudDNS支持的记录类型:A、AAAA、CNAME、TXT、SRV、MX
dcView Int 是 线路
线路的对应表请参考附录
dcValue String 是 记录值
(SRV类型特殊格式:优先级、空格、权重、空格、端口号、空格、目标地址)
(RP格式:邮箱、空格、域名)
mxPri Int 否 MX优先级
如果“记录类型”选择“MX”,则需配置该参数。
取值范围为1~1000,默认为5。数值越小,则优先级越高。
ttl Int 是 指缓存的生存时间。默认可配置为600s。
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码。resCode的详细说明请参见“调度业务状态码”。
msg string 状态码的详细说明。
content Json recordId 主机记录的ID,用于标识该记录。
请求示例
#!/bin/bash
username=“example_username”
apiKey=“example_apiKey”
date=env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"
password=echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64
curl -i --url “https://open.chinanetcenter.com/clouddns/ModifyRecord”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“recordId”:231009,
“domainName”:“earth12.com.cn”,
“dcName”: “www”,
“dcType”: “A”,
“dcView”: “*”,
“dcValue”: “211.32.43.21”,
“ttl”: 600
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: {
“recordId”:231009
}
}
3.删除解析记录
接口描述
用于删除解析记录。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
recordId Int 是 主机记录ID
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode string 状态码。resCode的详细说明请参见“调度业务状态码”。
msg string 状态码的详细说明。
请求示例
#!/bin/bash
username=“example_username”
apiKey=“example_apiKey”
date=env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"
password=echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64
curl -i --url “https://open.chinanetcenter.com/clouddns/DelRecord”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“recordId”:231009
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”
}
4.查看解析记录
接口描述
用于查看解析记录的具体信息。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName String 是 需要查询解析记录的域名
param String 否 模糊查询 (如果需要精确查询,则这个参数不填)。根据此查询参数对“主机记录”,“记录类型”,“记录值”进行模糊查询
dcName String 否 主机记录 (精确查询)
dcType String 否 记录类型(精确查询)
CloudDNS支持的记录类型:A、AAAA、CNAME、TXT、SRV、RP、MX
dcView String 否 线路中文名称(精确查询)例如:中国电信
dcViewId String 否 线路ID(精确查询)
dcValue String 否 记录值(精确查询)
state Int 否 解析记录状态。(精确查询)正常:2 停用:1 全部:0
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode Int 状态码
msg String 状态码详细说明
recordId Int 主机记录ID
dcName String 主机记录
dcType String 记录类型
CloudDNS支持的记录类型:A、AAAA、CNAME、TXT、SRV、RP、MX
dcView Int 线路
线路的对应表请参考附录
dcViewName string 线路中文名
dcViewNameEn string 线路英文名
dcValue String 记录值
state Int 解析记录状态。正常:2 停用:1
mxPri Int MX优先级
如果“记录类型”选择“MX”,则需配置该参数。
取值范围为1~50,默认为5。数值越小,则优先级越高。
ttl Int 指缓存的生存时间。默认可配置为600s。
auth int 操作权限:1、只读 2、读写
domainName string 所属域名名称
请求示例
#!/bin/bash
username=“example_username”
apiKey=“example_apiKey”
date=env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"
password=echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64
curl -i --url “https://open.chinanetcenter.com/clouddns/QueryRecords”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”:“earth12.com.cn”,
“dcName”: “www”,
“state”:2,
“dcView”:“中国电信”,
“dcType”:“txt”,
“dcValue”:""
}’
响应示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: [
{
“recordId”:231009,
“dcName”:“www”,
“dcType”:“A”,
“dcView”:"",
“dcValue”:“211.32.43.21”,
“mxPri”:0,
“ttl”:600,
“state”:2,
“auth”:1,
“domainName”:“earth12.com.cn”,
“dcViewName”:“默认”,
“dcViewNameEn”:""
},
{
“recordId”:231007,
“dcName”:“www”,
“dcType”:“A”,
“dcView”:"*",
“dcValue”:“211.32.43.22”,
“mxPri”:0,
“ttl”:700,
“state”:2,
“auth”:2,
“domainName”:“earth12.com.cn”,
“dcViewName”:“默认”,
“dcViewNameEn”:"*"
}
]
}
5.启停解析记录
接口描述
用于批量启停解析记录。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName String 是 域名
recordIds String 是 主机记录ID,多个用英文;分隔
operate Int 是 操作:1停用;2启用
language string 否 为空返回中文结果(默认)
en:返回英文提示结果
返回参数
参数 类型 描述
resCode Int 状态码
msg String 状态码详细说明
content List recordId 主机记录ID
code 状态码
msg 状态码详细说明
请求示例
#!/bin/bash
username=“example_username”
apiKey=“example_apiKey”
date=env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"
password=echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64
curl -i --url “https://open.chinanetcenter.com/clouddns/ControlRecord”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”:“earth12.com.cn”,
“recordIds”:“231007;231009”,
“operate”:1
}’
响应示例
{
“resCode”:104,
“msg”:“批量操作,部分成功”,
“content”: [
{
“recordId”:231007,
“code”:0,
“msg”:“操作成功”
},
{
“recordId”:231009,
“code”:1,
“msg”:“www|*|A|211.32.43.21:默认线路作为最后一条解析记录,禁止被停用”
}
]
}