CDN加速

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

解析记录管理

更新时间:2020-05-06 16:47:57

新增解析记录
1.接口描述
用于添加域名的解析记录。秒级生效。

接口说明:

  1. 调用URL: https://open.chinanetcenter.com/clouddns/AddRecord
    
  2. 调用频率:240/min
    

2.请求参数
参数

类型

必填

描述

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:返回英文提示结果

3.返回参数
参数

类型

描述

resCode

string

状态码。resCode的详细说明请参见"调度业务状态码"。

msg

string

状态码的详细说明。

recordId

List

主机记录的ID,用于标识该记录。

4.请求示例
https://open.chinanetcenter.com/clouddns/AddRecord
<公共参数>
{
“domainName”:“quansucloud.com”,
“dcName”: “www”,
“dcType”: “A”,
“dcView”: 1002,
“dcValue”: “211.32.43.21”,
“ttl”: 600
}

5.返回示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: {
“recordId”:231009
}
}

修改解析记录
1.接口描述
用于修改解析记录。秒级生效。

接口说明:

  1. 调用URL: https://open.chinanetcenter.com/clouddns/ModifyRecord
    
  2. 调用频率:240/min
    

2.请求参数
参数

类型

必填

描述

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:返回英文提示结果

3.返回参数
参数

类型

描述

resCode

string

状态码。resCode的详细说明请参见"调度业务状态码"。

msg

string

状态码的详细说明。

content

Json

recordId 主机记录的ID,用于标识该记录。

4.请求示例
https://open.chinanetcenter.com/clouddns/ModifyRecord
<公共参数>
{
“recordId”:231009,
“domainName”:“earth12.com.cn”,
“dcName”: “www”,
“dcType”: “A”,
“dcView”: 1002,
“dcValue”: “211.32.43.21”,
“ttl”: 600
}

5.返回示例
{
“resCode”:0,
“msg”:“操作成功”,
“content”: {
“recordId”:231009
}
}
删除解析记录
1.接口描述
用于删除解析记录。秒级生效。

接口说明:

  1. 调用URL: https://open.chinanetcenter.com/clouddns/DelRecord
    
  2. 调用频率:240/min
    

2.请求参数
参数

类型

必填

描述

recordId

Int

主机记录ID

language

string

为空返回中文结果(默认)

en:返回英文提示结果

3.返回参数
参数

类型

描述

resCode

string

状态码。resCode的详细说明请参见"调度业务状态码"。

msg

string

状态码的详细说明。

4.请求示例
https://open.chinanetcenter.com/clouddns/DelRecord
<公共参数>
{
“recordId”:231009
}

5.返回示例
{
“resCode”:0,
“msg”:“操作成功”
}

查询解析记录
1.接口描述
用于查看解析记录的具体信息。秒级生效。

接口说明:

  1. 调用URL: https://open.chinanetcenter.com/clouddns/QueryRecords
    
  2. 调用频率:240/min
    

2.请求参数
参数

类型

必填

描述

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:返回英文提示结果

3.返回参数
参数

类型

描述

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

所属域名名称

4.请求示例
https://open.chinanetcenter.com/clouddns/QueryRecords
<公共参数>
{
“domainName”:“quansucloud.com”,
“dcName”: “www”,
“state”:2,
“dcView”:“中国电信”,
“dcType”:“txt”,
“dcValue”:""
}

5.返回示例
{
“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”:“quansucloud.com”,
“dcViewName”:“默认”,
“dcViewNameEn”:"
"
},
{
“recordId”:231007,
“dcName”:“www”,
“dcType”:“A”,
“dcView”:"*",
“dcValue”:“211.32.43.22”,
“mxPri”:0,
“ttl”:700,
“state”:2,
“auth”:2,
“domainName”:“quansucloud.com”,

“dcViewName”:“默认”,

“dcViewNameEn”:"*"
}
]
}

启停解析记录
1.接口描述
用于批量启停解析记录。秒级生效。

接口说明:

  1. 调用URL: https://open.chinanetcenter.com/clouddns/ControlRecord
    
  2. 调用频率:240/min
    

2.请求参数
参数

类型

必填

描述

domainName

String

域名

recordIds

String

主机记录ID,多个用英文;分隔

operate

Int

操作:1停用;2启用

language

string

为空返回中文结果(默认)

en:返回英文提示结果

3.返回参数
参数

类型

描述

resCode

Int

状态码

msg

String

状态码详细说明

content

List

recordId 主机记录ID

code 状态码
msg 状态码详细说明

4.请求示例
https://open.chinanetcenter.com/clouddns/ControlRecord
<公共参数>
{
“domainName”:“earth12.com.cn”,
“recordIds”:“231007;231009”,
“operate”:1
}

5.返回示例
{
“resCode”:104,
“msg”:“批量操作,部分成功”,
“content”: [
{
“recordId”:231007,
“code”:0,
“msg”:“操作成功”
},
{
“recordId”:231009,
“code”:1,
“msg”:“www|*|A|211.32.43.21:默认线路作为最后一条解析记录,禁止被停用”
}
]
}