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

云防火墙

复制全文
下载 pdf
互联网边界防火墙
UpdateAssetSwitch - 批量更新互联网边界资产防护开关
复制全文
下载 pdf
UpdateAssetSwitch - 批量更新互联网边界资产防护开关
批量更新互联网边界资产防护开关。​
请求说明​
  • 请求方式:POST​
  • 请求地址:https://fw-center.volcengineapi.com/?Action=UpdateAssetSwitch&Version=2021-09-06​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
Query​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
UpdateAssetSwitch​
接口名称。当前 API 的名称为 UpdateAssetSwitch。​
Version​
String​
是​
2021-09-06​
接口版本。当前 API 的版本为 2021-09-06。​
​
Body​
​
参数​
类型​
是否必选​
示例值​
描述​
AssetList​
Array of AssetListStruct​
是​
--​
资产 IP 列表。​
Enable​
Integer​
是​
1​
互联网边界资产防护开关的状态,取值如下所示。​
  • -1:关闭防护;​
  • 1:开启防护。​
InternetFirewallId​
String​
否​
ifw-****​
互联网边界防火墙实例ID,获取方式可参考AssetList - 查询互联网边界资产列表。​
​
AssetListStruct​
​
参数​
类型​
是否必选​
示例值​
描述​
IP​
String​
是​
180.76.76.76​
资产的 IP 地址,用于标识需要更新防护开关的互联网边界资产。​
Region​
String​
是​
cn-beijing​
资产所在的地域,用于标识互联网边界资产的地理位置。例如 cn-beijing 表示北京地域,更多地域信息可参考地域和可用区列表。​
​
返回参数​
​
参数​
类型​
示例值​
描述​
AssetList​
Array of AssetListStruct​
​
资产IP列表,返回成功的资产列表​
ControlPolicyList​
Array of ControlPolicyInfo​
​
失败时返回关联的策略信息​
​
AssetListStruct​
​
参数​
类型​
示例值​
描述​
IP​
String​
180.76.76.76​
资产的 IP 地址,用于标识需要更新防护开关的互联网边界资产。​
Region​
String​
cn-beijing​
资产所在的地域,用于标识互联网边界资产的地理位置。例如 cn-beijing 表示北京地域,更多地域信息可参考地域和可用区列表。​
​
ControlPolicyInfo​
​
参数​
类型​
示例值​
描述​
RuleId​
String​
f04ac7ce-****-****-****-************​
控制策略的唯一标识符,用于标识与资产关联的特定控制策略。当更新互联网边界资产防护开关失败时,返回该策略 ID 以便定位问题。​
RuleType​
String​
access_control​
控制策略的规则类型,用于标识策略的具体功能类别。支持的取值如下所示。​
  • access_control:访问控制;​
  • IPS:入侵防御;​
  • TrafficDecryption:流量解密。​
Direction​
String​
in​
控制策略的流量方向,用于标识策略适用的流量方向。支持的取值如下所示。​
  • in:入站;​
  • out:出站。​
FirewallId​
String​
vfw-12345678​
防火墙的唯一标识符,用于标识与资产关联的防火墙实例。当更新互联网边界资产防护开关失败时,返回该防火墙 ID 以便定位问题。​
FirewallType​
String​
vpc_firewall​
防火墙的类型,用于标识与资产关联的防火墙实例所属的边界类型。支持的取值如下所示。​
  • internet_firewall:互联网边界;​
  • vpc_firewall:VPC 边界;​
  • nat_firewall:NAT 边界。​
​
请求示例​
​
POST https://fw-center.volcengineapi.com/?Action=UpdateAssetSwitch&Version=2021-09-06​
{​
"AssetList": [​
{​
"IP": "180.*.*.*",​
"Region": "cn-beijing"​
}​
],​
"Enable": 1,​
"InternetFirewallId": "ifw-****"​
}​
​
返回示例​
​
{​
"ResponseMetadata": {​
"Action": "UpdateAssetSwitch",​
"Region": "cn-beijing",​
"Service": "fw_center",​
"Version": "2021-09-06",​
"RequestId": "20230604110420****100232280022D31"​
},​
"Result": [​
{​
"IP": "180.*.*.*",​
"Region": "cn-beijing"​
}​
]​
}​
​
错误码​
您可访问公共错误码,获取更多错误码信息。​
最近更新时间:2025.10.30 14:53:22
这个页面对您有帮助吗?
有用
有用
无用
无用