ctyun-cli 1.12.0

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

天翼云 CLI 工具 🚀

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

English | 简体中文

✨ 为什么选择天翼云 CLI？

• 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
• 🔐 安全可靠 - 企业级EOP签名认证，支持环境变量配置保护密钥安全
• 📊 功能全面 - 覆盖200+个API，支持15大服务模块
• 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，5分钟快速上手
• 🔧 灵活配置 - 支持配置文件、环境变量等多种配置方式
• 📈 实时监控 - 完整的监控服务支持，包括指标查询、告警管理、Top-N统计

📦 安装

只需一条命令即可安装：

pip install ctyun-cli

验证安装成功：

ctyun-cli --version

⚡ 快速开始

详细步骤请参考：5分钟快速上手指南

第一步：配置认证信息

推荐使用环境变量方式（更安全）：

export CTYUN_ACCESS_KEY=your_access_key
export CTYUN_SECRET_KEY=your_secret_key

或使用交互式配置：

ctyun-cli configure

第二步：开始使用

# 查看所有可用命令
ctyun-cli --help

# 查看云服务器列表
ctyun-cli ecs list

# 查询账户余额
ctyun-cli billing balance

# 查看负载均衡器
ctyun-cli elb loadbalancer list

# 查看容器集群
ctyun-cli cce list-clusters

📊 功能概览

服务模块	命令数	API数	核心功能	文档
ECS (云服务器)	41	38	实例管理、快照备份、密钥对、订单查询	详细文档
Monitor (监控服务)	53	54	监控数据、告警管理、Top-N统计、事件管理	详细文档
Redis (分布式缓存)	14	19	实例管理、性能监控、网络配置、完整创建功能	详细文档
Billing (计费查询)	15	14	账单查询、费用分析、消费统计	详细文档
Security (安全卫士)	5	11	安全扫描、漏洞管理、风险评估	详细文档
IAM (身份访问管理)	3	3	项目管理、权限控制	详细文档
EBS (弹性块存储)	1	1	块存储管理	详细文档
CDA (云专线)	19	19	专线网关、物理专线、VPC管理、健康检查、链路探测	详细文档
VPC (私有网络)	15	15	VPC网络、子网、路由表、安全组、弹性IP	详细文档
CCE (容器引擎)	36	37	Kubernetes集群、节点池、工作负载、配置管理	详细文档
ELB (弹性负载均衡)	7	5	负载均衡器、目标组、后端主机管理	详细文档
SFS (弹性文件服务)	-	-	弹性文件存储管理（实现中）	-
OceanFS (海量文件服务)	-	-	海量文件存储管理（实现中）	-
Aone (边缘安全加速平台)	-	-	边缘安全与加速管理（实现中）	-
LTS (云日志服务)	-	-	日志采集、检索、投递、告警管理（实现中）	-
总计	210	217	覆盖天翼云核心服务	所有模块

📊 规模统计：35,000+行代码，217+个API，210+个命令，15大服务模块

📚 完整文档

🚀 快速开始

• 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.12.0 (2026-04-30)

• 🆕 新增 EMR（翼MapReduce）模块：终端节点 emr-global.ctapi.ctyun.cn，实现 8 个 API
  • emr list：查询集群列表（支持V1/V2），支持名称/状态/类型过滤
  • emr describe：查询集群详情（支持V1/V2），展示类型/版本/VPC/组件
  • emr node-groups：查询节点组信息，展示类型/主机数/CPU/内存/规格
  • emr node-detail：查询节点详情（V2），展示主机IP/状态/部署角色
  • emr meta-overview：查询Hive元数据概览，展示库/表/存储/文件数
  • emr meta-table：查询指定Hive表元数据，展示分区/冷热分区/小文件统计

v1.11.0 (2026-04-30)

• 🆕 新增 CSS（云搜索服务）模块：终端节点 ctcsx-global.ctapi.ctyun.cn，实现 3 个 API
  • css list：查询 OpenSearch/Elasticsearch 实例列表，支持类型/名称/状态过滤
  • css describe：查询实例详情，展示健康状态/规格/节点信息
  • css logstash-list：查询 Logstash 实例列表，展示管道/节点/关联实例

v1.10.0 (2026-04-30)

• 🆕 新增 Kafka（分布式消息服务）模块：终端节点 ctgkafka-global.ctapi.ctyun.cn，实现 4 个 API
  • kafka list：查询实例列表，支持名称过滤（精确/模糊）、状态筛选、分页
  • kafka node-status：查看实例节点健康状态
  • kafka floating-ips：查询可绑定的弹性IP列表
  • kafka config：获取实例配置参数（含静态/动态配置分类）

v1.9.0 (2026-04-29)

• 🆕 新增服务模块脚手架：LTS（云日志服务）、SFS（弹性文件服务）、OceanFS（海量文件服务）、Aone（边缘安全加速平台），注册为独立 CLI 命令组，为后续 API 实现做好准备
• 🎯 Redis 模块完善：新增 topology（实例逻辑拓扑）、cluster-nodes（批量查询集群节点）命令；修复 network 和 describe 命令的 API 路径、参数及显示字段，支持 --region-id 参数

v1.8.4 (2026-04-22)

• 🔍 ELB 后端主机详情查询：新增 elb targetgroup targets show 命令，查看后端主机IP、端口、权重、健康状态等详细信息

v1.8.3 (2026-04-22)

• 🏷️ CCE 任务管理：新增 5 个任务管理 API（查询/恢复/取消/暂停），以及集群事件列表查询
• 🔧 CCE 标签管理：修复 cce tag bind API 路径和请求体格式

v1.8.2 (2026-04-15)

• 🏷️ ECS 云主机标签管理：新增 ecs update-label 命令，支持增加/修改/删除标签（ADD/UPDATE/DELETE）

v1.8.1 (2026-03-30)

• 🚀 CCE Namespace 命名空间管理：新增 5 个 Namespace API，支持完整的 Kubernetes 命名空间生命周期管理
  • 新增 cce namespace 命令组（create/delete/update/show/list）

v1.8.0 (2026-03-28)

• 🔧 彻底解决模块命名冲突：将 redis 模块重命名为 rdscmd，从根源解决与 redis-py 库的命名冲突问题
• ✅ 零兼容性影响：用户命令 ctyun redis xxx 保持不变

查看完整的更新历史请参阅 CHANGELOG.md

📜 开源协议

本项目采用 MIT 协议 开源，欢迎使用和贡献。

作者：Y.FENG | 邮箱：[e-mail]

---

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

安装命令: pip install ctyun-cli