AddDomainRecord - 创建自定义解析记录--TrafficRoute DNS 套件-火山引擎

文档中心

立即注册

导航

TrafficRoute DNS 套件

AddDomainRecord - 创建自定义解析记录

最近更新时间：2023.10.30 15:09:03首次发布时间：2023.10.17 17:43:57

在指定的域名下添加自定义解析记录。

请求说明

您只能使用 POST 方法。

请求鉴权

您需要对请求进行鉴权。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	AddDomainRecord	要执行的操作，取值：AddDomainRecord
Version	String	是	2023-09-01	API的版本，取值：2023-09-01
Domain	String	是	www.douyin.com	解析记录的域名
Type	String	是	CNAME	解析记录的类型： A AAAA CNAME
Ttl	Integer	是	10	解析记录的过期时间（秒）。对于 A 或 AAAA 类型的解析记录，Ttl 的取值范围为 60 ~ 7200。对于 CNAME 类型的解析记录，Ttl 参数无效。
Line	String	是	中国_华北	线路值。您可以通过 ListLines API 获取线路值。
Target	Array of String	是	`[ "www.toutiao.com" ]`	记录值
Enable	Boolean	是	false	是否启用解析记录： true：启用 false：禁用
Weights	Array of WeightElement	是	`[ { "Key": "www.toutiao.com", "Value": 1 } ]`	记录值的权重
DryRun	Boolean	否	false	是否空运行。您可以通过该参数对请求进行预检
ClientToken	String	否	d3e5f7a9-0b1d-2c3e-4f5a-6789b0c1d2e3	用于保证请求幂等性。您需要从客户端生成一个参数值，确保不同请求间该参数值唯一。`ClientToken` 只支持 ASCII 字符，且长度不能超过 64 个字符

响应数据

名称	类型	示例值	描述
Domain	String	www.douyin.com	解析记录的域名
Type	String	A	解析记录的类型
Ttl	Integer	10	解析记录的过期时间（秒）
Line	String	中国_华北	线路值
Target	Array of String	`[ "www.toutiao.com" ]`	解析记录的记录值
Enable	Boolean	true	解析记录是否被启用 true：被启用 false：被禁用
Weights	Array of WeightElement	`[ { "Key": "www.toutiao.com", "Value": 1 } ]`	权重值

示例

请求

POST https://open.volcengineapi.com?Action=AddDomainRecord&Version=2023-09-01
{
    "Domain": "www.douyin.com",
    "Type": "CNAME",
    "Ttl": 0,
    "Line": "中国_华北",
    "Target": [
        "www.toutiao.com"
    ],
    "Enable": false,
    "Weights": [
        {
            "Key": "www.toutiao.com",
            "Value": 1
        }
    ]
}

响应

{
    "ResponseMetadata": {
        "RequestId": "202310191805184725C6DC21CC061B7254",
        "Action": "AddDomainRecord",
        "Version": "2023-09-01",
        "Service": "httpdns",
        "Region": "cn-boe-1"
    },
    "Result": {
        "CreateTime": null,
        "Domain": "www.douyin.com",
        "Enable": false,
        "Id": 26940,
        "Line": "中国_华北",
        "Target": [
            "www.toutiao.com"
        ],
        "Ttl": 0,
        "Type": "CNAME",
        "UpdateTime": null,
        "Weights": [
            {
                "Key": "www.toutiao.com",
                "Value": 1
            }
        ]
    }
}

错误码

您可访问公共错误码，获取详细信息。