用途:通过 API 管理 JFrog Mission Control,覆盖平台部署(JPD)查询、健康检查、许可证审计与代理列表等运维场景。
主要能力:
- 列出全部 JPD:GET $JFROG_URL/mc/api/v1/jpds,返回 id、name、url、status、location、licenses、services、tags 等字段。
- 按 ID 获取 JPD 详情:GET $JFROG_URL/mc/api/v1/jpds/${JPD_ID},包含状态、位置、许可证与服务健康信息。
- 为 JPD 附加许可证:POST $JFROG_URL/mc/api/v1/jpds/${JPD_ID}/attach_license,JSON 体为 {"license_key": "your-license-key-here"}。
- 列出代理:GET $JFROG_URL/mc/api/v1/proxies。
认证:所有请求需 Authorization: Bearer $JFROG_ACCESS_TOKEN。API 传输优先使用 jf api(JFrog CLI 2.100.0+),采用仅路径 URL 且认证来自 jf config;当 CLI 缺失或版本低于 2.100.0 时,回退为 curl 配合 $JFROG_URL 与 bearer 令牌。需要认证时,按登录流程解析当前 JFrog 环境:jf CLI 必需,缺失时自动安装;代理通过 jf config show 检查已保存凭据,若存在多个则询问使用哪个环境;若不存在,则驱动网页登录流程并通过 jf config add 保存凭据。
核心概念:JPD 指 JFrog Platform Deployment(Artifactory + Xray 及服务实例);License 是绑定到 JPD 的企业许可证,含类型与过期时间;Proxy 是配置用于出站连接的网络代理。
常见工作流:跨部署监控平台健康——列出所有 JPD,检查每个 JPD 的 status.code(HEALTHY、DEGRADED、UNHEALTHY),并查看各 JPD 服务健康详情;审计许可证——列出所有 JPD,查看每个 JPD 的 licenses 数组中的 valid_through 过期日期与过期状态,必要时附加新许可证。
限制:资料未提供官方文档中的更多 API、错误码、权限要求、速率限制及具体价格信息;示例中的变量(如 $JFROG_URL、$JFROG_ACCESS_TOKEN、$JPD_ID、your-license-key-here)需替换为实际值。