You need to enable JavaScript to run this app.
导航
TrafficRoute DNS 套件
  • 文档首页
    • /
  • TrafficRoute DNS 套件

添加解析记录

最近更新时间：2023.12.15 10:24:14

首次发布时间：2023.02.08 13:12:16

我的收藏

API 说明

API 名称：CreateRecord。
API 域名：open.volcengineapi.com。
API 描述：在指定域名下添加一个解析记录。

请求方法

POST

请求参数

除了以下参数，您还需要在请求头中指定 请求方法 并包含 签名参数。

参数名称
数据类型
参数类型
是否必选
参数说明
Action
String
查询参数
是
API 的名称。该参数的取值是 CreateRecord。
Version
String
查询参数
是
API 的版本。该参数的取值是 2022-06-01。
ZID
Integer
请求正文参数
是
域名 ID。您可以通过以下 API 获取：
Host
String
请求正文参数
是
子域名的域名前缀（主机记录）。
  • 如果您希望流量被路由到 example.internal.com，设置域名前缀为 example。域名前缀可以包括多级域名。例如，如果您希望流量被路由到 example.test.internal.com，设置域名前缀为 example.test。
  • 如果您希望流量被路由到 internal.com，设置域名前缀为 @。
  • 如果你希望流量被路由到 internal.com 的泛域名，设置域名前缀为 *。
域名的规则如下：
  • 支持英文字母（a-z、A-Z）、数字（0-9）、中划线（-）、下划线（_）、句号（.）、通配符（*）、@、中文汉字。
  • 中划线不能在单级域名的开头或结尾使用，句号不能连用。
  • @ 只能单独使用，用于表示空值。
  • 通配符只能作为单级域名在开头使用，用于泛解析。
  • 单级长度不超过 63 个字符。FQDN 格式的总长度不超过 254 个字符。
Value
String
请求正文参数
是
记录值。您需要根据 Type 参数的取值设置记录值。
  • A: IPv4 地址。例如 10.1.1.128。
  • AAAA: IPv6 地址。例如 fe80::aede:48ff:fe00:1122。
  • CNAME：域名，例如 example.com。
  • MX：格式为 优先级 域名，例如 10 example.com。优先级的取值范围是 [1， 99]。
  • PTR：域名。例如 example.internal.com


关于解析记录的详细信息参考 解析记录类型。
Type
String
请求正文参数
是
解析记录类型。
Weight
Integer
请求正文参数
否
记录值的权重。
TTL
Integer
请求正文参数
否
解析记录的过期时间。单位为秒。默认值为 600 秒。
Line
String
请求正文参数
否
VPC 子网 ID。

在设置该参数之前，您必须在调用 添加域名 API 时开启智能解析功能。否则，该参数设置无效。

该参数默认为 Default。此时，解析记录使用默认线路。
Remark
String
请求正文参数
否
备注。

响应正文

参数名称
数据类型
参数说明
ResponseMetadata
Object
响应的元数据。
Result
Object
返回结果。

示例

请求示例

POST https://open.volcengineapi.com/?Action=CreateRecord&Version=2022-06-01

{
    "ZID": 1068,
    "Host": "www",
    "Value": "1.1.1.1",
    "Type": "A",
    "Weight": 10,
    "TTL": 600,
    "Line": "default",
    "Remark":""
}

响应示例

{
    "ResponseMetadata": {
        "RequestId": "20221215101225DB0A30AF803D07576779",
        "Action": "CreateRecord",
        "Version": "2022-06-01",
        "Service": "private_zone",
        "Region": "cn"
    },
    "Result": {
        "RecordID": "9079256848778957482"
    }
}