新增解析记录

POST/v2/dns/zones/{zone_id}/records

为区域添加一条解析记录，支持权重与线路。

同一 name + type + line 组合下可存在多条记录，通过 weight 做加权轮询。默认 TTL 600 秒，线上变更通常在 10 秒内全网生效。

Bearer Token dns:write api.demo.acme-cloud.dev

请求参数

共 1 项

zone_id 必填路径

string

区域 ID

请求体

application/json

name 必填

string

主机记录，@ 表示根域名

type 必填

string · 默认 A

记录类型

可选值AAAAACNAMEMXTXTNS

value 必填

string

记录值

ttl 可选

integer · 默认 600

缓存时间（秒），取值 60–86400

line 可选

string · 默认 default

解析线路

可选值defaulttelecomunicommobileoversea

weight 可选

integer · 默认 100

权重，0–100，同一记录集内按比例分流

enabled 可选

boolean · 默认 true

是否启用

响应

4 种状态

201 Created

响应示例

{
  "id": "rec_c41a",
  "name": "api",
  "type": "A",
  "value": "43.129.xx.xx",
  "ttl": 600,
  "line": "default",
  "weight": 100,
  "enabled": true,
  "created_at": "2026-10-16T07:52:09Z"
}

代码示例

cURL

curl -i -X POST 'https://api.demo.acme-cloud.dev/v2/dns/zones/zone_2f91/records' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "api",
  "type": "A",
  "value": "43.129.xx.xx",
  "ttl": 600,
  "line": "default",
  "weight": 100,
  "enabled": true
}'