术语对照是干什么的
各云厂商的命令行工具在概念上一致,但参数名与调用风格不同:有的按资源类型组织命令,有的统一用动作加参数的 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 configure | tccli configure | hcloud configure |
| 地域参数 | --RegionId | --region | --cli-region |
| 调用风格 | RPC(Action+参数) | RPC(Action+参数) | 命令+参数 |
| 分页参数 | --PageSize/--PageNumber 类参数 | --Limit/--Offset 类参数 | 以各工具文档为准 |
自动化脚本要显式指定地域与输出格式(JSON),不要依赖交互式配置的默认值,否则在不同环境执行结果可能不一致。
凭证不要写进脚本:优先使用实例角色或运行环境提供的凭证注入方式;把密钥写进脚本或仓库会带来长期的安全隐患。
跨云脚本骨架要点
- 把工具名、地域参数与输出参数抽成变量,切换云厂商时只改一处
- 所有查询类命令统一输出 JSON 并用解析工具处理,不要用文本截取列
- 分页参数名各家不同,批量导出要显式循环翻页
- 错误处理要检查退出码与响应中的错误码字段,避免静默失败
- 把调用日志与请求 ID 记录下来,便于向厂商提工单时定位