首页/云/云平台与虚拟化速查/命令行工具术语对照

命令行工具术语对照

命令行工具三家风格不同:aliyun CLI 与 tccli 均为交互式配置,华为云 KooCLI 的启动命令为 hcloud,地域参数写法也不同。

云平台与虚拟化速查云更新于 2026-10-13

术语对照是干什么的

各云厂商的命令行工具在概念上一致,但参数名与调用风格不同:有的按资源类型组织命令,有的统一用动作加参数的 RPC 形式。写跨云脚本时,最容易踩坑的是地域参数与输出格式——把一家的参数名搬到另一家会直接报未知参数,脚本还依赖凭证来源,CI 环境下没有交互式配置就会失败。

基本信息

工具名阿里云 CLI(aliyun)、腾讯云 CLI(tccli)、华为云 KooCLI(hcloud)
配置命令aliyun configure / tccli configure / hcloud configure
地域参数--RegionId / --region / --cli-region
输出格式均支持 JSON 输出,参数名各不相同
凭证来源配置文件、环境变量或实例角色,按工具文档配置

典型使用场景

  • 批量查询与导出资源清单,比控制台翻页更快
  • 把重复运维动作写成脚本,纳入定时任务
  • CI/CD 流水线中创建与更新资源
  • 跨云批量操作时统一脚本骨架,只替换工具与参数名
  • 故障时快速执行查询类操作,减少登录控制台的时间

调用示例

调用示例
aliyun ecs DescribeRegions                                  # 阿里云:RPC 风格,Action 加参数
tccli cvm DescribeRegions --region ap-guangzhou             # 腾讯云:参数用 --region
hcloud ECS ListServerAzInfo --cli-region=cn-north-4         # 华为云 KooCLI:--cli-region
# 统一输出格式便于脚本解析流程
aliyun ecs DescribeInstances --RegionId cn-hangzhou --output json | head

概念对照表

概念阿里云腾讯云华为云
工具名阿里云 CLI(aliyun)腾讯云 CLI(tccli)KooCLI(hcloud)
配置命令aliyun configuretccli configurehcloud configure
地域参数--RegionId--region--cli-region
调用风格RPC(Action+参数)RPC(Action+参数)命令+参数
分页参数--PageSize/--PageNumber 类参数--Limit/--Offset 类参数以各工具文档为准
自动化脚本要显式指定地域与输出格式(JSON),不要依赖交互式配置的默认值,否则在不同环境执行结果可能不一致。
凭证不要写进脚本:优先使用实例角色或运行环境提供的凭证注入方式;把密钥写进脚本或仓库会带来长期的安全隐患。

跨云脚本骨架要点

  • 把工具名、地域参数与输出参数抽成变量,切换云厂商时只改一处
  • 所有查询类命令统一输出 JSON 并用解析工具处理,不要用文本截取列
  • 分页参数名各家不同,批量导出要显式循环翻页
  • 错误处理要检查退出码与响应中的错误码字段,避免静默失败
  • 把调用日志与请求 ID 记录下来,便于向厂商提工单时定位

易错点

  • 把 --region 与 --cli-region 混写,工具直接报未知参数
  • 脚本依赖交互式配置的默认 profile,在 CI 上无凭证直接失败
  • 未显式指定地域,脚本在本地能跑、在流水线里操作了错误地域的资源
  • 把密钥硬编码进脚本与仓库,泄露后需要全量轮换

数据来源与参考

  • 阿里云 CLI 文档
  • 腾讯云 CLI 文档
  • 华为云 KooCLI 文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌