文档中心

云防火墙

API参考

API 概览

API 概览

本文档是云防火墙（Cloud Firewall）服务的完整 API 参考，旨在帮助您以编程方式管理和自动化云防火墙相关功能。您可以快速查找所需 API，用于管理地址簿、配置互联网边界防火墙、VPC 边界防火墙、NAT 边界防火墙或 DNS 防火墙。

地址簿

API	说明
AddAddressBook	添加访问控制地址簿，方便统一管理IP地址集合，简化安全策略配置。
ModifyAddressBook	全量更新地址簿，一次性替换所有地址，快速重置地址簿内容。
DescribeAddressBook	查询访问控制地址簿，获取地址簿详情，用于审计或管理。
DeleteAddressBook	删除访问控制地址簿，清理不再需要的地址集合。
ModifyAddressBookList	增量更新地址簿，在现有地址簿中添加或删除IP，实现精细化管理。

互联网边界防火墙

API	说明
AddControlPolicy	创建互联网边界访问控制策略，精细化管理公网IP的访问权限。
DescribeControlPolicy	查询互联网边界访问控制策略列表，用于审计与管理现有策略。
DescribeControlPolicyByRuleId	查询单条访问控制策略详情，快速获取特定规则的配置信息。
AssetList	查询互联网边界内的受保护资产列表，掌握资产安全状态。
DescribeControlPolicyPriorUsed	查询访问控制策略的可用优先级范围，避免策略优先级冲突。
UpdateControlPolicySwitch	启用或禁用指定的访问控制策略，快速响应安全需求变更。
ModifyControlPolicyPosition	调整访问控制策略的执行优先级，优化策略匹配顺序。
ModifyControlPolicy	修改已有的互联网边界访问控制策略，更新策略配置。
UpdateAssets	为单个资产开启或关闭防护，灵活调整资产的防护状态。
UpdateAssetSwitch	批量为多个资产开启或关闭防护，高效管理大规模资产。
DeleteControlPolicy	删除不再需要的互联网边界访问控制策略。

VPC 边界防火墙

API	说明
CreateVpcFirewall	创建 VPC 边界防火墙。
ModifyVpcFirewall	修改指定 VPC 边界防火墙的带宽或名称。
DeleteVpcFirewall	删除指定的 VPC 边界防火墙。
AddVpcFirewallAclRule	创建VPC边界访问控制策略，管理VPC之间的网络互访权限。
DescribeVpcFirewallList	查询VPC边界防火墙实例列表，掌握VPC防护状态。
DescribeVpcFirewallAclRuleList	查询VPC边界访问控制策略列表，审计和管理VPC间的访问规则。
DescribeVpcFirewallAclRulePriorUsed	查询VPC边界访问控制策略的可用优先级范围，避免策略冲突。
UpdateVpcFirewallAclRuleSwitch	启用或禁用VPC边界的访问控制策略，快速调整VPC间的访问控制。
ModifyVpcFirewallAclRulePosition	调整VPC边界访问控制策略的执行优先级，优化策略匹配逻辑。
ModifyVpcFirewallAclRule	修改已有的VPC边界访问控制策略，更新VPC间的访问规则。
DeleteVpcFirewallAclRule	删除不再需要的VPC边界访问控制策略。
DescribeTransitRouterResourcesList	查询中转路由器实例下所有资源列表详情，包括资源 ID、名称以及引用计数等信息。
DescribeVpcFirewallRoutePolicyList	查询 VPC 防火墙的引流场景列表详情，包括引流场景的名称、类型、创建时间以及状态等信息。
CreateVpcFirewallRoutePolicy	为指定的 VPC 防火墙新建引流场景。
UpdateVpcFirewallRoutePolicySwitch	开启或关闭指定的引流场景。
ModifyVpcFirewallRoutePolicy	修改指定引流场景的配置。
DeleteVpcFirewallRoutePolicy	删除指定的引流场景。

NAT 边界防火墙

API	说明
AddNatFirewallControlPolicy	创建NAT边界访问控制策略，管理NAT网关的流量访问权限。
DescribeNatFirewallList	查询NAT边界防火墙实例列表，了解NAT网关的防护状态。
DescribeNatFirewallControlPolicy	查询NAT边界访问控制策略列表，审计和管理NAT网关的访问规则。
DescribeNatFirewallControlPolicyPriorityUsed	查询NAT边界访问控制策略的可用优先级范围，避免策略冲突。
UpdateNatFirewallControlPolicySwitch	启用或禁用NAT边界的访问控制策略，快速调整NAT网关的流量控制。
ModifyNatFirewallControlPolicyPosition	调整NAT边界访问控制策略的执行优先级，优化策略匹配逻辑。
ModifyNatFirewallControlPolicy	修改已有的NAT边界访问控制策略，更新NAT网关的访问规则。
DeleteNatFirewallControlPolicy	删除不再需要的NAT边界访问控制策略。
CreateNatFirewall	创建NAT防火墙实例，为NAT网关提供安全防护。
DeleteNatFirewall	删除不再需要的NAT防火墙实例。

DNS 防火墙

API	说明
AddDnsControlPolicy	创建DNS访问控制策略，拦截恶意的域名解析请求。
ModifyDnsControlPolicy	修改已有的DNS访问控制策略，更新域名黑白名单。
UpdateDnsControlPolicySwitch	启用或禁用DNS访问控制策略，快速调整域名解析的防护状态。
DescribeVpcs	查询VPC列表，用于在配置DNS防火墙时选择需要防护的VPC。
DescribeDnsControlPolicy	查询DNS访问控制策略列表，审计和管理域名解析规则。
DeleteDnsControlPolicy	删除不再需要的DNS访问控制策略。

策略备份

API	说明
AddAclBackup	新增一个防火墙策略备份，后续可用于回滚互联网防火墙、VPC 防火墙或 NAT 防火墙策略。
UseAclBackup	使用策略备份回滚互联网防火墙策略，或回滚指定的 VPC 防火墙、NAT 防火墙策略。
DescribeAclBackup	获取策略备份列表。请求时支持分页查询、支持设置过滤条件，响应结果包含策略数量、策略备份以及防火墙实例等信息。
DeleteAclBackup	删除指定的策略备份。

策略分析

API	说明
StartPolicyAnalyzeTask	为指定防火墙分析策略，可快速定位并优化问题策略，有效降低安全风险。
GetPolicyAnalyzeOverview	获取指定策略分析结果的概览，包括防火墙类型及相应的风险数量。
GetPolicyAnalyzeResult	获取指定策略分析的结果，包括分析任务的状态、策略检查类型及风险数量等信息。
GetPolicyAnalyzeDetail	获取指定防火墙、指定检查类型的策略分析详情，包括问题类型、方向、状态以及策略 ID 等信息。
UpdatePolicyResultStatus	更新指定策略分析结果的状态。

策略验证

API	说明
GetPolicyCheckResult	通过输入网络五元组信息（源 IP、目的 IP、协议、源端口、目的端口），快速确认指定流量是被防火墙策略放行还是阻断，便于故障排查。

告警通知

API	说明
QueryUserAlarmConfig	查询已配置的告警通知详情，包括互联网防火墙、VPC 防火墙、NAT 防火墙以及日志管理的告警通知。
UpdateUserAlarmConfig	更新指定告警通知的配置项，包括告警开关、告警间隔以及告警动作等配置。

最近更新时间：2025.12.31 15:44:45

这个页面对您有帮助吗？

有用

有用

无用

无用