You need to enable JavaScript to run this app.
文档中心
TrafficRoute DNS 套件

TrafficRoute DNS 套件

复制全文
下载 pdf
解析器Resolver
UpdateResolverRule - 更新转发规则
复制全文
下载 pdf
UpdateResolverRule - 更新转发规则
更新一条转发规则。​
使用说明​
请求频率:每秒最多调用 10 次。​
请求说明​
  • 请求方式:POST​
  • 请求地址:https://open.volcengineapi.com/?Action=UpdateResolverRule?Version=2022-06-01​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
除了以下参数,您还需要 对请求进行鉴权。​
Action string 必选 示例值:UpdateResolverRule​
要执行的操作,取值:UpdateResolverRule。​
​
Version string 必选 示例值:2022-06-01​
API的版本,取值:2022-06-01。​
​
RuleID long 必选 示例值:123​
转发规则的 ID。您可以从以下 API 的响应中获取:​
​
RuleTrn string 可选 示例值:trn:private_zone::21******4::rule/rule-1234​
转发规则的 TRN。格式为 trn:private_zone::accountId::rule/rule-ruleId。如果您需要验证子用户是否对转发规则所在的项目有操作权限,您需要传入该参数。​
​
Name string 可选 示例值:rule01​
转发规则的名称。支持 UTF-8 格式。如果您不传入该参数,则该参数不会被更新。​
​
Line string 可选 示例值:移动​
递归 DNS 服务器的出口 IP 地址的运营商。该参数仅在 Type 参数是 LINE 时有效。​
支持的取值:​
- 移动:中国移动​
- 电信:中国电信​
- 联通:中国联通​
说明​
如果您不传入该参数,则该参数不会被更新。​
​
ForwardIPs object[] 可选 示例值:无​
VPC 外部的 DNS 服务器的 IP 地址和端口。您最多只能添加 10 个 IP 地址。该参数仅在 Type 参数是 OUTBOUND 时有效。如果您不传入该参数,则该参数不会被更新。​
IP string 必选 示例值:10.0.0.1​
VPC 外部的 DNS 服务器的 IP 地址。​
​
Port integer 可选 示例值:53​
VPC 外部的 DNS 服务器的端口。​
​
​
Vpcs object[] 可选 示例值:无​
转发规则所关联的 VPC。转发规则在关联的 VPC 中生效。Type 参数是 OUTBOUND 时,VPC 的地域必须和终端节点所在的地域相同。​
VpcId string 必选 示例值:vpc-1233445​
VPC 的 ID。​
​
Region string 必选 示例值:cn-beijing​
VPC 的地域。​
​
​
ZoneName string 可选 示例值:example.com​
转发规则所关联的域名。您可以输入一个或多个域名。多个域名之间使用英文逗号(,)分隔,例如:example.com,volcengine.com。​
说明​
  • 最多支持输入 500 个域名。​
  • 该参数仅在Type参数是OUTBOUND时有效且为必选参数。​
  • 如果您把该参数设置为*,则转发规则适用于 VPC 关联的所有域名。​
​
​
​
返回参数​
本接口无特有的返回参数。更多信息请见返回结构。​
请求示例​
​
POST /?Action=UpdateResolverRule&Version=2022-06-01 HTTP/1.1​
Host: private-zone.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20260318T095633Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260318/cn-beijing/private_zone/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
"RuleID": 123,​
"RuleTrn": "trn:private_zone::21******4::rule/rule-1234",​
"Name": "rule01",​
"Line": "移动",​
"ForwardIPs": [​
{​
"IP": "10.0.0.1",​
"Port": 53​
}​
],​
"Vpcs": [​
{​
"VpcId": "vpc-1233445",​
"Region": "cn-beijing"​
}​
],​
"ZoneName": "example.com"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "202603181756440870361361808172C8",​
"Action": "UpdateResolverRule",​
"Version": "2022-06-01",​
"Service": "private_zone",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
ErrSystemRule​
modify system rule is not allowed​
系统规则禁止修改​
400​
ErrRuleNotFound​
resolver rule not found​
未找到转发规则​
400​
ErrParamInvalid​
validation fail: params:[%s] , value:[%v]​
参数校验失败​
500​
ErrInternalServer​
server internal error​
服务内部错误​
​
​
最近更新时间:2026.03.19 12:07:56
这个页面对您有帮助吗?
有用
有用
无用
无用