修改解析记录

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

1. 接口描述

本接口(RecordModify)用于修改解析记录。
接口请求域名:cns.api.qcloud.com

2. 输入参数

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

参数名称 是否必选 类型 描述
domain String 要操作的域名(主域名,不包括 www,例如:qcloud.com)
recordId Int 解析记录的 ID,可通过 RecordList 接口返回值中的 id 获取
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 子域名
value String 记录值
status String 解析记录的状态
weight Int 解析记录的权重,默认为 null

4. 示例

https://cns.api.qcloud.com/v2/index.php?
&<公共请求参数>
&Action=RecordModify
&domain=qcloud.com
&recordId=281628246
&subDomain=www
&recordType=CNAME
&recordLine=默认
&value=cloud.tencent.com

返回示例如下:

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": {
        "record": {
            "id": 282529938,
            "name": "yizeronew1487857638",
            "value": "112.112.21.21",
            "status": "enable",
            "weight": null
        }
    }
}