修改解析记录

PATCH/v2/dns/zones/{zone_id}/records/{record_id}

修改记录值、TTL、线路或启用状态。

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

请求参数

共 2 项

zone_id 必填路径

string

区域 ID

record_id 必填路径

string

记录 ID

请求体

application/json

value 可选

string

新的记录值

ttl 可选

integer

新的 TTL

weight 可选

integer

新的权重

enabled 可选

boolean

启用 / 停用，停用常用于灰度下线

响应

4 种状态

200 OK

响应示例

{
  "id": "rec_8a1f",
  "name": "api",
  "type": "A",
  "value": "43.129.yy.yy",
  "ttl": 300,
  "enabled": true,
  "updated_at": "2026-10-16T07:55:41Z"
}

代码示例

cURL

curl -i -X PATCH 'https://api.demo.acme-cloud.dev/v2/dns/zones/zone_2f91/records/rec_8a1f' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "value": "43.129.yy.yy",
  "ttl": 300,
  "enabled": true
}'