文档中心 云解析 域名管理

域名管理

更新时间:2023-09-15 17:02:13

1.新增域名
接口描述
用于添加域名。CloudDNS支持批量添加多个域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName string 是 添加的域名,如果添加多个域名,用英文半角分号分隔。
language string 否 为空返回中文结果(默认),en:返回英文提示结果

返回参数
参数 类型 描述
resCode string 状态码,详细说明请参见“业务状态码”。
msg string 状态码的详细说明。
content List 域名的详细说明。

请求示例
#!/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/AddDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “earth12.com.cn;youth.com;k45.com”
}’

响应示例
{
    “resCode”:0,
    “msg”:“操作成功”,
    “content”: [
         {
            “domainId”:6203,
            “domainName”:“earth12.com.cn”,
            “ret”:“Success”,
            “msg”:“操作成功”,
            “msgEn”:null,
            “result”:null,
            “code”:0,
            “success”:true
        },
         {
            “domainId”:6204,
            “domainName”:“youth.com”,
            “ret”:“Success”,
            “msg”:“操作成功”,
            “msgEn”:null,
            “result”:null,
            “code”:0,
            “success”:true
        },
         {
            “domainId”:6205,
            “domainName”:“k45.com”,
            “ret”:“Success”,
            “msg”:“操作成功”,
            “msgEn”:null,
            “result”:null,
            “code”:0,
            “success”:true
        }
    ]
}

2.删除域名
接口描述
用于批量删除域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。
请求参数
参数 类型 必填 描述
domainName string 是 删除的域名
如果需要删除多个域名,用英文半角分号分隔。
language string 否 为空返回中文结果(默认)
en:返回英文提示结果

返回参数
参数 类型 描述
resCode string 状态码,resCode的详细说明请参见“业务状态码”。
msg string 状态码的详细说明。
content List 域名的详细说明。
domainId 域名ID
domainName 域名名称
ret 成功或失败标识
msg 成功或失败提示
msgEn 成功或失败提示

请求示例
#!/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/DelDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “earth12.com.cn;youth.com;k45.com”
}’

响应示例
{
    “resCode”:0,
    “msg”:“操作成功”,
    “content”: [
         {
            “domainId”:6203,
            “domainName”:“earth12.com.cn”,
            “ret”:“Success”,
            “msg”:“删除成功”,
            “msgEn”:“delete success”,
            “result”:null,
            “code”:0,
            “success”:true
        },
         {
            “domainId”:6204,
            “domainName”:“youth.com”,
            “ret”:“Success”,
            “msg”:“删除成功”,
            “msgEn”:“delete success”,
            “result”:null,
            “code”:0,
            “success”:true
        },
         {
            “domainId”:6205,
            “domainName”:“k45.com”,
            “ret”:“Success”,
            “msg”:“删除成功”,
            “msgEn”:“delete success”,
            “result”:null,
            “code”:0,
            “success”:true
        }
    ]
}

3.查询域名
接口描述
用于查询用户的域名及域名信息。建议调用频率1200次/5min。
请求参数
参数 类型 必填 描述
domainName String 否 如果没有填写域名,则返回该用户的所有域名及域名相应信息。
pageIndex int 否 分页查询页码(从1开始),为空则默认为1
pageSize int 否 分页查询条数,为空默认为1万条
language string 否 为空返回中文结果(默认)
en:返回英文提示结果

返回参数
参数 类型 描述
resCode string 状态码。
msg string 状态码的详细说明。
content List,map List:兼容旧版本,入参不含分页参数,则content为list,且不返回总条数
map:入参含分页参数,则content为map,且返回总条数
返回参数包含:

domainId、domainName、adoptState、remark…
domainId int 域名id
domainName string 域名
adoptState List 接管状态。其中:1表示已接管,0表示未接管。
remark string 备注
state int 域名状态: 2/正常,3/停止,8/正常锁定,9/停止锁定
ttl int soa ttl
serialNumber int soa序列号
email string soa邮箱

请求示例
#!/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/QueryDomains”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”: “”,
“pageIndex”:1,
“pageSize”:10
}’

响应示例
示例1:兼容旧版本,入参不含分页参数,则content为list,且不返回总条数
{
    “resCode”:0,
    “msg”:“操作成功”,
    “content”: [
{
            “domainId”:7427,
            “domainName”:“hahha.com”,
            “adoptState”:0,
            “remark”:"",
            “state”:8
  
        },
{
            “domainId”:7497,
            “domainName”:“asdfasddf.com”,
            “adoptState”:0,
            “remark”:"",
            “state”:2
           
        }
         ]
}

示例2:入参含分页参数,则content为map,且返回总条数

{
    “resCode”:0,
    “msg”:“操作成功”,
    “content”: {
“count”:2,
“rows”:[

{
            “domainId”:7427,
            “domainName”:“hahha.com”,
            “adoptState”:0,
            “remark”:"",
            “state”:8
           
        },

{
            “domainId”:7497,
            “domainName”:“asdfasddf.com”,
            “adoptState”:0,
            “remark”:"",
            “state”:2,
            
        }
         ]
    }
}

4.启停域名
接口描述
用于批量启停域名。秒级生效。
限制说明:
1.建议调用频率不超过240次/分钟。
2.域名必须不包含如下信息:出售药物和管制刀具类,含有不法言论、信息。
3.视频类域名必须有视听许可证;博客论坛或社区类加速域名必须有BBS专项审批资质。
鉴权方法:见概览页公共鉴权示例。

请求参数
参数 类型 必填 描述
domainName String 是 域名 多个域名用英文符号;隔开(如: aaa.com;bb.com)
operate Int 是 操作:1 启用;0 停用
language string 否 为空返回中文结果(默认)
en:返回英文提示结果

返回参数
参数 类型 描述
resCode Int 状态码
msg String 状态码详细说明
content List domainId 域名ID
domainName 域名
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/ControlDomain”
-X “POST”
-u “$username:$password”
-H “Date: $date”
-H “Accept: application/json”
-d ‘{
“domainName”:“earth12.com.cn;domain.com”,
“operate”:1
}’

响应示例
{
    “resCode”:0,
    “msg”:“操作成功”,
    “content”: [
         {
            “domainId”:231007,
           “domainName”:“domain.com”,
  “code”:0,
            “msg”:“启动成功”
        },
         {

“domainId”:231008,
           “domainName”:“domaiaa.com”,
  “code”:0,
            “msg”:“启动成功”
        }
    ]
}

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