AddDomain - 添加域名--TrafficRoute DNS 套件-火山引擎

文档中心

立即注册

导航

TrafficRoute DNS 套件

AddDomain - 添加域名

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

添加一个域名。

使用场景

如果您希望移动解析 HTTPDNS 对一个域名提供解析服务，您需要添加该域名。

请求说明

您可以使用 GET 或 POST 方法。

请求鉴权

您需要对请求进行鉴权。

请求参数

名称	类型	是否必填	示例值	描述
Action	String	是	AddDomain	要执行的操作，取值：AddDomain
Version	String	是	2023-09-01	API的版本，取值：2023-09-01
Domain	String	是	*.douyin.com	需要解析的域名，支持泛域名
DryRun	Boolean	否	false	是否空运行。您可以通过该参数对请求进行预检
ClientToken	String	否	d3e5f7a9-0b1d-2c3e-4f5a-6789b0c1d2e3	用于保证请求幂等性。您需要从客户端生成一个参数值，确保不同请求间该参数值唯一。`ClientToken` 只支持 ASCII 字符，且长度不能超过 64 个字符

响应数据

名称	类型	示例值	描述
Result	DomainInstance		响应结果

示例

GET 示例

请求

GET https://open.volcengineapi.com?Action=AddDomain&Version=2023-09-01&Domain=www.douyin.com

响应

{
    "ResponseMetadata": {
        "RequestId": "20231011172302477A4BF4688234E71DAB",
        "Action": "AddDomain",
        "Version": "2023-09-01",
        "Service": "httpdns",
        "Region": "cn-north-1"
    },
    "Result": {
        "Domain": "www.douyin.com",
        "Id": 26585
    }
}

POST 示例

请求

POST https://open.volcengineapi.com?Action=AddDomain&Version=2023-09-01
{
    "Domain": "www.douyin.com"
}

响应

{
    "ResponseMetadata": {
        "RequestId": "20231011172302477A4BF4688234E71DAB",
        "Action": "AddDomain",
        "Version": "2023-09-01",
        "Service": "httpdns",
        "Region": "cn-north-1"
    },
    "Result": {
        "Domain": "www.douyin.com",
        "Id": 26585
    }
}

错误码

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