文档中心 云解析 解析记录管理

解析记录管理

更新时间: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:默认线路作为最后一条解析记录,禁止被停用”
        }
    ]
}

本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!