ctyun-cli 1.20.0

天翼云CLI工具 - 基于终端的云资源管理平台

天翼云 CLI 工具 🚀

天翼云CLI工具 是功能强大的企业级命令行工具，帮助您轻松管理天翼云资源。支持云服务器(ECS)、监控告警、安全防护、Redis分布式缓存、弹性负载均衡(ELB)、容器引擎(CCE)、VPC网络、费用查询等核心功能。

English | 简体中文

✨ 为什么选择天翼云 CLI？

• 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
• 🔐 安全可靠 - 企业级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大服务模块

📚 完整文档

🚀 快速开始

• 5分钟快速上手 - 从安装到第一个命令的完整指南
• 安装指南 - 详细的安装说明和故障排除
• 配置指南 - 认证配置和多环境设置

📖 功能文档

• 功能概览 - 完整功能介绍和特性说明
• 模块详细文档 - 各服务模块的详细使用说明
• 命令参考 - 所有命令的完整参数说明

🔧 高级功能

• 高级功能 - 管道操作、调试模式等高级特性
• 输出格式 - table/json/yaml格式使用说明
• 最佳实践 - 使用技巧和最佳实践

❓ 帮助支持

• 常见问题 - 常见问题解答和解决方案
• 故障排除 - 错误诊断和解决方法
• 版本历史 - 详细的版本更新记录

🔗 相关链接

外部资源

• PyPI包: https://pypi.org/project/ctyun-cli/
• GitHub仓库: https://github.com/fengyucn/ctyun-cli
• 问题反馈: https://github.com/fengyucn/ctyun-cli/issues

内部文档

• 使用指南
• API参考
• 配置说明

🤝 技术支持

如果您在使用过程中遇到问题或有任何建议，欢迎：

• 📧 邮箱: [e-mail]
• 💬 Issues: 提交问题反馈
• 📖 文档: 查看完整文档获取帮助

📝 更新日志

最新版本: 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 | 邮箱：[e-mail]

---

🚀 让天翼云资源管理更简单！立即安装体验！

安装命令: pip install ctyun-cli