更新指定的域名下的自定义解析记录。
您只能使用 POST 方法。
您需要 对请求进行鉴权。
名称 | 类型 | 是否必填 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UpdateDomainRecord | 要执行的操作,取值:UpdateDomainRecord |
Version | String | 是 | 2023-09-01 | API的版本,取值:2023-09-01 |
Domain | String | 是 | www.douyin.com | 解析记录的域名 |
Type | String | 是 | CNAME | 解析记录的类型:
|
Ttl | Integer | 是 | 20 | 解析记录的过期时间(秒)。
|
Line | String | 是 | 中国_华北 | 线路值。您可以通过 ListLines API 获取线路值 |
Target | Array of String | 是 |
| 记录值 |
Enable | Boolean | 是 | true | 是否启用解析记录:
|
Weights | Array of WeightElement | 是 |
| 记录值的权重 |
Id | Integer | 是 | 26272 | 解析记录的 ID |
DryRun | Boolean | 否 | false | 是否空运行。您可以通过该参数对请求进行预检 |
ClientToken | String | 否 | d3e5f7a9-0b1d-2c3e-4f5a-6789b0c1d2e3 | 用于保证请求幂等性。您需要从客户端生成一个参数值,确保不同请求间该参数值唯一。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Domain | String | www.douyin.com | 解析记录的域名 |
Type | String | A | 解析记录的类型 |
Ttl | Integer | 10 | 解析记录的过期时间(秒) |
Line | String | 中国_华北 | 线路值 |
Target | Array of String |
| 解析记录的记录值 |
Enable | Boolean | true | 解析记录是否被启用
|
Weights | Array of WeightElement |
| 权重值 |
POST https://open.volcengineapi.com?Action=UpdateDomainRecord&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 } ], "Id":26272 }
{ "ResponseMetadata": { "RequestId": "2023101919300431B5CABFF325722050CE", "Action": "UpdateDomainRecord", "Version": "2023-09-01", "Service": "httpdns", "Region": "cn-north-1" }, "Result": { "CreateTime": null, "Domain": "www.douyin.com", "Enable": true, "Id": 26940, "Line": "中国_华北", "Target": [ "www.toutiao.com" ], "Ttl": 0, "Type": "CNAME", "UpdateTime": null, "Weights": [ { "Key": "www.toutiao.com", "Value": 1 } ] } }
您可访问公共错误码,获取详细信息。