添加解析记录

最近更新时间:2019-06-18 16:53:23

1. 接口描述

本接口(RecordCreate)用于添加解析记录。
接口请求域名:cns.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 RecordCreate。

参数名称 是否必选 类型 描述
domain String 要添加解析记录的域名(主域名,不包括 www,例如:qcloud.com)
subDomain String 子域名,例如:www
recordType String 记录类型,可选的记录类型为:"A", "CNAME", "MX", "TXT", "NS", "AAAA", "SRV"
recordLine String 记录的线路名称,例如:"默认"
value String 记录值,如 IP:192.168.10.2,CNAME:cname.dnspod.com.,MX:mail.dnspod.com.
ttl Int TTL 值,范围1 - 604800,不同等级域名最小值不同,默认为 600
mx Int MX 优先级,范围为0 ~ 50,当 recordType 选择 MX 时,mx 参数必选

3. 输出参数

参数名称 类型 描述
code Int 公共错误码, 0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message String 模块错误信息描述,与接口相关
data Array API 返回的数据

如果添加成功,会返回 data 字段,包含了记录的信息,其中,

record 字段为添加成功后,返回的基本信息:

参数名称 类型 描述
id String 解析记录的 ID
name String 子域名
status String 解析记录的状态
weight Int 解析记录的权重,默认为 null

4. 示例

https://cns.api.qcloud.com/v2/index.php?
&<公共请求参数>
&Action=RecordCreate
&domain=qcloud.com
&subDomain=www
&recordType=A
&recordLine=默认
&value=192.168.10.2

返回示例如下:

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "record": {
            "id": "282529423",
            "name": "yizero1487857213",
            "status": "enabled",
            "weight": null
        }
    }
}