关于 pp-cloudflare
pp-cloudflare 是通过 `cloudflare-pp-cli` 在终端操作 Cloudflare 的 skill,适用于处理账户、域名、基础设施和部署任务的 Agent,也可检查令牌权限与配置状态。
主要功能
- 01管理账户和区域
- 02操作 DNS、Workers、Pages 与 R2
- 03检查令牌权限和配置
- 04诊断 DNS、SSL 与 Email Routing 状态
- 05以隐藏输出方式管理 Worker 密钥
- 06查询 Cloudflare Radar 数据
适用场景
- 01将域名连接到 Pages 或 Workers
- 02变更前检查令牌访问权限
- 03诊断域名和邮件配置
- 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 已安装。**如果尚未安装,请先安装:
- 使用 Printing Press 安装程序安装。macOS/Linux 上默认将二进制文件安装到
$HOME/.local/bin,Windows 上则安装到%LOCALAPPDATA%\Programs\PrintingPress\bin:npx -y @mvanhorn/printing-press-library install cloudflare --cli-only - 验证:
cloudflare-pp-cli --version - 确保所报告的安装目录位于将调用此技能的 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
cloudflare-pp-cli ips— 获取 Cloudflare/JD Cloud 网络使用的 IP,参见 https://www.cloudflare。
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 — 管理组织
cloudflare-pp-cli organizations create-user— 为用户创建一个新组织。(目前处于 Public Beta 阶段,参见 https://developers.cloudflare。cloudflare-pp-cli organizations delete— 删除组织。删除前,组织必须为空。cloudflare-pp-cli organizations list— 获取特定用户有权访问的组织列表。(目前处于 Public Beta 阶段,参见 https://developers。cloudflare-pp-cli organizations modify— 修改组织。(目前处于 Public Beta 阶段,参见 https://developers.cloudflare.com/fundamentals/organizations/)cloudflare-pp-cli organizations retrieve— 获取特定组织的详细信息。(目前处于 Public Beta 阶段,参见 https://developers.cloudflare。
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 | 需要身份验证 |
| 5 | API 错误(上游问题) |
| 7 | 请求频率受限(等待后重试) |
| 10 | 配置错误 |
参数解析
解析 $ARGUMENTS:
- 为空、
help或--help→ 显示cloudflare-pp-cli --help输出 - 以
install开头 → 以mcp结尾 → 安装 MCP;否则 → 请参阅上文的先决条件 - 其他任何内容 → 直接使用(作为 CLI 命令执行,并带上
--agent)
MCP 服务安装
- 安装 MCP 服务:
go install github.com/mvanhorn/printing-press-library/library/cloud/cloudflare/cmd/cloudflare-pp-mcp@latest - 在 Claude Code 中注册:
claude mcp add cloudflare-pp-mcp -- cloudflare-pp-mcp - 验证:
claude mcp list
直接使用
- 检查是否已安装:
which cloudflare-pp-cli如果未找到,请提供安装选项(请参阅本技能开头的先决条件)。 - 根据用户查询,从上文的独特功能和命令参考中选择最合适的命令。
- 使用
--agent标志执行:cloudflare-pp-cli <command> [subcommand] [args] --agent - 如果存在歧义,请查看子命令帮助:
cloudflare-pp-cli <command> --help。