产品定义
更新时间 2026-08-14 10:50:07
最近更新时间: 2026-08-14 10:50:07
本文为您介绍什么是CLI工具
天翼云CLI工具是一款运行在终端中的交互式 / 脚本化软件客户端。通过使用天翼云CLI工具，您可以在终端中轻松管理您的天翼云资源。此外，您还可将其作为 AI 智能体的调用工具入口，通过指令对接天翼云 API，轻松实现资源全生命周期管理、批量配置调整与自动化运维。
为什么使用CLI
日常管理云资源时，相较于网页控制台、SDK、原生 OpenAPI ，天翼云 CLI 能很好平衡易用性与扩展性，是更适配多场景的选择。
网页控制台在批量运维场景下操作繁琐、效率低下；SDK 需要搭建开发环境、调试与上手成本偏高；直接调用 OpenAPI 还需自行处理鉴权签名、请求封装、异常兼容等底层逻辑。
天翼云 CLI 原生运行于终端环境，交互式调试、批量脚本运维均可一键实现，无需复杂开发成本。同时它具备独特的 AI 集成能力，可作为标准化 Tools 对接 AI 智能体框架，大模型能直接下发命令调用天翼云 API，无需额外封装接口逻辑。
CLI支持多系统调用
各系统执行命令无明显差异。
CLI功能概览
基础命令
| 命令 | 说明 |
|---|---|
ctyun-cli configure | 交互式配置 |
ctyun-cli version | 查看版本信息 |
ctyun-cli completion | 生成 Shell 自动补全脚本 |
产品列表
| 标识 | 名称 |
|---|---|
acs | 应用云主机 |
as | 弹性伸缩服务 |
cda | 云专线 |
cm | 云监控服务 |
csbs | 云主机备份 |
dec | 专属云（计算独享型） |
dps | 物理机 |
ec | 云间高速（标准版） |
ecs | 弹性云主机 |
eip | 弹性IP |
elb | 弹性负载均衡 |
evs | 云硬盘 |
hpfs | 并行文件服务 |
ims | 镜像服务 |
nat | NAT网关 |
oceanfs | 海量文件服务 |
private-zone | 内网DNS |
ros | 资源编排 |
sbw | 共享带宽 |
sdwan | 天翼云SD-WAN |
sfs | 弹性文件服务 |
vbs | 云硬盘备份 |
vpc | 虚拟私有云 |
vpce | VPC终端节点 |
vpn | VPN连接 |
zos | 对象存储 |
common | 公共服务 |
全局参数
| 参数 | 说明 |
|---|---|
--access-key / -a | 天翼云 AccessKey（环境变量 CTYUN_AK） |
--secret-key / -s | 天翼云 SecretKey（环境变量 CTYUN_SK） |
--config / -c | 指定配置文件路径（默认 ~/.ctyun-cli.yaml） |
--body / -b | 请求体 JSON，手动覆盖，优先级最高 |
--cli-query | JMESPath 表达式，筛选 API 返回结果 |
--output / -o | 输出格式：json（默认）或 table |
--log | 开启日志（环境变量 CTYUN_LOG） |
--log-file | 日志文件路径，默认 stderr |
--log-format | 日志格式：text 或 json |
您可在安装CLI后，在命令行中通过以下指令，查询详细帮助信息：
ctyun-cli --help
