You need to enable JavaScript to run this app.
文档中心
云防火墙

云防火墙

复制全文
下载 pdf
NAT边界防火墙
ModifyNatFirewallControlPolicy - 更新 NAT 边界防火墙访问控制策略
复制全文
下载 pdf
ModifyNatFirewallControlPolicy - 更新 NAT 边界防火墙访问控制策略
调用此接口修改 NAT 边界防火墙访问控制策略信息。​
注意事项​
请求说明​
  • 请求方式:POST​
  • 请求地址:https://fw-center.volcengineapi.com/?Action=ModifyNatFirewallControlPolicy&Version=2021-09-06​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Query​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
ModifyNatFirewallControlPolicy​
接口名称。当前 API 的名称为 ModifyNatFirewallControlPolicy。​
Version​
String​
是​
2021-09-06​
接口版本。当前 API 的版本为 2021-09-06。​
​
Body​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
accept​
策略动作。​
  • accept: 放行​
  • deny: 阻断​
  • monitor: 观察​
Description​
String​
否​
Description​
策略描述信息,可用于说明策略的用途、作用等。​
DestPort​
String​
否​
22/22​
目的端口,其格式和内容取决于 DestPortType 和 Proto 字段的取值。​
  • 当协议类型为 ICMP 或 ALL 时,取值为空;​
  • 当 DestPortType 为 group 时,取值为端口地址簿的 UUID 列表,多个地址簿通过英文逗号分隔;​
  • 当 DestPortType 为 port 时,取值为端口范围,格式为单个端口(如 22)或端口范围(如 100/200)。​
DestPortType​
String​
否​
group​
访问控制策略的目的端口类型,用于指定 DestPort 字段的格式和内容。支持的取值如下所示。​
  • port:端口或端口范围;​
  • group:端口地址簿。​
Destination​
String​
是​
f04ac7ce-****-****-****-************​
访问控制策略的目的地址,其格式和内容取决于 DestinationType 字段的取值。支持的取值如下所示。​
  • 当 DestinationType 为 net 时,格式为 CIDR 地址(如 192.168.0.2/32);​
  • 当 DestinationType 为 group 时,格式为目的地址簿的 UUID(如 f04ac7ce-****-****-****-************)。​
DestinationType​
String​
是​
domain​
目的地址的类型,用于指定 Destination 字段的格式和内容。支持的取值如下所示。​
  • net:网段(CIDR);​
  • group:地址簿;​
Direction​
String​
是​
in​
策略方向,用于指定访问控制策略的流量方向。支持的取值如下所示。​
  • in:入向;​
  • out:出向。​
EndTime​
Integer​
否​
1732982340​
策略生效截止日期,Unix 时间戳,支持精确到设定日期的 23:59:00。​
  • 当 RepeatType 为 Permanent(始终生效)时,该字段无需填写。​
  • 当 RepeatType 为 Once(单时间段生效)或 Daily、Weekly、Monthly(重复生效)时,需填写该字段,字段需要精确到设定日期的 23:59:00。​
NatFirewallId​
String​
是​
nfw-********​
NAT 边界防火墙实例 ID。获取方式可参考DescribeNatFirewallList - 查询NAT边界防火墙实例列表。​
Proto​
String​
是​
TCP​
协议类型,用于指定访问控制策略的流量协议。当 DestinationType 为 domain 时,Proto 只能是 TCP。支持的取值如下所示。​
  • ICMP:ICMP 协议;​
  • TCP:TCP 协议;​
  • UDP:UDP 协议;​
  • ANY:任何协议。​
RepeatDays​
Array of Integer​
否​
[1,3,5]​
重复生效的日期列表,仅在 RepeatType 为 Weekly 或 Monthly 时有效。​
  • 当 RepeatType 为 Weekly 时,取值范围为 [0, 6],其中 0 表示周日,1 表示周一,以此类推;​
  • 当 RepeatType 为 Monthly 时,取值范围为 [1, 31],表示每月的具体日期。​
RepeatEndTime​
String​
否​
23:59​
重复生效截止时间。当 RepeatType 为 Daily、Weekly 或 Monthly(重复生效)时,必须填写该字段。​
精确到分钟,格式为 hh:mm。例如:23:59表示每天晚上 23:59 结束生效。​
RepeatStartTime​
String​
否​
08:00​
重复生效的开始时间,精确到分钟,格式为 hh:mm。当 RepeatType 为 Daily、Weekly 或 Monthly 时,必须填写该字段。例如:08:00表示每天早上 8 点开始生效。​
RepeatType​
String​
否​
Weekly​
策略的重复生效类型,用于指定策略生效的时间模式。支持的取值如下所示。​
  • Permanent:始终生效;​
  • Once:单次生效;​
  • Daily:每日重复;​
  • Weekly:每周重复;​
  • Monthly:每月重复。​
RuleId​
String​
是​
f04ac7ce-****-****-****-************​
访问控制策略唯一标识 ID。获取方式可参考DescribeNatFirewallControlPolicy - 查询 NAT 边界防火墙访问控制策略列表。​
Source​
String​
是​
192.168.1.1/32​
访问控制策略的源地址,其格式和内容取决于 SourceType 字段的取值。支持的取值如下所示。​
  • 当 SourceType 为 net 时,格式为 CIDR 地址(如 192.168.1.1/32);​
  • 当 SourceType 为 group 时,格式为源地址簿的 UUID(如 f04ac7ce-****-****-****-************);​
  • 当 SourceType 为 location 时,格式为区域代码(如 BJ11)。​
SourceType​
String​
是​
group​
源地址的类型,用于指定 Source 字段的格式和内容。支持的取值如下所示。​
  • net:网段(CIDR);​
  • group:地址簿;​
  • location:区域。​
StartTime​
Integer​
否​
1725638400​
策略生效的起始时间,使用 Unix 时间戳格式,精确到设定日期的 00:00:00。具体规则如下:​
  • 当 RepeatType 为 Permanent(始终生效)时,该字段无需填写;​
  • 当 RepeatType 为 Once(单时间段生效)时,需填写精确到分钟的 Unix 时间戳;​
  • 当 RepeatType 为 Daily、Weekly 或 Monthly(重复生效)时,需填写设定日期的 00:00:00 对应的时间戳。​
Status​
Boolean​
否​
false​
VPC 边界防火墙访问控制策略的开关状态,默认值为 false。支持的取值如下所示。​
  • true:开启;​
  • false:关闭。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
RuleId​
String​
f04ac7ce-****-****-****-************​
创建成功后返回的访问控制策略唯一标识 ID。​
​
请求示例​
​
POST https://fw-center.volcengineapi.com/?Action=ModifyNatFirewallControlPolicy&Version=2021-09-06​
{​
"Action": "accept",​
"Description": "Description",​
"DestPort": "f04ac7ce-****-****-****-************",​
"DestPortType": "group",​
"Destination": "********.com",​
"DestinationType": "domain",​
"Direction": "in",​
"EndTime": 1725708600,​
"NatFirewallId": "nfw-********",​
"Proto": "TCP",​
"RepeatDays": [​
null​
],​
"RepeatEndTime": "10:00",​
"RepeatStartTime": "08:00",​
"RepeatType": "Permanent",​
"RuleId": "f04ac7ce-****-****-****-************",​
"Source": "f04ac7ce-****-****-****-************",​
"SourceType": "group",​
"StartTime": 1725705000,​
"Status": true​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"Action": "ModifyNatFirewallControlPolicy",​
"Region": "cn-beijing",​
"Service": "fw_center",​
"Version": "2021-09-06",​
"RequestId": "20230604110420****100232280022D31"​
},​
"Result": {​
"RuleId": "f04ac7ce-****-****-****-************"​
}​
}​
​
错误码​
您可访问公共错误码,获取更多错误码信息。​
最近更新时间:2025.08.11 14:18:08
这个页面对您有帮助吗?
有用
有用
无用
无用