高级 TCP 防护 (Advanced TCP Protection)

您可以使用高级 TCP 防护 API 来配置高级 TCP 防护。

高级 TCP 防护 API 仅支持 API 令牌验证。

有关 API 调用的示例，请参阅常用 API 调用。

端点 (Endpoints)

要获取完整的端点，请将下面列出的高级 TCP 防护 API 端点附加到 Cloudflare API 基础 URL。

Cloudflare API 基础 URL 为：

https://api.cloudflare.com/client/v4

{account_id} 参数是账户 ID（十六进制字符串）。您可以在 Cloudflare 仪表板中找到此值。

以下各节中的表总结了可用的操作。

操作	方法与端点 / 描述
获取高级 TCP 防护状态	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status` 获取全局高级 TCP 防护状态（启用或禁用）。
更新高级 TCP 防护状态	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_protection_status` 启用或禁用高级 TCP 防护。

操作	方法与端点 / 描述
获取前缀列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes` 获取账户中的所有高级 TCP 防护前缀。
批量添加前缀	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/bulk` 向账户批量添加前缀（每次请求最多 300 个前缀）。
获取单个前缀	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` 获取现有前缀的详细信息。
更新一个前缀	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` 更新现有的前缀。
删除一个前缀	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes/{prefix_id}` 删除现有的前缀。
删除所有前缀	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/prefixes` 从账户中删除所有现有的前缀。

操作	方法与端点 / 描述
获取允许列表前缀列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` 获取账户允许列表中的所有前缀。
添加允许列表前缀	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` 向允许列表中添加前缀。
获取单个允许列表前缀	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` 获取允许列表中现有前缀的详细信息。
更新单个允许列表前缀	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` 更新允许列表中现有的前缀。
删除单个允许列表前缀	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist/{allowlist_id}` 从允许列表中删除现有的前缀。
删除所有允许列表前缀	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/allowlist` 从允许列表中删除所有现有的前缀。

操作	方法与端点 / 描述
获取 SYN 洪水规则列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` 获取账户中的所有 SYN 洪水规则。
添加一条 SYN 洪水规则	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` 向账户中添加一条 SYN 洪水规则。
获取单条 SYN 洪水规则	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` 获取账户中现有 SYN 洪水规则的详细信息。
更新一条 SYN 洪水规则	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` 更新账户中现有的 SYN 洪水规则。
删除一条 SYN 洪水规则	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules/{rule_id}` 从账户中删除现有的 SYN 洪水规则。
删除所有 SYN 洪水规则	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/rules` 从账户中删除所有现有的 SYN 洪水规则。

操作	方法与端点 / 描述
获取 SYN 洪水过滤器列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` 获取账户中的所有 SYN 洪水过滤器。
添加一个 SYN 洪水过滤器	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` 向账户中添加一个 SYN 洪水过滤器。
获取单个 SYN 洪水过滤器	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` 获取账户中现有 SYN 洪水过滤器的详细信息。
更新单个 SYN 洪水过滤器	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` 更新账户中现有的 SYN 洪水过滤器。
删除单个 SYN 洪水过滤器	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters/{filter_id}` 从账户中删除现有的 SYN 洪水过滤器。
删除所有 SYN 洪水过滤器	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/syn_protection/filters` 从账户中删除所有现有的 SYN 洪水过滤器。

操作	方法与端点 / 描述
获取 out-of-state TCP 规则列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` 获取账户中的所有 out-of-state TCP 规则。
添加一条 out-of-state TCP 规则	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` 向账户中添加一条 out-of-state TCP 规则。
获取单条 out-of-state TCP 规则	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` 获取账户中现有 out-of-state TCP 规则的详细信息。
更新一条 out-of-state TCP 规则	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` 更新账户中现有的 out-of-state TCP 规则。
删除一条 out-of-state TCP 规则	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules/{rule_id}` 从账户中删除现有的 out-of-state TCP 规则。
删除所有 out-of-state TCP 规则	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/rules` 从账户中删除所有现有的 out-of-state TCP 规则。

操作	方法与端点 / 描述
获取 out-of-state TCP 过滤器列表	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` 获取账户中的所有 out-of-state TCP 过滤器。
添加一个 out-of-state TCP 过滤器	`POST accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` 向账户中添加一个 out-of-state TCP 过滤器。
获取单个 out-of-state TCP 过滤器	`GET accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` 获取账户中现有 out-of-state TCP 过滤器的详细信息。
更新单个 out-of-state TCP 过滤器	`PATCH accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` 更新账户中现有的 out-of-state TCP 过滤器。
删除单个 out-of-state TCP 过滤器	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters/{filter_id}` 从账户中删除现有的 out-of-state TCP 过滤器。
删除所有 out-of-state TCP 过滤器	`DELETE accounts/{account_id}/magic/advanced_tcp_protection/configs/tcp_flow_protection/filters` 从账户中删除所有现有的 out-of-state TCP 过滤器。

返回项目列表的 API 操作使用分页。有关可用分页查询参数的更多信息，请参阅分页 (Pagination)。