用 KooCLI 管理华为云资源：三个高频场景的终端实践

为什么要在终端里管云资源

控制台适合第一次配置，但不适合重复劳动。批量查实例、导出配置、在 CI 里创建一个临时环境，这些场景在浏览器里点半小时，在终端里就是一行命令。

KooCLI 是华为云的命令行工具，安装后可以直接用 hcloud 调用已开放的 API。

安装与初始化

# 首次运行会要求同意隐私协议，之后静默
hcloud --version

配置密钥有两种方式：交互式 hcloud configure init，或者直接写配置：

hcloud configure set --cli-access-key=AK --cli-secret-key=SK --cli-region=cn-north-4

密钥在本地加密存储，不需要每次传参。

场景一：批量查询 ECS 实例

hcloud ECS ListServersDetails --cli-region=cn-north-4 \
  --cli-output=json | jq -r '.servers[] | "\(.name)\t\(.flavor.id)\t\(.status)"'

配合 jq 可以快速做资产盘点。--cli-output 支持 json、table、tsv，做报表用 tsv 更省事。

场景二：给资源打统一标签

hcloud ECS BatchCreateServerTags \
  --project_id=xxx \
  --cli-jsonInput=tags.json

复杂参数用 --cli-jsonInput 从文件读，避免命令行转义地狱。这一步在 CI 里特别有用：环境创建完成后自动打上 env、owner、expire-at 标签，后续清理有据可依。

场景三：临时环境一键清理

hcloud ECS ListServersDetails --cli-jsonInput=list.json \
  | jq -r '.servers[].id' \
  | xargs -I{} hcloud ECS DeleteServers --server_ids.1={} --delete_publicip=true

临时环境最容易忘的就是清理。把上面的逻辑包成脚本，在流水线最后一步跑，能省掉不少账单惊喜。

几个实践建议

1. 别在生产环境直接跑删除类命令，先 List 确认目标再动手。
2. 区域参数显式传，不要依赖默认 region，多区域项目容易串。
3. 把常用命令写成 alias 或 Makefile，比记语法可靠。
4. 密钥不要进代码库，用环境变量或配置文件注入。

小结

KooCLI 的价值不在于"能调 API"，而在于让云资源的生命周期管理变得可脚本化、可版本化、可审计。