云 CLI 是什么
三家厂商都提供命令行工具:阿里云 aliyun CLI、腾讯云 tccli、华为云 KooCLI(命令名 hcloud)。它们把控制台操作翻译成可脚本化的 API 调用,用一条命令就能查询、创建或批量处理资源,是自动化运维与批量巡检的基础设施。
基本信息
| 阿里云 | aliyun,子命令按产品划分,如 aliyun ecs DescribeInstances |
|---|---|
| 腾讯云 | tccli,子命令按产品划分,如 tccli cvm DescribeInstances |
| 华为云 | hcloud(KooCLI),需显式指定 cli-region |
| 凭证配置 | 交互式 configure 生成本地配置文件,也可用环境变量或角色凭证 |
| 配置文件位置 | 阿里云与华为云存于用户目录下的配置文件,tccli 存于自身配置目录 |
| 输出格式 | 普遍支持 JSON 输出,便于配合命令行工具二次处理 |
三厂参数写法差异
| 项目 | 阿里云 | 腾讯云 / 华为云 |
|---|---|---|
| 地域参数 | --RegionId cn-hangzhou | 腾讯云 --region ap-guangzhou;华为云 --cli-region=cn-north-4 |
| 请求方式 | 默认 GET,部分接口需指定 POST | 由工具自行处理,一般无需关注 |
| 分页 | --PageSize 与 --PageNumber | 腾讯云用 --Limit 与 --Offset |
| 资源过滤 | 接口自带过滤参数,如 --InstanceName | 腾讯云用 --Filters 传 JSON 数组 |
| 输出裁剪 | --output cols=... 精简列 | 配合命令行 JSON 处理工具裁剪 |
典型使用场景
- 批量巡检:定期导出所有实例、云盘与快照清单,做容量与闲置分析
- 自动化发布:流水线中调用 API 创建镜像、更新伸缩组配置或刷新 CDN
- 批量运维:对一批实例统一挂载云盘、修改安全组或打标签
- 应急操作:控制台卡顿时用一条命令停止异常实例或解绑弹性 IP
- 成本核查:按账期拉取账单明细,落库后做分账与趋势分析
配置与调用示例
配置与调用示例
aliyun configure # 交互式写入 AK/SK 与默认地域
aliyun ecs DescribeInstances --RegionId cn-hangzhou --PageSize 50 # 列出实例
tccli configure # 腾讯云配置凭证
tccli cvm DescribeInstances --region ap-guangzhou # 查询实例列表
hcloud configure # 华为云 KooCLI 初始化
hcloud ECS ListServersDetails --cli-region=cn-north-4 # 按区域查询云服务器
# 脚本中建议改用环境变量或角色凭证,避免依赖交互式配置CLI 把密钥保存在本地配置文件里:运维机的文件权限要收紧,不要把整个用户目录同步到网盘或代码仓库。多人共用的跳板机建议按人配置独立的 profile,用完及时清理。
排查 CLI 报错时先区分三类原因:签名与权限错误(凭证或策略)、参数错误(地域参数写法或字段名)、资源错误(ID 不存在或状态不允许操作)。把返回的错误码与请求 ID 一起记录,提工单时能直接定位。