SuperAPI AI 工具集

bk-cli-gse

部署与运维

查看项目

更新于 10-16 08:45

技能介绍

用途:通过 bk-cli gse 调用蓝鲸 GSE 管控平台 API,查询 Agent 状态与详情,适合批量查询 Agent 运行状态。

主要能力:当前覆盖两个高频命令。list_agent_state 批量查询 Agent 运行状态,调用路径 POST /api/v2/cluster/list_agent_state;list_agent_info 批量查询 Agent 详细信息,调用路径 POST /api/v2/cluster/list_agent_info。

使用方式:命令示例为 bk-cli gse list_agent_state --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002,以及 bk-cli gse list_agent_info --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002。开始前必须先用 Read 工具读取 ../bk-cli-shared/SKILL.md,该共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 及通用请求规则,本 skill 只补充 gse 命令的语义与输入约定。

输入约定:--agent_id_list 使用逗号分隔的 CMDB bk_agent_id 列表,最多支持 1000 个;Agent ID 需使用 CMDB 中的 bk_agent_id 字段格式,例如 02000000000000000000000000000001,不是 cloud_id:ip 或 0:IP 格式。

限制:资料未提供返回字段、错误处理、权限要求、计费与平台支持范围等信息,暂未提供。