mcpField
P
pp-cloudflare

pp-cloudflare

github.com/mvanhorn云与 DevOps2.1k162 次安装今天更新
代码仓库

关于 pp-cloudflare

pp-cloudflare 是通过 `cloudflare-pp-cli` 在终端操作 Cloudflare 的 skill,适用于处理账户、域名、基础设施和部署任务的 Agent,也可检查令牌权限与配置状态。

主要功能

  1. 01管理账户和区域
  2. 02操作 DNS、Workers、Pages 与 R2
  3. 03检查令牌权限和配置
  4. 04诊断 DNS、SSL 与 Email Routing 状态
  5. 05以隐藏输出方式管理 Worker 密钥
  6. 06查询 Cloudflare Radar 数据

适用场景

  1. 01将域名连接到 Pages 或 Workers
  2. 02变更前检查令牌访问权限
  3. 03诊断域名和邮件配置
  4. 04为 Agent 基础设施配置 Cloudflare 资源

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-cloudflare

安装后在 Claude Code 中输入/pp-cloudflare确认已加载。

详细介绍

Cloudflare — Printing Press CLI

前提条件:安装 CLI

此技能使用 cloudflare-pp-cli 二进制文件。**调用此技能中的任何命令前,必须确认 CLI 已安装。**如果尚未安装,请先安装:

  1. 使用 Printing Press 安装程序安装。macOS/Linux 上默认将二进制文件安装到 $HOME/.local/bin,Windows 上则安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin:
    npx -y @mvanhorn/printing-press-library install cloudflare --cli-only
    
  2. 验证:cloudflare-pp-cli --version
  3. 确保所报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败(没有 Node、处于离线状态等),请改用直接通过 Go 安装的方式(需要 Go 1.26.6 或更高版本)。此方式会将程序安装到 $GOPATH/bin(默认为 $HOME/go/bin),因此请将该目录添加到 $PATH:

go install github.com/mvanhorn/printing-press-library/library/cloud/cloudflare/cmd/cloudflare-pp-cli@latest

如果安装后 --version 报告“command not found”,说明运行时无法在 $PATH 中找到二进制文件目录。在验证成功之前,请勿继续执行技能命令。

cloudflare-pp-cli 是用于 Cloudflare 操作的 Printing Press CLI。需要从终端安全地访问账户、区域、DNS、Workers、Pages、R2、Email Routing、隧道、Zero Trust、Radar、令牌诊断和部署工作流时,请使用它。

对于在控制面板中操作起来比较繁琐的 Cloudflare 复合任务,此 CLI 尤其有用:在任务开始前检查令牌权限、将域名连接到 Pages 或 Workers、诊断 DNS/SSL/Email Routing 就绪状态、通过脱敏输出管理 Worker 密钥、扫描成本和用量信号,或为 Agent 基础设施创建 R2/D1/KV/Queues/Vectorize/AI Gateway 资源。

身份验证以令牌为先。优先使用 CLOUDFLARE_API_TOKEN 中的作用域 API 令牌,或使用 cloudflare-pp-cli auth set-token;除非旧版端点要求,否则请避免使用全局 API 密钥。在进行线上变更前,请使用 token doctor 和配方命令,以便 Agent 申请范围最小且可行的权限。

命令参考

accounts — 管理账户

  • cloudflare-pp-cli accounts batch-move — 将一组账户批量迁移到指定组织。⚠️ 尚未实现。
  • cloudflare-pp-cli accounts creation — 创建账户(目前仅租户管理员可用)
  • cloudflare-pp-cli accounts deletion — 删除指定账户(目前仅租户管理员可用)。
  • cloudflare-pp-cli accounts details — 获取你所属特定账户的信息。
  • cloudflare-pp-cli accounts list — 列出你拥有或已验证有权访问的所有账户。
  • cloudflare-pp-cli accounts update — 更新现有账户。

certificates — 管理证书

  • cloudflare-pp-cli certificates origin-ca-create — 创建 Origin CA 证书。
  • cloudflare-pp-cli certificates origin-ca-get — 根据序列号获取现有 Origin CA 证书。
  • cloudflare-pp-cli certificates origin-ca-list — 列出指定区域的所有现有 Origin CA 证书。
  • cloudflare-pp-cli certificates origin-ca-revoke — 根据序列号撤销现有 Origin CA 证书。

internal — 管理内部功能

  • cloudflare-pp-cli internal — 用于测试 URL 提交的内部路由

ips — 管理 IP

live — 管理运行状态

  • cloudflare-pp-cli live — 运行存活检查后返回成功消息

memberships — 管理成员关系

  • cloudflare-pp-cli memberships user-s-account-delete — 从账户中移除关联成员。
  • cloudflare-pp-cli memberships user-s-account-details — 获取特定成员关系。
  • cloudflare-pp-cli memberships user-s-account-list — 列出用户可访问账户的成员关系。
  • cloudflare-pp-cli memberships user-s-account-update — 接受或拒绝此账户邀请。

oauth — 管理 OAuth

  • cloudflare-pp-cli oauth — 列出所有可用的 OAuth scope。此端点需要身份验证,但没有授权角色要求。

organizations — 管理组织

radar — 管理 radar

  • cloudflare-pp-cli radar get-agent-readiness-summary — 返回已扫描域名的 AI Agent 就绪度评分汇总,并按指定维度分组。

  • cloudflare-pp-cli radar get-ai-bots-summary — 获取按指定维度分组的 AI 机器人 HTTP 请求汇总。

  • cloudflare-pp-cli radar get-ai-bots-summary-by-user-agent — 获取按 AI 用户代理划分的流量分布。

  • cloudflare-pp-cli radar get-ai-bots-timeseries — 获取 AI 机器人 HTTP 请求量随时间的变化。

  • cloudflare-pp-cli radar get-ai-bots-timeseries-group — 获取按指定维度分组的 AI 机器人 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-ai-bots-timeseries-group-by-user-agent — 获取按 AI 用户代理划分的流量分布随时间的变化。

  • cloudflare-pp-cli radar get-ai-inference-summary — 获取按指定维度分组的使用 Workers AI 推理的唯一账户汇总。

  • cloudflare-pp-cli radar get-ai-inference-summary-by-model — 获取按模型划分的唯一账户分布。

  • cloudflare-pp-cli radar get-ai-inference-summary-by-task — 获取按任务划分的唯一账户分布。

  • cloudflare-pp-cli radar get-ai-inference-timeseries-group — 获取按指定维度分组的使用 Workers AI 推理的唯一账户分布随时间的变化。

  • cloudflare-pp-cli radar get-ai-inference-timeseries-group-by-model — 获取按模型划分的唯一账户分布随时间的变化。

  • cloudflare-pp-cli radar get-ai-inference-timeseries-group-by-task — 获取按任务划分的唯一账户分布随时间的变化。

  • cloudflare-pp-cli radar get-ai-markdown-for-agents-summary — 获取给定日期范围内 AI Agent 请求的 HTML 到 Markdown 总体中位数缩减率。

  • cloudflare-pp-cli radar get-ai-markdown-for-agents-timeseries — 获取 AI Agent 请求的 HTML 到 Markdown 中位数缩减率随时间的变化。

  • cloudflare-pp-cli radar get-annotations — 获取最新注释。

  • cloudflare-pp-cli radar get-annotations-outages — 获取最新的互联网中断和异常事件。

  • cloudflare-pp-cli radar get-annotations-outages-top — 获取按位置划分的中断事件数量。

  • cloudflare-pp-cli radar get-as-botnet-threat-feed — 获取根据自治系统出现在 Cloudflare Botnet Threat Feed 中的情况排名的列表。

  • cloudflare-pp-cli radar get-asns-as-set — 获取 AS 所属的 Internet Routing Registry AS-SET。

  • cloudflare-pp-cli radar get-asns-rel — 获取给定网络的 AS 级关系。

  • cloudflare-pp-cli radar get-attacks-layer3-summary — 获取按指定维度划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-bitrate — 获取按比特率划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-duration — 获取按持续时间划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-industry — 获取按目标行业划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-ip-version — 获取按 IP 版本划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-protocol — 获取按协议划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-vector — 获取按攻击向量划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-summary-by-vertical — 获取按目标垂直行业划分的第 3 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-by-bytes — 获取按字节数统计的第 3 层攻击时间序列。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group — 获取按维度分组的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-bitrate — 获取按比特率划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-duration — 获取按持续时间划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-industry — 获取按目标行业划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-ip-version — 获取按 IP 版本划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-protocol — 获取按协议划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-vector — 获取按攻击向量划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-timeseries-group-by-vertical — 获取按目标垂直行业划分的第 3 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer3-top-attacks — 获取从源位置到目标位置的顶级第 3 层攻击。

  • cloudflare-pp-cli radar get-attacks-layer3-top-industries — 此端点已弃用。若要继续获取此数据,请改用按行业汇总的端点。

  • cloudflare-pp-cli radar get-attacks-layer3-top-origin-locations — 获取第 3 层攻击的源位置。

  • cloudflare-pp-cli radar get-attacks-layer3-top-target-locations — 获取第 3 层攻击的目标位置。

  • cloudflare-pp-cli radar get-attacks-layer3-top-verticals — 此端点已弃用。若要继续获取此数据,请改用按垂直行业汇总的端点。

  • cloudflare-pp-cli radar get-attacks-layer7-summary — 获取按指定维度划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-http-method — 获取按 HTTP 方法划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-http-version — 获取按 HTTP 版本划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-industry — 获取按目标行业划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-ip-version — 获取按 IP 版本划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-managed-rules — 获取按托管规则划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-mitigation-product — 获取按缓解产品划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-summary-by-vertical — 获取按目标垂直行业划分的第 7 层攻击分布。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries — 获取第 7 层攻击随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group — 获取按维度分组的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-http-method — 获取按 HTTP 方法划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-http-version — 获取按 HTTP 版本划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-industry — 获取按目标行业划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-ip-version — 获取按所用 IP 版本划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-managed-rules — 获取按托管规则划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-mitigation-product — 获取按缓解产品划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-timeseries-group-by-vertical — 获取按目标垂直行业划分的第 7 层攻击分布随时间的变化。

  • cloudflare-pp-cli radar get-attacks-layer7-top-attacks — 获取从源位置到目标位置的顶级攻击。

  • cloudflare-pp-cli radar get-attacks-layer7-top-industries — 此端点已弃用。若要继续获取此数据,请改用按行业汇总的端点。

  • cloudflare-pp-cli radar get-attacks-layer7-top-origin-as — 获取第 7 层攻击的主要源自治系统。

  • cloudflare-pp-cli radar get-attacks-layer7-top-origin-location — 获取第 7 层攻击的主要源位置。

  • cloudflare-pp-cli radar get-attacks-layer7-top-target-location — 获取第 7 层攻击的主要目标位置。数值表示占第 7 层攻击总数的百分比。

  • cloudflare-pp-cli radar get-attacks-layer7-top-verticals — 此端点已弃用。若要继续获取此数据,请改用按垂直行业汇总的端点。

  • cloudflare-pp-cli radar get-bgp-hijacks-events — 获取 BGP 劫持事件。

  • cloudflare-pp-cli radar get-bgp-ips-timeseries — 获取已通告 IP 地址空间数量的时间序列数据,以 IPv4 /24 和 IPv6 /48 的数量表示。

  • cloudflare-pp-cli radar get-bgp-ips-top-ases — 返回在当前时间之前最近的 8 小时 RIB 边界处,按已通告 IP 地址空间排名的前 N 个自治系统。

  • cloudflare-pp-cli radar get-bgp-pfx2as — 获取全球路由表中的前缀到 ASN 映射。

  • cloudflare-pp-cli radar get-bgp-pfx2as-moas — 获取全球路由表中的所有多源 AS(MOAS)前缀。

  • cloudflare-pp-cli radar get-bgp-route-leak-events — 获取 BGP 路由泄漏事件。

  • cloudflare-pp-cli radar get-bgp-routes-asns — 获取当前全球路由表中的所有 AS 及其路由统计信息。

  • cloudflare-pp-cli radar get-bgp-routes-realtime — 使用公开的实时数据收集器(RouteViews 和 RIPE RIS)获取指定前缀的实时 BGP 路由。

  • cloudflare-pp-cli radar get-bgp-routes-stats — 获取 BGP 路由表统计信息。

  • cloudflare-pp-cli radar get-bgp-rpki-aspa-changes — 获取 ASPA(自治系统提供商授权)随时间的变化。

  • cloudflare-pp-cli radar get-bgp-rpki-aspa-snapshot — 获取当前或历史 ASPA(自治系统提供商授权)对象。

  • cloudflare-pp-cli radar get-bgp-rpki-aspa-timeseries — 获取 ASPA(自治系统提供商授权)对象数量随时间的变化。

  • cloudflare-pp-cli radar get-bgp-rpki-roas-timeseries — 获取 RPKI ROA(路由起源授权)验证比率随时间的变化。

  • cloudflare-pp-cli radar get-bgp-timeseries — 获取 BGP 更新随时间的变化。

  • cloudflare-pp-cli radar get-bgp-top-ases — 获取按 BGP 更新(仅通告)排名的顶级自治系统。

  • cloudflare-pp-cli radar get-bgp-top-asns-by-prefixes — 获取全球路由表中所有自治系统的完整列表,按通告前缀数量排序。

  • cloudflare-pp-cli radar get-bgp-top-prefixes — 获取按 BGP 更新排名的顶级网络前缀。

  • cloudflare-pp-cli radar get-bot-details — 获取所请求的机器人信息。

  • cloudflare-pp-cli radar get-bots — 获取机器人列表。

  • cloudflare-pp-cli radar get-bots-summary — 获取按指定维度分组的机器人 HTTP 请求汇总。

  • cloudflare-pp-cli radar get-bots-timeseries — 获取机器人 HTTP 请求量随时间的变化。

  • cloudflare-pp-cli radar get-bots-timeseries-group — 获取按指定维度分组的机器人 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-certificate-authorities — 获取证书颁发机构列表。

  • cloudflare-pp-cli radar get-certificate-authority-details — 获取所请求的 CA 信息。

  • cloudflare-pp-cli radar get-certificate-log-details — 获取所请求的证书日志信息。

  • cloudflare-pp-cli radar get-certificate-logs — 获取证书日志列表。

  • cloudflare-pp-cli radar get-crawlers-summary — 获取按指定维度分组的爬虫 HTTP 请求汇总。

  • cloudflare-pp-cli radar get-crawlers-timeseries-group — 获取按指定维度分组的爬虫 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-ct-summary — 获取按指定维度分组的证书汇总。

  • cloudflare-pp-cli radar get-ct-timeseries — 获取证书数量随时间的变化。

  • cloudflare-pp-cli radar get-ct-timeseries-group — 获取按指定维度分组的证书分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-summary — 获取按指定维度划分的 AS112 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries — 获取 AS112 DNS 查询随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-dnssec — 获取按 DNSSEC(DNS 安全扩展)支持情况划分的 AS112 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-edns — 获取按 EDNS(DNS 扩展机制)支持情况划分的 AS112 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-ip-version — 获取按 IP 版本划分的 AS112 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-protocol — 获取按协议划分的 AS112 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-query-type — 获取按类型划分的 AS112 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-by-response-codes — 获取按响应代码分类的 AS112 DNS 请求分布。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group — 获取按维度分组的 AS112 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-dnssec — 获取按 DNSSEC(DNS 安全扩展)支持情况划分的 AS112 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-edns — 获取按 EDNS(DNS 扩展机制)支持情况划分的 AS112 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-ip-version — 获取按 IP 版本划分的 AS112 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-protocol — 获取按协议分类的 AS112 DNS 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-query-type — 获取按类型划分的 AS112 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-timeseries-group-by-response-codes — 获取按响应代码分类的 AS112 DNS 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-as112-top-locations — 获取 AS112 DNS 查询量最高的位置。

  • cloudflare-pp-cli radar get-dns-as112-top-locations-by-dnssec — 获取支持 DNSSEC(DNS 安全扩展)的 AS112 DNS 查询的主要位置。

  • cloudflare-pp-cli radar get-dns-as112-top-locations-by-edns — 获取支持 EDNS(DNS 扩展机制)的 AS112 DNS 查询的主要位置。

  • cloudflare-pp-cli radar get-dns-as112-top-locations-by-ip-version — 获取指定 IP 版本的 AS112 DNS 查询的主要位置。

  • cloudflare-pp-cli radar get-dns-summary — 获取按指定维度划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-cache-hit-status — 获取按缓存状态划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-dnssec — 获取按 DNSSEC(DNS 安全扩展)支持情况划分的 DNS 响应分布。

  • cloudflare-pp-cli radar get-dns-summary-by-dnssec-awareness — 获取按客户端对 DNSSEC(DNS 安全扩展)的认知情况划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-dnssec-e2e-version — 获取按端到端安全状态划分的 DNSSEC 验证答案分布。

  • cloudflare-pp-cli radar get-dns-summary-by-ip-version — 获取按 IP 版本划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-matching-answer-status — 获取按匹配答案划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-protocol — 获取按 DNS 传输协议划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-query-type — 获取按类型划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-response-code — 获取按响应代码划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-summary-by-response-ttl — 获取按最小响应 TTL 划分的 DNS 查询分布。

  • cloudflare-pp-cli radar get-dns-timeseries — 获取发往 1.1.1.1 DNS 解析器的归一化查询量随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group — 获取按维度分组的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-cache-hit-status — 获取按缓存状态划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-dnssec — 获取按 DNSSEC(DNS 安全扩展)支持情况划分的 DNS 响应分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-dnssec-awareness — 获取按客户端对 DNSSEC(DNS 安全扩展)的认知情况划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-dnssec-e2e-version — 获取按端到端安全状态划分的 DNSSEC 验证答案分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-ip-version — 获取按 IP 版本划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-matching-answer-status — 获取按匹配答案划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-protocol — 获取按 DNS 传输协议划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-query-type — 获取按类型划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-response-code — 获取按响应代码划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-timeseries-group-by-response-ttl — 获取按最小答案 TTL 划分的 DNS 查询分布随时间的变化。

  • cloudflare-pp-cli radar get-dns-top-ases — 获取向 1.1.1.1 DNS 解析器发出 DNS 查询量最高的自治系统。

  • cloudflare-pp-cli radar get-dns-top-locations — 获取向 1.1.1.1 DNS 解析器发出 DNS 查询量最高的位置。

  • cloudflare-pp-cli radar get-email-routing-summary — 获取按指定维度划分的电子邮件路由指标分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-arc — 获取按 ARC(已认证接收链)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-dkim — 获取按 DKIM(域名密钥识别邮件)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-dmarc — 获取按 DMARC(基于域名的消息认证、报告与一致性)划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-encrypted — 获取按加密状态(已加密或未加密)划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-ip-version — 获取按 IP 版本划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-summary-by-spf — 获取按 SPF(发件人策略框架)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group — 获取按维度分组的电子邮件路由指标分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-arc — 获取按 ARC(已认证接收链)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-dkim — 获取按 DKIM(域名密钥识别邮件)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-dmarc — 获取按 DMARC(基于域名的消息认证、报告与一致性)划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-encrypted — 获取按加密状态(已加密或未加密)划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-ip-version — 获取按 IP 版本划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-routing-timeseries-group-by-spf — 获取按 SPF(发件人策略框架)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-summary — 获取按指定维度划分的电子邮件安全指标分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-arc — 获取按 ARC(已认证接收链)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-dkim — 获取按 DKIM(域名密钥识别邮件)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-dmarc — 获取按 DMARC(基于域名的消息认证、报告与一致性)划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-malicious — 获取按恶意分类划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-spam — 获取按垃圾邮件分类(垃圾邮件或非垃圾邮件)划分的电子邮件比例。

  • cloudflare-pp-cli radar get-email-security-summary-by-spf — 获取按 SPF(发件人策略框架)验证结果划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-spoof — 获取按伪造分类(伪造或非伪造)划分的电子邮件比例。

  • cloudflare-pp-cli radar get-email-security-summary-by-threat-category — 获取按威胁类别划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-summary-by-tls-version — 获取按 TLS 版本划分的电子邮件分布。

  • cloudflare-pp-cli radar get-email-security-timeseries-group — 获取按维度分组的电子邮件安全指标分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-arc — 获取按 ARC(已认证接收链)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-dkim — 获取按 DKIM(域名密钥识别邮件)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-dmarc — 获取按 DMARC(基于域名的消息认证、报告与一致性)划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-malicious — 获取按恶意分类划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-spam — 获取按垃圾邮件分类(垃圾邮件或非垃圾邮件)划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-spf — 获取按 SPF(发件人策略框架)验证结果划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-spoof — 获取按伪造分类(伪造或非伪造)划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-threat-category — 获取按威胁类别划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-timeseries-group-by-tls-version — 获取按 TLS 版本划分的电子邮件分布随时间的变化。

  • cloudflare-pp-cli radar get-email-security-top-tlds-by-malicious — 获取按恶意或非恶意分类的电子邮件数量排名的顶级 TLD。

  • cloudflare-pp-cli radar get-email-security-top-tlds-by-messages — 获取按电子邮件消息数量排名的顶级 TLD。

  • cloudflare-pp-cli radar get-email-security-top-tlds-by-spam — 获取按垃圾邮件或非垃圾邮件分类的电子邮件数量排名的顶级 TLD。

  • cloudflare-pp-cli radar get-email-security-top-tlds-by-spoof — 获取按伪造或非伪造分类的电子邮件数量排名的顶级 TLD。

  • cloudflare-pp-cli radar get-entities-asn-by-id — 获取所请求的自治系统信息。

  • cloudflare-pp-cli radar get-entities-asn-by-ip — 根据 IP 地址获取所请求的自治系统信息。

  • cloudflare-pp-cli radar get-entities-asn-list — 获取自治系统列表。

  • cloudflare-pp-cli radar get-entities-ip — 获取 IP 地址信息。

  • cloudflare-pp-cli radar get-entities-location-by-alpha2 — 获取所请求的位置信息。

  • cloudflare-pp-cli radar get-entities-locations — 获取位置列表。

  • cloudflare-pp-cli radar get-geolocation-details — 获取所请求的地理位置数据。

  • cloudflare-pp-cli radar get-geolocations — 获取地理位置列表。

  • cloudflare-pp-cli radar get-http-summary — 获取按指定维度划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-bot-class — 获取 Cloudflare 分类的机器人生成 HTTP 请求与真实人类流量的分布。

  • cloudflare-pp-cli radar get-http-summary-by-device-type — 获取由移动设备、桌面设备及其他类型设备生成的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-http-protocol — 获取按 HTTP 协议(HTTP 或 HTTPS)划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-http-version — 获取按 HTTP 版本划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-ip-version — 获取按 IP 版本划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-operating-system — 获取按操作系统(Windows、macOS、Android、iOS 等)划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-post-quantum — 获取按后量子支持情况划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-summary-by-tls-version — 获取按 TLS 版本划分的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-timeseries — 获取 HTTP 请求随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group — 获取按维度分组的 HTTP 请求分布。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-bot-class — 获取按自动化流量或人类流量分类的 HTTP 请求分布随时间的变化。请访问 https://developers。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-browser-families — 获取按用户代理系列划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-browsers — 获取按用户代理划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-device-type — 获取按设备类型划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-http-protocol — 获取按 HTTP 协议(HTTP 或 HTTPS)划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-http-version — 获取按 HTTP 版本划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-ip-version — 获取按 IP 版本划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-operating-system — 获取按操作系统划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-post-quantum — 获取按后量子支持情况划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-timeseries-group-by-tls-version — 获取按 TLS 版本划分的 HTTP 请求分布随时间的变化。

  • cloudflare-pp-cli radar get-http-top-ases-by-bot-class — 获取指定机器人类别中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-browser-family — 获取指定浏览器系列中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-device-type — 获取指定设备类型中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-http-protocol — 获取指定 HTTP 协议中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-http-requests — 获取按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-http-version — 获取指定 HTTP 版本中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-ip-version — 获取指定 IP 版本中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-operating-system — 获取指定操作系统中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-ases-by-tls-version — 获取指定 TLS 协议版本中按 HTTP 请求量排名的顶级自治系统。

  • cloudflare-pp-cli radar get-http-top-browser-families — 获取按 HTTP 请求量排名、按系列汇总的顶级用户代理。

  • cloudflare-pp-cli radar get-http-top-browsers — 获取按 HTTP 请求量排名的顶级用户代理。

  • cloudflare-pp-cli radar get-http-top-locations-by-bot-class — 获取指定机器人类别中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-browser-family — 获取指定浏览器系列中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-device-type — 获取指定设备类型中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-http-protocol — 获取指定 HTTP 协议中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-http-requests — 获取按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-http-version — 获取指定 HTTP 版本中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-ip-version — 获取指定 IP 版本中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-operating-system — 获取指定操作系统中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-http-top-locations-by-tls-version — 获取指定 TLS 协议版本中按 HTTP 请求量排名的顶级位置。

  • cloudflare-pp-cli radar get-leaked-credential-checks-summary — 获取按指定维度分组的 HTTP 身份验证请求汇总。

  • cloudflare-pp-cli radar get-leaked-credential-checks-summary-by-bot-class — 获取按机器人类别划分的 HTTP 身份验证请求分布。

  • cloudflare-pp-cli radar get-leaked-credential-checks-summary-by-compromised — 获取按凭据泄露状态划分的 HTTP 身份验证请求分布。

  • cloudflare-pp-cli radar get-leaked-credential-checks-timeseries-group — 获取按指定维度分组的 HTTP 身份验证请求分布随时间的变化。

  • cloudflare-pp-cli radar get-leaked-credential-checks-timeseries-group-by-bot-class — 获取按机器人类别划分的 HTTP 身份验证请求分布随时间的变化。

  • cloudflare-pp-cli radar get-leaked-credential-checks-timeseries-group-by-compromised — 获取按凭据泄露状态划分的 HTTP 身份验证请求分布随时间的变化。

  • cloudflare-pp-cli radar get-netflows-summary — 获取按指定维度划分的网络流量(NetFlows)分布。

  • cloudflare-pp-cli radar get-netflows-summary-deprecated — 获取按 HTTP 与其他协议划分的网络流量(NetFlows)分布。

  • cloudflare-pp-cli radar get-netflows-timeseries — 获取网络流量(NetFlows)随时间的变化。

  • cloudflare-pp-cli radar get-netflows-timeseries-group — 获取按指定维度分组的 NetFlows 流量分布随时间的变化。

  • cloudflare-pp-cli radar get-netflows-top-ases — 获取网络流量(NetFlows)最大的顶级自治系统。

  • cloudflare-pp-cli radar get-netflows-top-locations — 获取网络流量(NetFlows)最大的顶级位置。

  • cloudflare-pp-cli radar get-origin-details — 获取所请求源站及其区域的信息。

  • cloudflare-pp-cli radar get-origin-post-quantum-summary — 返回按指定维度分组的源站后量子数据汇总。

  • cloudflare-pp-cli radar get-origin-post-quantum-timeseries-groups — 返回按指定维度分组的源站后量子数据时间序列。

  • cloudflare-pp-cli radar get-origins — 获取源站及其区域的列表。

  • cloudflare-pp-cli radar get-origins-summary — 获取按指定维度分组的源站指标汇总。

  • cloudflare-pp-cli radar get-origins-timeseries — 获取指定源站指标的时间序列。

  • cloudflare-pp-cli radar get-origins-timeseries-group — 获取按指定维度分组的源站指标分布随时间的变化。

  • cloudflare-pp-cli radar get-post-quantum-tls-support — 测试主机名或 IP 地址是否支持后量子(PQ)TLS 密钥交换。

  • cloudflare-pp-cli radar get-quality-index-summary — 获取带宽和延迟的汇总(百分位数)。

  • cloudflare-pp-cli radar get-quality-index-timeseries-group — 获取带宽和延迟的时间序列(百分位数)。

  • cloudflare-pp-cli radar get-quality-speed-histogram — 获取过去 90 天 Cloudflare Speed Test 数据的直方图,并按固定带宽(Mbps)区间划分。

  • cloudflare-pp-cli radar get-quality-speed-summary — 获取带宽、延迟、抖动和丢包的汇总。

  • cloudflare-pp-cli radar get-quality-speed-top-ases — 获取按带宽、延迟、抖动或丢包指标排名的顶级自治系统。

  • cloudflare-pp-cli radar get-quality-speed-top-locations — 获取按带宽、延迟、抖动或丢包指标排名的顶级位置。

  • cloudflare-pp-cli radar get-ranking-domain-details — 获取域名排名详情。

  • cloudflare-pp-cli radar get-ranking-domain-timeseries — 获取域名排名随时间的变化。

  • cloudflare-pp-cli radar get-ranking-internet-services-categories — 获取互联网服务类别列表。

  • cloudflare-pp-cli radar get-ranking-internet-services-timeseries — 获取互联网服务排名更新的变化情况。

  • cloudflare-pp-cli radar get-ranking-top-domains — 根据排名获取顶级域名或热门域名。

  • cloudflare-pp-cli radar get-ranking-top-internet-services — 根据排名获取顶级互联网服务。

  • cloudflare-pp-cli radar get-reports-dataset-download — 获取指定别名或 ID 对应数据集的 CSV 内容。

  • cloudflare-pp-cli radar get-reports-datasets — 获取数据集列表。

  • cloudflare-pp-cli radar get-robots-txt-top-domain-categories-by-files-parsed — 获取按已解析 robots.txt 文件数量排名的顶级域名类别。

  • cloudflare-pp-cli radar get-robots-txt-top-user-agents-by-directive — 获取 robots.txt 文件中排名靠前的用户代理。

  • cloudflare-pp-cli radar get-search-global — 搜索位置、自治系统、报告、机器人、证书日志和证书颁发机构。

  • cloudflare-pp-cli radar get-tcp-resets-timeouts-summary — 获取前 10 个数据包内因重置或

  • cloudflare-pp-cli radar get-tcp-resets-timeouts-timeseries-group — 获取前 10 个数据包内因重置或终止的 TCP 连接的连接阶段分布。

  • cloudflare-pp-cli radar get-tld-details — 获取所请求的 TLD 信息。

  • cloudflare-pp-cli radar get-tlds — 获取 TLD 列表。

  • cloudflare-pp-cli radar get-tlds-performance-summary — 返回按指定维度分组的 TLD 权威名称服务器性能汇总。

  • cloudflare-pp-cli radar get-tlds-performance-timeseries-groups — 返回按指定维度分组的 TLD 权威名称服务器性能时间序列。

  • cloudflare-pp-cli radar get-traffic-anomalies — 获取最新的互联网流量异常事件,这些信号可能表明发生了中断。

  • cloudflare-pp-cli radar get-traffic-anomalies-top — 获取按位置分组的互联网流量异常事件总数。

  • cloudflare-pp-cli radar get-verified-bots-top-by-http-requests — 获取按 HTTP 请求量排名的顶级已验证机器人,并附带所有者和类别信息。

  • cloudflare-pp-cli radar get-verified-bots-top-categories-by-http-requests — 获取按 HTTP 请求量排名的顶级已验证机器人类别及其对应百分比。

  • cloudflare-pp-cli radar post-reports-dataset-download-url — 获取用于下载单个数据集的 URL。 ready — 管理就绪状态

  • cloudflare-pp-cli ready — 运行就绪检查后返回成功消息

signed-url — 管理签名 URL

  • cloudflare-pp-cli signed-url — 用于测试签名 URL 的内部路由

system — 管理系统

  • cloudflare-pp-cli system secrets-store-create — 代表调用服务在账户中创建一个存储。
  • cloudflare-pp-cli system secrets-store-delete-bulk — 删除调用服务管理的存储中的一个或多个机密。
  • cloudflare-pp-cli system secrets-store-delete-by-id — 删除调用服务管理的存储。
  • cloudflare-pp-cli system secrets-store-duplicate-by-id — 在调用服务管理的存储中复制一个机密,并保留其值。
  • cloudflare-pp-cli system secrets-store-get-by-id — 返回调用服务管理的存储中单个机密的详细信息。
  • cloudflare-pp-cli system secrets-store-get-store-by-id — 返回调用服务管理的单个存储的详细信息。
  • cloudflare-pp-cli system secrets-store-list — 列出账户中由调用服务管理的所有存储。
  • cloudflare-pp-cli system secrets-store-patch-by-id — 更新调用服务管理的存储中的单个机密。
  • cloudflare-pp-cli system secrets-store-secret-create — 在调用服务管理的存储中创建一个或多个机密。
  • cloudflare-pp-cli system secrets-store-secret-delete-by-id — 从调用服务管理的存储中删除单个机密。
  • cloudflare-pp-cli system secrets-store-secrets-list — 列出调用服务管理的存储中的所有机密。

tenants — 管理租户

  • cloudflare-pp-cli tenants <tenant_id> — 根据租户 ID 检索租户。

user — 管理用户

  • cloudflare-pp-cli user api-tokens-create-token — 创建新的访问令牌。

  • cloudflare-pp-cli user api-tokens-delete-token — 销毁令牌。

  • cloudflare-pp-cli user api-tokens-list-tokens — 列出你创建的所有访问令牌。

  • cloudflare-pp-cli user api-tokens-roll-token — 轮换令牌密钥。

  • cloudflare-pp-cli user api-tokens-token-details — 获取特定令牌的信息。

  • cloudflare-pp-cli user api-tokens-update-token — 更新现有令牌。

  • cloudflare-pp-cli user api-tokens-verify-token — 测试令牌是否有效。

  • cloudflare-pp-cli user audit-logs-get-audit-logs — 获取用户账户的审计日志列表。

  • cloudflare-pp-cli user billing-history-deprecated-billing-history-details — 访问你的账单历史对象。

  • cloudflare-pp-cli user billing-profile-deprecated-billing-profile-details — 访问你的账单资料对象。

  • cloudflare-pp-cli user details — 用户详情

  • cloudflare-pp-cli user edit — 编辑部分用户详情。

  • cloudflare-pp-cli user ip-access-rules-for-a-create-an-ip-access-rule — 为当前用户拥有的所有区域创建新的 IP 访问规则。

  • cloudflare-pp-cli user ip-access-rules-for-a-delete-an-ip-access-rule — 删除用户级别的 IP 访问规则。注意:删除用户级别的规则会影响该用户拥有的所有区域。

  • cloudflare-pp-cli user ip-access-rules-for-a-list-ip-access-rules — 获取用户的 IP 访问规则。你可以使用多个可选参数筛选结果。

  • cloudflare-pp-cli user ip-access-rules-for-a-update-an-ip-access-rule — 更新在用户级别定义的 IP 访问规则。你只能更新规则操作(mode 参数)和备注。

  • cloudflare-pp-cli user list-tenants — 获取经过身份验证的用户/方法有权访问的租户列表。

  • cloudflare-pp-cli user load-balancer-healthcheck-events-list-healthcheck-events — 列出源站健康状态变更。

  • cloudflare-pp-cli user load-balancer-monitors-create-monitor — 创建已配置的监视器。

  • cloudflare-pp-cli user load-balancer-monitors-delete-monitor — 删除已配置的监视器。

  • cloudflare-pp-cli user load-balancer-monitors-list-monitor-references — 获取引用指定监视器的资源列表。

  • cloudflare-pp-cli user load-balancer-monitors-list-monitors — 列出用户已配置的监视器。

  • cloudflare-pp-cli user load-balancer-monitors-monitor-details — 列出用户配置的单个监视器。

  • cloudflare-pp-cli user load-balancer-monitors-patch-monitor — 对现有监视器应用更改,覆盖提供的属性。

  • cloudflare-pp-cli user load-balancer-monitors-preview-monitor — 使用指定的监视器和提供的监视器详情预览池。

  • cloudflare-pp-cli user load-balancer-monitors-preview-result — 使用提供的 preview_id 获取先前预览操作的结果。

  • cloudflare-pp-cli user load-balancer-monitors-update-monitor — 修改已配置的监视器。

  • cloudflare-pp-cli user load-balancer-pools-create-pool — 创建新池。

  • cloudflare-pp-cli user load-balancer-pools-delete-pool — 删除已配置的池。

  • cloudflare-pp-cli user load-balancer-pools-list-pool-references — 获取引用指定池的资源列表。

  • cloudflare-pp-cli user load-balancer-pools-list-pools — 列出已配置的池。

  • cloudflare-pp-cli user load-balancer-pools-patch-pool — 对现有池应用更改,覆盖提供的属性。

  • cloudflare-pp-cli user load-balancer-pools-patch-pools — 对多个现有池应用更改,覆盖提供的属性。池按 name 升序排列。

  • cloudflare-pp-cli user load-balancer-pools-pool-details — 获取单个已配置的池。

  • cloudflare-pp-cli user load-balancer-pools-pool-health-details — 获取单个池的最新健康状态。

  • cloudflare-pp-cli user load-balancer-pools-preview-pool — 使用提供的监视器详情预览池的健康状态。

  • cloudflare-pp-cli user load-balancer-pools-update-pool — 修改已配置的池。

  • cloudflare-pp-cli user permission-groups-list-permission-groups — 查找 API 令牌的所有可用权限组。

  • cloudflare-pp-cli user s-invites-invitation-details — 获取邀请详情。

  • cloudflare-pp-cli user s-invites-list-invitations — 列出与我的用户关联的所有邀请。

  • cloudflare-pp-cli user s-invites-respond-to-invitation — 回复邀请。

  • cloudflare-pp-cli user s-organizations-leave-organization — 解除与组织的关联。

  • cloudflare-pp-cli user s-organizations-list-organizations — 列出用户关联的组织。

  • cloudflare-pp-cli user s-organizations-organization-details — 获取用户关联的特定组织。

  • cloudflare-pp-cli user subscription-delete-subscription — 删除用户的订阅。

  • cloudflare-pp-cli user subscription-get-subscriptions — 列出用户的所有订阅。

  • cloudflare-pp-cli user subscription-update-subscription — 更新用户的订阅。 workers — 管理 workers

  • cloudflare-pp-cli workers <deploy_hook_uuid> — 使用部署钩子触发构建。

zones — 管理区域

  • cloudflare-pp-cli zones 0-delete — 删除现有区域。
  • cloudflare-pp-cli zones 0-get — 区域详情
  • cloudflare-pp-cli zones 0-patch — 编辑区域。每次只能更改一个区域属性。
  • cloudflare-pp-cli zones get — 列出、搜索、排序和筛选你的区域。目前不允许列出超过 500 个账户中的区域。
  • cloudflare-pp-cli zones post — 创建区域
查找合适的命令

当你知道想做什么,却不知道哪个命令能完成时,可以直接询问 CLI:

cloudflare-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询,从此 CLI 精选的功能索引中匹配最佳命令。退出代码 0 表示至少有一个匹配项;退出代码 2 表示没有可信匹配项——请改用 --help,或使用范围更窄的查询。

身份验证设置

运行 cloudflare-pp-cli auth setup 获取令牌的 URL 和步骤(添加 --launch 可打开 URL)。然后保存令牌:

cloudflare-pp-cli auth set-token YOUR_TOKEN_HERE

或者将 CLOUDFLARE_API_TOKEN 设置为环境变量。

运行 cloudflare-pp-cli doctor 验证设置。

Agent 模式

为任意命令添加 --agent。它会展开为:--json --compact --no-input --no-color --yes。

  • 可通过管道传递 — JSON 输出到 stdout,错误输出到 stderr

  • 可筛选 — --select 保留部分字段。点分路径可深入嵌套结构;数组则逐元素遍历。对于输出冗长的 API,此功能对控制上下文大小至关重要:

    cloudflare-pp-cli accounts list --agent --select id,name,status
    
  • 可预览 — --dry-run 显示请求,但不会发送

  • 适合离线使用 — 在本地 SQLite 存储可用时,同步/搜索命令可以使用它

  • 非交互式 — 不会提示输入;所有输入都通过标志提供

  • 明确重试行为 — 仅当已存在的创建操作应视为成功时才使用 --idempotent;仅当缺失的删除目标应视为成功时才使用 --ignore-missing

响应封装

从本地存储或 API 读取的命令,会将输出封装在一个带有来源信息的信封中:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析 .results 获取数据,并查看 .meta.source 以确认数据来自实时 API 还是本地存储。仅当 stdout 是终端,且未设置机器格式标志(--json、--csv、--compact、--quiet、--plain、--select)时,才会将便于人阅读的 N results (live) 摘要打印到 stderr——管道/Agent 使用者和显式指定格式的运行会在 stdout 输出纯 JSON。

Agent 反馈

当你(或 Agent)发现此 CLI 有不妥之处时,请记录下来:

cloudflare-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
cloudflare-pp-cli feedback --stdin < notes.txt
cloudflare-pp-cli feedback list --json --limit 10

条目会保存到本地 ~/.local/share/cloudflare-pp-cli/feedback.jsonl。除非设置了 CLOUDFLARE_FEEDBACK_ENDPOINT,并且传入了 --send 或将 CLOUDFLARE_FEEDBACK_AUTO_SEND 设为 true,否则条目绝不会通过 POST 发送。默认行为仅保存在本地。

写下让你感到意外的地方,而不是提交错误报告。简短、具体、单行:这才是能够不断累积价值的内容。

输出传递

每个命令都接受 --deliver <sink>。除了输出到 stdout(或替代 stdout)之外,命令还会将输出发送到指定的目标,以便 Agent 路由命令结果,无需手动通过管道传递。支持以下三种目标:

目标效果
stdout默认值;仅输出到 stdout
file:<path>以原子方式将输出写入 <path>(临时文件 + 重命名)
webhook:<url>将输出正文 POST 到 URL(使用 --compact 时为 application/json 或 application/x-ndjson)

不支持的协议会被拒绝,并返回指出支持协议的结构化错误。Webhook 失败时会返回非零值,并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值,可在多次调用间重复使用。如果计划任务中的 Agent 每次运行都以相同配置调用同一命令,可以使用配置——这是 HeyGen 的“Beacon”模式。

cloudflare-pp-cli profile save briefing --json
cloudflare-pp-cli --profile briefing accounts list
cloudflare-pp-cli profile list --json
cloudflare-pp-cli profile show briefing
cloudflare-pp-cli profile delete briefing --yes

显式标志的优先级始终高于配置值;配置值的优先级高于默认值。agent-context 会在 available_profiles 下列出所有可用配置,以便进行自省的 Agent 在运行时发现它们。

退出代码

代码含义
0成功
2用法错误(参数错误)
3未找到资源
4需要身份验证
5API 错误(上游问题)
7请求频率受限(等待后重试)
10配置错误

参数解析

解析 $ARGUMENTS:

  1. 为空、help 或 --help → 显示 cloudflare-pp-cli --help 输出
  2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP;否则 → 请参阅上文的先决条件
  3. 其他任何内容 → 直接使用(作为 CLI 命令执行,并带上 --agent)

MCP 服务安装

  1. 安装 MCP 服务:
    go install github.com/mvanhorn/printing-press-library/library/cloud/cloudflare/cmd/cloudflare-pp-mcp@latest
    
  2. 在 Claude Code 中注册:
    claude mcp add cloudflare-pp-mcp -- cloudflare-pp-mcp
    
  3. 验证:claude mcp list

直接使用

  1. 检查是否已安装:which cloudflare-pp-cli 如果未找到,请提供安装选项(请参阅本技能开头的先决条件)。
  2. 根据用户查询,从上文的独特功能和命令参考中选择最合适的命令。
  3. 使用 --agent 标志执行:
    cloudflare-pp-cli <command> [subcommand] [args] --agent
    
  4. 如果存在歧义,请查看子命令帮助:cloudflare-pp-cli <command> --help。

评论

支持 Markdown