bk-cli-gse

bk-cli gse — Instructions for using GSE control platform capabilities

Used to call the BlueKing GSE control platform API through bk-cli gse system subcommands.

CRITICAL — Before starting, you MUST first use the Read tool to read ../bk-cli-shared/SKILL.md. The shared skill handles authentication, context, tenant, stage, dry-run, verbose, header/body, and general request rules; this skill only supplements gse command-specific semantics and input conventions.

Current coverage

This skill currently covers two high-frequency commands:

• list_agent_state
• list_agent_info

Input conventions

• --agent_id_list uses a comma-separated CMDB bk_agent_id list, supporting up to 1000
• The Agent ID here needs to use the bk_agent_id field format in CMDB, for example 02000000000000000000000000000001, not cloud_id:ip or 0:IP format

Commands

list_agent_state

bk-cli gse list_agent_state --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002

• Batch query Agent running status
• Call path:POST /api/v2/cluster/list_agent_state

list_agent_info

bk-cli gse list_agent_info --agent_id_list 02000000000000000000000000000001,02000000000000000000000000000002

• Batch query Agent detailed information
• Call path:POST /api/v2/cluster/list_agent_info