为一个域名添加一条解析记录。

使用说明

请求频率：每秒最多调用 10 次。

请求说明

请求方式：POST

请求地址：https://private-zone.volcengineapi.com/?Action=CreateRecord?Version=2022-06-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

除了以下参数，您还需要对请求进行鉴权。

Action string 必选示例值：CreateRecord

要执行的操作，取值：CreateRecord。

Version string 必选示例值：2022-06-01

API的版本，取值：2022-06-01。

ZID long 必选示例值：1234

域名 ID。您可以通过以下 API 获取：

CreatePrivateZone API

ListPrivateZones API

Type string 必选示例值：A

记录类型。关于不同类型的记录，参见解析记录类型。该参数的取值如下：

A：A 记录。

AAAA：AAAA 记录。

CNAME：CNAME 记录。

TXT：TXT 记录。

MX：MX 记录。

PTR：PTR 记录。

Host string 必选示例值：abc

子域名的域名前缀。参见添加解析记录了解域名前缀的格式要求。

Value string 必选示例值：10.0.0.1

记录值。参见解析记录类型。

Line string 可选示例值：default

为该解析记录指定生效线路。当客户端发起 DNS 查询时，PrivateZone 会根据客户端源 IP 所属的线路匹配对应的解析结果。

取值范围由域名是否开启智能解析决定：

域名是否开启智能解析（CreatePrivateZone 时 LineMode）	取值说明	说明
未开启（LineMode=0）	不传 / default	仅支持默认线路。未传时按 default 处理。
已开启（LineMode=4）	default	默认线路。在未命中任何 AZ 线路或自定义线路时返回。建议至少为该域名保留一条 default 线路的记录作为兜底。
已开启（LineMode=4）	AZ 线路	按地域及可用区划分的线路。取值来自 ListAvailabilityZones 返回的 AzLine 参数，格式为 region;az，例如 cn-beijing;cn-beijing-a。
已开启（LineMode=4）	自定义线路	您创建的自定义线路，用于将解析结果与自定义的 IP 网段绑定。取值来自 ListCustomLines 返回的 Line 参数，例如 custom-101。如果您尚未创建任何自定义线路，请先调用 CreateCustomLine 创建后再在本接口引用。

Remark string 可选示例值：remark

备注。支持 UTF-8 字符。不能超过 16 个字符。默认值为空字符串。

TTL integer 可选示例值：600

解析记录的过期时间。单位为秒。默认值为 600。

Weight integer 可选示例值：1

记录值的权重。只有域名开启了负载均衡后，记录值的权重才会生效。参见 UpdatePrivateZone API 了解如何为域名开启或关闭负载均衡。默认值为 1。

ClientToken string 可选示例值：123456abcdef

用于确保请求的幂等性。如果您设置了该参数，在相同的请求参数下，无论该 API 被调用多少次，返回的结果都是相同的。该参数仅允许 ASCII 字符且不能超过 64 个字符。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

RecordID string 示例值：9079256848778957482

标识解析记录的唯一 ID。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	ErrParamInvalid	validation fail: params:[%s] , value:[%v]	参数校验失败
400	ErrZoneNotFound	zone not found	未找到域名
400	ErrQuotaExceeded	[%s] exceeds quota [%d]	[%s] 超出限额 [%d]
400	ErrIdempotentParameterMismatch	Arguments on this idempotent request are inconsistent with arguments used in previous request(s)	幂等请求参数不一致
400	ErrIdempotentRequestInProgress	last idempotent request is in progress, please try later	上一次幂等请求还没结束，请稍后重试
400	ErrDBDuplicated	duplicated: domain name:iaas-api.console.volcengine.com. already have duplicate record in same line	相同线路下的解析记录重复
400	ErrHostCanNotBeEmpty	host can't be empty, use @ instead	域名前缀不能为空
500	ErrInternalServer	server internal error	服务内部错误

TrafficRoute DNS 套件