更新一条解析记录。

使用说明

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

请求说明

请求方式：POST

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

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：UpdateRecord

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

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

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

ZID long 可选示例值：123456

标识域名的唯一 ID。您可以通过以下 API 获取：

添加域名 API

获取域名列表 API

如果您需要验证子用户是否对域名所在的项目有操作权限，您需要传入该参数。

Enable boolean 可选示例值：true

是否启用解析记录。

true：启用解析记录。

false：禁用解析记录。

如果您不设置该参数，该参数的值不会改变。

Host string 可选示例值：abc

子域名的域名前缀（主机记录）。参见添加解析记录了解域名前缀的格式要求。如果您不设置该参数，该参数的值不会改变。

RecordID string 必选示例值：9079256848778957482

解析记录 ID。您可以通过以下 API 获取：

CreateRecord API

ListRecords API

TTL integer 可选示例值：600

解析记录的过期时间。单位为秒。如果您不设置该参数，该参数的值不会改变。

Type string 可选示例值：A

解析记录类型。如果您不设置该参数，该参数的值不会改变。

Value string 可选示例值：10.0.0.1

记录值。参见解析记录类型。如果您不设置该参数，该参数的值不会改变。

Weight integer 可选示例值：1

记录值的权重。只有域名开启了负载均衡后，记录值的权重才会生效。参见 UpdatePrivateZone API 了解如何为域名开启或关闭负载均衡。如果您不设置该参数，该参数的值不会改变。

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 个字符。如果您不设置该参数，该参数的值不会改变。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	ErrDBNotFound	db not found	数据条目未找到
400	ErrZoneNotFound	zone not found	未找到域名
400	ErrParamInvalid	validation fail: params:[%s] , value:[%v]	参数校验失败
400	ErrDBDuplicated	duplicated: domain name:signin.volcengine.com. already have duplicate record in same line

TrafficRoute DNS 套件