SuperAPI AI 工具集

bk-cli-cmdb

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:通过 bk-cli cmdb 调用 CMDB open API 的高频系统子命令,覆盖业务查询、拓扑、集群模块、主机关系、主机转移与删除等场景。使用前须先用 Read 工具读取 ../bk-cli-shared/SKILL.md,共享 skill 负责认证、context、tenant、stage、dry-run、verbose、header/body 及通用请求规则,本 skill 只补充 cmdb 命令自身语义。

主要能力:业务与拓扑方面有 search_business、get_biz_internal_module、search_set、create_set、search_module、create_module;主机查询有 list_biz_hosts_all(自动循环聚合分页且不暴露 --body)、list_biz_hosts、list_hosts_without_biz、find_host_biz_relations、list_biz_hosts_topo、list_resource_pool_hosts;主机转移与删除有 transfer_host_module、transfer_host_across_biz、transfer_host_to_idle_module、transfer_host_to_fault_module、transfer_host_to_recycle_module、transfer_host_to_resource_pool、delete_host。

使用方式:优先使用现成 cmdb 子命令;首次调用或排障时先加 --dry-run 查看最终 URL、headers 和 body;现成子命令无法覆盖目标接口时,再退回 bk-cli api bk-cmdb ...。列表型输入统一用 CSV 风格 flags,如 --bk_biz_ids 1,2,3、--bk_host_ids 100,200、--fields bk_host_id,bk_host_innerip;--host_ips 支持 10.0.0.1 或 cloud_id:ip(如 27:10.0.0.2),未写前缀默认 cloud_id=0,出现非法项直接报错。多数命令支持 --stage、--header、--body;显式传入 --body 时以该 JSON 为准,不再使用默认请求内容。

限制:调用通常要求可满足 app+user 的凭据,或当前 context 使用 access_token;若目标接口无对应子命令或需完全自定义 query/body,应改用 bk-cli api bk-cmdb。常见错误包括缺少业务过滤条件、host_ips 非法、bk_host_ids 非法、supplier_account 为空及鉴权失败。收费、价格等信息暂未提供。