天翼云CLI工具 是功能强大的企业级命令行工具，帮助您轻松管理天翼云资源。支持云服务器(ECS)、监控告警、安全防护、Redis分布式缓存、弹性负载均衡(ELB)、容器引擎(CCE)、VPC网络、费用查询等核心功能。
English | 简体中文
- 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
- 🔐 安全可靠 - 企业级EOP签名认证，支持环境变量配置保护密钥安全
- 📊 功能全面 - 覆盖407+个API，支持19大服务模块
- 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，5分钟快速上手
- 🔧 灵活配置 - 支持配置文件、环境变量等多种配置方式
- 📈 实时监控 - 完整的监控服务支持，包括指标查询、告警管理、Top-N统计
只需一条命令即可安装：
pip install ctyun-cli验证安装成功：
ctyun-cli --help详细步骤请参考：5分钟快速上手指南
推荐使用环境变量方式（更安全）：
export CTYUN_ACCESS_KEY=your_access_key
export CTYUN_SECRET_KEY=your_secret_key或使用命令行配置：
ctyun-cli configure \
--access-key your_access_key \
--secret-key your_secret_key \
--region cn-north-1# 查看所有可用命令
ctyun-cli --help
# 查看云服务器列表
ctyun-cli ecs list
# 查询账户余额
ctyun-cli billing balance
# 查看负载均衡器
ctyun-cli elb loadbalancer list
# 查看容器集群
ctyun-cli cce list-clusters| 服务模块 | 命令数 | API数 | 核心功能 | 文档 |
|---|---|---|---|---|
| ECS (云服务器) | 64 | 53 | 实例管理、快照备份、密钥对、订单查询、资源池查询、云助手、宿主机、网卡 | 详细文档 |
| Monitor (监控服务) | 52 | 54 | 监控数据、告警管理、Top-N统计、事件管理 | 详细文档 |
| Redis (分布式缓存) | 18 | 22 | 实例管理、性能监控、网络配置、完整创建功能 | 详细文档 |
| Audit (云审计) | 8 | 8 | 事件查询、资源池管理、跟踪任务管理 | 详细文档 |
| IMS (镜像服务) | 2 | 2 | 镜像查询、镜像详细信息 | 详细文档 |
| Billing (计费查询) | 15 | 14 | 账单查询、费用分析、消费统计 | 详细文档 |
| Security (安全卫士) | 6 | 13 | 安全扫描、漏洞管理、风险评估 | 详细文档 |
| IAM (身份访问管理) | 34 | 34 | 用户/用户组/权限/策略/委托/AK-SK/MFA/企业项目/身份供应商/敏感操作 | 详细文档 |
| EBS (弹性块存储) | 1 | 1 | 块存储管理 | 详细文档 |
| CDA (云专线) | 20 | 21 | 专线网关、物理专线、VPC管理、健康检查、链路探测 | 详细文档 |
| VPC (私有网络) | 15 | 15 | VPC网络、子网、路由表、安全组、弹性IP | 详细文档 |
| CCE (容器引擎) | 79 | 92 | Kubernetes集群、节点池、工作负载、配置管理、任务管理、命名空间 | 详细文档 |
| ELB (弹性负载均衡) | 11 | 11 | 负载均衡器、目标组、后端主机管理 | 详细文档 |
| Kafka (分布式消息服务) | 4 | 5 | 实例列表、节点状态、弹性IP、配置查询 | 详细文档 |
| CSS (云搜索服务) | 3 | 4 | OpenSearch/Elasticsearch/Logstash 实例管理 | 详细文档 |
| EMR (翼MapReduce) | 6 | 9 | 集群、节点组、Hive元数据管理 | 详细文档 |
| SFS (弹性文件服务) | - | - | 弹性文件存储管理（实现中） | - |
| OceanFS (海量文件服务) | - | - | 海量文件存储管理（实现中） | - |
| Aone (边缘安全加速平台) | 45 | 45 | 域名管理、证书管理、缓存刷新/预取、数据统计、安全防护（CC/WAF/DDoS） | - |
| LTS (云日志服务) | - | - | 日志采集、检索、投递、告警管理（实现中） | - |
| 总计 | 393 | 407 | 覆盖天翼云核心服务 | 所有模块 |
📊 规模统计：43,000+行代码，407+个API，393+个命令，19大服务模块
- PyPI包: https://pypi.org/project/ctyun-cli/
- GitHub仓库: https://github.com/fengyucn/ctyun-cli
- 问题反馈: https://github.com/fengyucn/ctyun-cli/issues
如果您在使用过程中遇到问题或有任何建议，欢迎：
- 📧 邮箱: popfrog@gmail.com
- 💬 Issues: 提交问题反馈
- 📖 文档: 查看完整文档获取帮助
最新版本: v1.20.2 (2026-05-21)
- 🔧 CLI 框架修复：修复
handle_error装饰器丢失函数元信息（7 个模块），删除无效的billing consumption命令，monitor query-alert-history添加局部--output选项
v1.20.1 (2026-05-19)
- 🚀 Monitor 模块新增数据导出任务：
data-export-tasks/create-data-export-task/delete-data-export-task/download-data-export-task
v1.20.0 (2026-05-18)
- 🆕 新增 IMS（镜像服务）模块：
ims list-available/describe，终端节点ctimage-global.ctapi.ctyun.cn
v1.19.0 (2026-05-18)
- 🆕 新增 Audit（云审计）模块：8 个查询 API，涵盖事件查询、资源池管理、跟踪任务管理
v1.18.5 (2026-05-14)
- 🚀 Monitor 模块扩展：新增 21 个查询 API，涵盖数据订阅、套餐管理、监控看板、资源列表
v1.18.4 (2026-05-14)
- 🚀 ECS 查询扩展：新增 12 个 API，涵盖资源池、云助手、宿主机、网卡
v1.18.1 (2026-03-01)
- 🔧 CLI 初始化优化: 基础命令无需预先配置认证
v1.18.0 (2026-05-12)
- 🆕 IAM 全面扩展：34 个 API，12 大功能分类
- 🚀 CCE 持续增强：79 个命令，新增命名空间/任务/标签管理
查看完整历史请参阅 CHANGELOG.md
本项目采用 MIT 协议 开源，欢迎使用和贡献。
作者：Y.FENG | 邮箱：popfrog@gmail.com
🚀 让天翼云资源管理更简单！立即安装体验！
安装命令: pip install ctyun-cli