Bk CLI Gse

当需要通过 `bk-cli gse` 查询 GSE Agent 状态或详情时使用。适合批量查询 Agent 运行状态的场景。

tencentblueking 4e03c7d 1.4 KB Updated

File contents

bk-cli gse — GSE 管控平台能力使用说明

用于通过 bk-cli gse 调用蓝鲸 GSE 管控平台 API 的系统子命令。

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../bk-cli-shared/SKILL.md。共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 和通用请求规则;本 skill 只补充 gse 命令自己的语义与输入约定。

当前覆盖范围

当前 skill 覆盖两个高频命令:

  • list_agent_state
  • list_agent_info

输入约定

  • --agent_id_list 使用逗号分隔的 CMDB bk_agent_id 列表,最多支持 1000 个
  • 这里的 Agent ID 需要使用 CMDB 中的 bk_agent_id 字段格式,例如 02000000000000000000000000000001,不是 cloud_id:ip0:IP 格式

Commands

list_agent_state
bk-cli gse list_agent_state --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002
  • 批量查询 Agent 运行状态
  • 调用路径:POST /api/v2/cluster/list_agent_state
list_agent_info
bk-cli gse list_agent_info --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002
  • 批量查询 Agent 详细信息
  • 调用路径:POST /api/v2/cluster/list_agent_info

tencentblueking/bk-cli/tree/main/skills/bk-cli-gse commit 4e03c7d28a

Frequently asked questions

npx skillmds@latest add tencentblueking/bk-cli-gse