首页/云/云平台与虚拟化速查/云命令行工具:aliyun / tccli / KooCLI
云基础与账号46 条

云命令行工具:aliyun / tccli / KooCLI

三家厂商均提供命令行工具(阿里云 aliyun CLI、腾讯云 tccli、华为云 KooCLI),适合脚本化、批量化与自动化运维。

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

云 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 一起记录,提工单时能直接定位。

易错点

  • 脚本里依赖交互式配置:在无终端环境(流水线、定时任务)里会失败,应改用环境变量或角色凭证
  • 地域参数写法混用:把 --RegionId 用到腾讯云命令上,或漏掉华为云的 cli-region,导致报错却看不出原因
  • 用主账号密钥做日常脚本调用:权限过大且难以轮转,应改用专用子账号或角色
  • 不做分页只取第一页:资源超过一页时清单不完整,巡检结论出现漏项
  • 在生产账号直接跑未经确认的批量脚本:一条命令就能批量停止或删除资源,务必先在测试账号验证

数据来源与参考

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