ModifyRouterStaticAttributes

修改某条路由器规则。修改规则后,需要执行 UpdateRouters 来使规则生效。

Request Parameters

Parameter name Type Description Required
router_static String 需要修改的路由器规则 ID Yes
router_static_name String 规则名称 No
val1 String

当规则类型为端口转发规则时(static_type=1),val1表示源端口。

当规则类型为VPN规则时(static_type=2),val1表示VPN类型,目前只支持”openvpn”, 默认值也为”openvpn”。

当规则类型为DHCP选项时(static_type=3),val1表示DHCP主机ID。

No
val2 String

当规则类型为端口转发规则时(static_type=1),val2表示目标IP。

当规则类型为VPN规则时(static_type=2),val2表示VPN服务端口号,默认为1194。

当规则类型为DHCP选项时(static_type=3),val2表示DHCP配置内容,格式为key1=value1;key2=value2,例如:”domain-name-servers=8.8.8.8”。

No
val3 String

当规则类型为端口转发规则时(static_type=1),val3表示目标端口号。

当规则类型为VPN规则时(static_type=2), 对OPENVPN, val3表示VPN协议,默认为”udp”; 对L2TP, val3表示PSK, 可填入任意字符串。

No
val4 String

当规则类型为端口转发规则时(static_type=1),val4表示端口转发协议,默认为”tcp”,目前支持”tcp”和”udp”两种协议。

当规则类型为VPN规则时(static_type=2),val4表示VPN客户端的网络地址段,目前支持10.255.x.0/24,x的范围是[0-255],默认为自动分配。

No
val5 String

当规则类型为过滤控制规则时(static_type=5),val5 表示优先级,目前支持 0-100,数字越小优先级越高。

当规则类型为VPN规则时(static_type=2), 对L2TP, val5 表示VPN服务端口号,默认为1701。

No
val6 String 当规则类型为过滤控制规则时(static_type=6),val6 表示控制行为,即接受 “accept” 或拒绝 “drop” 。 No
zone String 区域 ID,注意要小写 Yes

公共参数

Response Elements

Name Type Description
action String 响应动作
router_static Array 修改的路由器规则ID
ret_code Integer 执行成功与否,0 表示成功,其他值则为错误代码

Example

Example Request:

https://api.qingcloud.com/iaas/?action=ModifyRouterStaticAttributes
&router_static=rtrs-c173g36a
&router_static_name=new_name,
&val1=8080
&val2=192.168.1.12
&val3=8080
&val4=tcp
&COMMON_PARAMS

Example Response:

{
  "action":"ModifyRouterStaticAttributesResponse",
  "router_static_id":"rtrs-c173g36a",
  "ret_code":0
}