You need to enable JavaScript to run this app.
导航

添加解析记录

最近更新时间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"
    }
}