本文档是云防火墙（Cloud Firewall）服务的完整 API 参考，旨在帮助您以编程方式管理和自动化云防火墙相关功能。您可以快速查找所需 API，用于管理地址簿、配置互联网边界防火墙、VPC 边界防火墙、NAT 边界防火墙或 DNS 防火墙。 ## 地址簿 |**API** |**说明** | |---|---| |[AddAddressBook](https://www.volcengine.com/docs/6516/1223827) |添加访问控制地址簿，方便统一管理IP地址集合，简化安全策略配置。 | |[ModifyAddressBook](https://www.volcengine.com/docs/6516/1223818) |全量更新地址簿，一次性替换所有地址，快速重置地址簿内容。 | |[DescribeAddressBook](https://www.volcengine.com/docs/6516/1223834) |查询访问控制地址簿，获取地址簿详情，用于审计或管理。 | |[DeleteAddressBook](https://www.volcengine.com/docs/6516/1223835) |删除访问控制地址簿，清理不再需要的地址集合。 | |[ModifyAddressBookList](https://www.volcengine.com/docs/6516/1783708) |增量更新地址簿，在现有地址簿中添加或删除IP，实现精细化管理。 | ## 互联网边界防火墙 |**API** |**说明** | |---|---| |[AddControlPolicy](https://www.volcengine.com/docs/6516/1223836) |创建互联网边界访问控制策略，精细化管理公网IP的访问权限。 | |[DescribeControlPolicy](https://www.volcengine.com/docs/6516/1223854) |查询互联网边界访问控制策略列表，用于审计与管理现有策略。 | |[DescribeControlPolicyByRuleId](https://www.volcengine.com/docs/6516/1223853) |查询单条访问控制策略详情，快速获取特定规则的配置信息。 | |[AssetList](https://www.volcengine.com/docs/6516/1223860) |查询互联网边界内的受保护资产列表，掌握资产安全状态。 | |[DescribeControlPolicyPriorUsed](https://volcengine.com/docs/6516/1223855) |查询访问控制策略的可用优先级范围，避免策略优先级冲突。 | |[UpdateControlPolicySwitch](https://www.volcengine.com/docs/6516/1223856) |启用或禁用指定的访问控制策略，快速响应安全需求变更。 | |[ModifyControlPolicyPosition](https://www.volcengine.com/docs/6516/1223857) |调整访问控制策略的执行优先级，优化策略匹配顺序。 | |[ModifyControlPolicy](https://www.volcengine.com/docs/6516/1223858) |修改已有的互联网边界访问控制策略，更新策略配置。 | |[UpdateAssets](https://www.volcengine.com/docs/6516/1223861) |为单个资产开启或关闭防护，灵活调整资产的防护状态。 | |[UpdateAssetSwitch](https://www.volcengine.com/docs/6516/1388013) |批量为多个资产开启或关闭防护，高效管理大规模资产。 | |[DeleteControlPolicy](https://www.volcengine.com/docs/6516/1223859) |删除不再需要的互联网边界访问控制策略。 | ## VPC 边界防火墙 |**API** |**说明** | |---|---| |[CreateVpcFirewall](https://www.volcengine.com/docs/6516/2139309) |创建 VPC 边界防火墙。 | |[ModifyVpcFirewall](https://www.volcengine.com/docs/6516/2139311) |修改指定 VPC 边界防火墙的带宽或名称。 | |[DeleteVpcFirewall](https://www.volcengine.com/docs/6516/2139310) |删除指定的 VPC 边界防火墙。 | |[AddVpcFirewallAclRule](https://www.volcengine.com/docs/6516/1223848) |创建VPC边界访问控制策略，管理VPC之间的网络互访权限。 | |[DescribeVpcFirewallList](https://www.volcengine.com/docs/6516/1223845) |查询VPC边界防火墙实例列表，掌握VPC防护状态。 | |[DescribeVpcFirewallAclRuleList](https://www.volcengine.com/docs/6516/1223850) |查询VPC边界访问控制策略列表，审计和管理VPC间的访问规则。 | |[DescribeVpcFirewallAclRulePriorUsed](https://www.volcengine.com/docs/6516/1223844) |查询VPC边界访问控制策略的可用优先级范围，避免策略冲突。 | |[UpdateVpcFirewallAclRuleSwitch](https://www.volcengine.com/docs/6516/1223851) |启用或禁用VPC边界的访问控制策略，快速调整VPC间的访问控制。 | |[ModifyVpcFirewallAclRulePosition](https://www.volcengine.com/docs/6516/1223843) |调整VPC边界访问控制策略的执行优先级，优化策略匹配逻辑。 | |[ModifyVpcFirewallAclRule](https://www.volcengine.com/docs/6516/1223852) |修改已有的VPC边界访问控制策略，更新VPC间的访问规则。 | |[DeleteVpcFirewallAclRule](https://www.volcengine.com/docs/6516/1223849) |删除不再需要的VPC边界访问控制策略。 | |[DescribeTransitRouterResourcesList](https://www.volcengine.com/docs/6516/2139312) |查询中转路由器实例下所有资源列表详情，包括资源 ID、名称以及引用计数等信息。 | |[DescribeVpcFirewallRoutePolicyList](https://www.volcengine.com/docs/6516/2139313) |查询 VPC 防火墙的引流场景列表详情，包括引流场景的名称、类型、创建时间以及状态等信息。 | |[CreateVpcFirewallRoutePolicy](https://www.volcengine.com/docs/6516/2139314) |为指定的 VPC 防火墙新建引流场景。 | |[UpdateVpcFirewallRoutePolicySwitch](https://www.volcengine.com/docs/6516/2139316) |开启或关闭指定的引流场景。 | |[ModifyVpcFirewallRoutePolicy](https://www.volcengine.com/docs/6516/2139317) |修改指定引流场景的配置。 | |[DeleteVpcFirewallRoutePolicy](https://www.volcengine.com/docs/6516/2139315) |删除指定的引流场景。 | ## NAT 边界防火墙 |**API** |**说明** | |---|---| |[AddNatFirewallControlPolicy](https://www.volcengine.com/docs/6516/1387359) |创建NAT边界访问控制策略，管理NAT网关的流量访问权限。 | |[DescribeNatFirewallList](https://www.volcengine.com/docs/6516/1387361) |查询NAT边界防火墙实例列表，了解NAT网关的防护状态。 | |[DescribeNatFirewallControlPolicy](https://www.volcengine.com/docs/6516/1387366) |查询NAT边界访问控制策略列表，审计和管理NAT网关的访问规则。 | |[DescribeNatFirewallControlPolicyPriorityUsed](https://www.volcengine.com/docs/6516/1387364) |查询NAT边界访问控制策略的可用优先级范围，避免策略冲突。 | |[UpdateNatFirewallControlPolicySwitch](https://www.volcengine.com/docs/6516/1387365) |启用或禁用NAT边界的访问控制策略，快速调整NAT网关的流量控制。 | |[ModifyNatFirewallControlPolicyPosition](https://www.volcengine.com/docs/6516/1387362) |调整NAT边界访问控制策略的执行优先级，优化策略匹配逻辑。 | |[ModifyNatFirewallControlPolicy](https://www.volcengine.com/docs/6516/1387360) |修改已有的NAT边界访问控制策略，更新NAT网关的访问规则。 | |[DeleteNatFirewallControlPolicy](https://www.volcengine.com/docs/6516/1387363) |删除不再需要的NAT边界访问控制策略。 | |[CreateNatFirewall](https://www.volcengine.com/docs/6516/1770768) |创建NAT防火墙实例，为NAT网关提供安全防护。 | |[DeleteNatFirewall](https://www.volcengine.com/docs/6516/1783707) |删除不再需要的NAT防火墙实例。 | ## DNS 防火墙 |**API** |**说明** | |---|---| |[AddDnsControlPolicy](https://www.volcengine.com/docs/6516/1400123) |创建DNS访问控制策略，拦截恶意的域名解析请求。 | |[ModifyDnsControlPolicy](https://www.volcengine.com/docs/6516/1400128) |修改已有的DNS访问控制策略，更新域名黑白名单。 | |[UpdateDnsControlPolicySwitch](https://www.volcengine.com/docs/6516/1400125) |启用或禁用DNS访问控制策略，快速调整域名解析的防护状态。 | |[DescribeVpcs](https://www.volcengine.com/docs/6516/1400126) |查询VPC列表，用于在配置DNS防火墙时选择需要防护的VPC。 | |[DescribeDnsControlPolicy](https://www.volcengine.com/docs/6516/1400124) |查询DNS访问控制策略列表，审计和管理域名解析规则。 | |[DeleteDnsControlPolicy](https://www.volcengine.com/docs/6516/1400127) |删除不再需要的DNS访问控制策略。 | ## 策略备份 |**API** |**说明** | |---|---| |[AddAclBackup](https://www.volcengine.com/docs/6516/2139293) |新增一个防火墙策略备份，后续可用于回滚互联网防火墙、VPC 防火墙或 NAT 防火墙策略。 | |[UseAclBackup](https://www.volcengine.com/docs/6516/2139300) |使用策略备份回滚互联网防火墙策略，或回滚指定的 VPC 防火墙、NAT 防火墙策略。 | |[DescribeAclBackup](https://www.volcengine.com/docs/6516/2139292) |获取策略备份列表。请求时支持分页查询、支持设置过滤条件，响应结果包含策略数量、策略备份以及防火墙实例等信息。 | |[DeleteAclBackup](https://www.volcengine.com/docs/6516/2139299) |删除指定的策略备份。 | ## 策略分析 |**API** |**说明** | |---|---| |[StartPolicyAnalyzeTask](https://www.volcengine.com/docs/6516/2139301) |为指定防火墙分析策略，可快速定位并优化问题策略，有效降低安全风险。 | |[GetPolicyAnalyzeOverview](https://www.volcengine.com/docs/6516/2139302) |获取指定策略分析结果的概览，包括防火墙类型及相应的风险数量。 | |[GetPolicyAnalyzeResult](https://www.volcengine.com/docs/6516/2139303) |获取指定策略分析的结果，包括分析任务的状态、策略检查类型及风险数量等信息。 | |[GetPolicyAnalyzeDetail](https://www.volcengine.com/docs/6516/2139304) |获取指定防火墙、指定检查类型的策略分析详情，包括问题类型、方向、状态以及策略 ID 等信息。 | |[UpdatePolicyResultStatus](https://www.volcengine.com/docs/6516/2139305) |更新指定策略分析结果的状态。 | ## 策略验证 |**API** |**说明** | |---|---| |[GetPolicyCheckResult](https://www.volcengine.com/docs/6516/2139306) |通过输入网络五元组信息（源 IP、目的 IP、协议、源端口、目的端口），快速确认指定流量是被防火墙策略放行还是阻断，便于故障排查。 | ## 告警通知 |**API** |**说明** | |---|---| |[QueryUserAlarmConfig](https://www.volcengine.com/docs/6516/2139307) |查询已配置的告警通知详情，包括互联网防火墙、VPC 防火墙、NAT 防火墙以及日志管理的告警通知。 | |[UpdateUserAlarmConfig](https://www.volcengine.com/docs/6516/2139308) |更新指定告警通知的配置项，包括告警开关、告警间隔以及告警动作等配置。 |