天翼云 CLI 工具 🚀
天翼云CLI工具 是功能强大的企业级命令行工具，帮助您轻松管理天翼云资源。支持云服务器(ECS)、监控告警、安全防护、Redis分布式缓存、弹性负载均衡(ELB)、容器引擎(CCE)、VPC网络、费用查询等核心功能。
English | 简体中文
🎉 庆祝天翼云官方 CLI 正式上线！
热烈祝贺天翼云官方命令行工具正式发布！官方 CLI 的推出标志着天翼云开发者生态的进一步完善。作为社区开源项目，ctyun-cli 与官方 CLI 互补共存，共同为开发者提供高效的云端操作体验。
📋 命令与能力对比报告：官方CLI vs ctyun-cli
命令风格
| 维度 | 官方CLI (Go) | ctyun-cli (Python) |
|---|---|---|
| 命名 | API 动作名原样 ListEbmInstance（PascalCase） |
动词式 list/detail（kebab-case） |
| 结构 | 扁平，一模块一长串 | 嵌套子命令组 vpc eip list |
| 来源 | 照 OpenAPI 自动生成 | 手工精编封装 |
能力覆盖
| 域 | 官方CLI | ctyun-cli |
|---|---|---|
| VPC/网络查询（EIP/NAT/安全组/路由/子网/终端节点） | ~71 | ~73 |
| ECS/ELB/EVS/DPS/IMS | ✓（更全） | ✓ |
| 弹性伸缩/SD-WAN/资源编排/云间高速/备份/VPN/并行文件/专属云 | ✓ 独占 | ✗ |
| Redis/CCE（容器60+）/Kafka/CSS/EMR | ✗ | ✓ 独占 |
| IAM/账务/CDN(WAF)/云电脑/监控 | ✗ | ✓ 独占 |
结论
- 网络核心查询两者对等（各约 70 条）
- 官方CLI 强于边缘 IaaS（伸缩/编排/备份/SD-WAN）；ctyun-cli 强于 PaaS/账务/容器（Redis/CCE/Kafka/IAM）
- 二者互补而非包含。选型建议：IaaS 网络明细 → 官方CLI；容器/中间件/账务 → ctyun-cli
✨ 为什么选择天翼云 CLI？
- 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
- 🔐 安全可靠 - 企业级EOP签名认证，支持环境变量配置保护密钥安全
- 📊 功能全面 - 覆盖943+个API，支持28大服务模块
- 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，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 (云服务器) | 71 | 74 | 实例管理、快照备份、密钥对、订单查询、资源池查询、云助手、宿主机、网卡、安全组 | 详细文档 |
| Monitor (监控服务) | 82 | 74 | 监控数据、告警管理、Top-N统计、事件管理 | 详细文档 |
| LTS (云日志服务) | 168 | 169 | 日志项目/单元、主机组、采集配置、检索、转储、加工、告警、仪表盘、快速查询 | - |
| CCE (容器引擎) | 92 | 93 | Kubernetes集群、节点池、工作负载、配置管理、任务管理、命名空间 | 详细文档 |
| CFW (云防火墙) | 66 | 66 | 防火墙管理、概览、资产、防护规则、黑白名单、地址簿、IPS、应用、告警、日志、报表、询价 | - |
| Aone (边缘安全加速平台) | 45 | 46 | 域名管理、证书管理、缓存刷新/预取、数据统计、安全防护（CC/WAF/DDoS） | - |
| APM (应用性能监控) | 44 | 47 | 元数据、应用管理、链路追踪、性能分析、用量统计、告警、通知、Webhook | - |
| ZOS (对象存储) | 39 | 40 | 桶管理、对象管理、IAM、标签操作 | - |
| ELB (弹性负载均衡) | 34 | 33 | 负载均衡器、目标组、后端主机、访问控制、证书、网关负载均衡 | 详细文档 |
| IAM (身份访问管理) | 34 | 34 | 用户/用户组/权限/策略/委托/AK-SK/MFA/企业项目/身份供应商/敏感操作 | 详细文档 |
| RDS (云数据库Redis) | 33 | 36 | 实例管理、性能监控、网络配置、费用查询、运维管理 | 详细文档 |
| VPC (私有网络) | 23 | 26 | VPC网络、子网、路由表、安全组、弹性IP、标签管理 | 详细文档 |
| CDA (云专线) | 20 | 6 | 专线网关、物理专线、VPC管理、健康检查、链路探测 | 详细文档 |
| AIServer (AI服务器) | 19 | 24 | AI服务器实例管理 | - |
| Billing (计费查询) | 12 | 12 | 账单查询、费用分析、消费统计 | 详细文档 |
| CSSCN (云安全中心) | 10 | 13 | 资产查询、风险统计、漏洞、告警、病毒检测、配额 | - |
| CTMySQL (云数据库MySQL) | 9 | 11 | 实例查询、标签管理、监控、询价 | - |
| CloudPC (云桌面) | 9 | 16 | 云桌面实例管理 | - |
| Audit (云审计) | 8 | 13 | 事件查询、资源池管理、跟踪任务管理 | 详细文档 |
| DPS (数据迁移服务) | 8 | 9 | 数据迁移任务管理 | - |
| Security (安全卫士) | 6 | 22 | 安全扫描、漏洞管理、风险评估 | 详细文档 |
| EMR (翼MapReduce) | 6 | 10 | 集群、节点组、Hive元数据管理 | 详细文档 |
| Kafka (分布式消息服务) | 5 | 7 | 实例列表、节点状态、弹性IP、配置查询、标签 | 详细文档 |
| CSS (云搜索服务) | 3 | 5 | OpenSearch/Elasticsearch/Logstash 实例管理 | 详细文档 |
| IMS (镜像服务) | 2 | 7 | 镜像查询、镜像详细信息 | 详细文档 |
| OceanFS (海量文件服务) | 2 | 2 | 海量文件存储管理 | - |
| EBS (弹性块存储) | 1 | 1 | 块存储管理 | 详细文档 |
| SFS (弹性文件服务) | - | - | 弹性文件存储管理（实现中） | - |
| 总计 | 898 | 943 | 覆盖天翼云核心服务 | 所有模块 |
📊 规模统计：61,000+行代码，943+个API，898+个命令，28大服务模块
📚 完整文档
🚀 快速开始
📖 功能文档
🔧 高级功能
❓ 帮助支持
🤝 技术支持
如果您在使用过程中遇到问题或有任何建议，欢迎：
- 📧 邮箱: popfrog@gmail.com
- 💬 Issues: 提交问题反馈
- 📖 文档: 查看完整文档获取帮助
📝 更新日志
最新版本: v1.31.1 (2026-08-21)
- 🔧 Redis 模块监控 API 修复：修复 4 个监控类 API 路径错误（404），并修正参数名、时间格式与签名编码，
monitor-items/monitor-history/clients恢复正常
v1.31.0 (2026-08-07)
- 🚀 CCE 模块新增 V2 查询 API：新增 10 个 V2 版本查询命令（升级类 6 个 + 全新类 4 个），与现有 V1.1 接口并存
v1.30.0 (2026-07-27)
- 🆕 新增 CFW（云防火墙）模块：涵盖防火墙管理、概览、资产、防护规则、黑白名单、地址簿、IPS、应用、告警、日志、报表、询价，共 66 个命令
v1.29.2 (2026-07-27)
- 🚀 MSE 模块新增云原生 API 网关管理：涵盖网关实例/路由/服务/域名/ELB 管理，共 18 个新命令
v1.29.1 (2026-07-27)
- 🚀 MSE 模块补充：新增 Nacos 命名空间/黑白名单/用户与角色/AKSK 认证管理，共 8 个新命令
v1.29.0 (2026-07-27)
- 🚀 MSE 模块大幅扩展：新增 Nacos 注册配置中心管理，涵盖实例管理（4个）、Nacos 服务管理（9个）、Nacos 配置管理（8个），共 21 个新命令
v1.28.1 (2026-07-24)
- 🔧 VPC 模块优化：
describe-eips命令新增--page/--page-size分页参数
v1.28.0 (2026-07-24)
- 🆕 新增 EC（云间高速）/ MSE（微服务引擎）模块 + 多模块询价 API 大幅扩展：VPC/CloudPC/Kafka/ECS/SFS/OceanFS 共新增 37 个询价命令
查看完整历史请参阅 CHANGELOG.md
📜 开源协议
本项目采用 MIT 协议 开源，欢迎使用和贡献。
作者：Y.FENG | 邮箱：popfrog@gmail.com
🚀 让天翼云资源管理更简单！立即安装体验！
安装命令: pip install ctyun-cli
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
ctyun_cli-1.31.1-py3-none-any.whl
(419.9 kB
view details)
File details
Details for the file ctyun_cli-1.31.1-py3-none-any.whl.
File metadata
- Download URL: ctyun_cli-1.31.1-py3-none-any.whl
- Upload date:
- Size: 419.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
51c6795050dc6bc7f3a89af09930ac9eb985f788822354289c810d950fab5cd4
|
|
| MD5 |
7ad813c53ed0d77826ff74c244f3681b
|
|
| BLAKE2b-256 |
f0df6e943154b0ea96c84c017d35ca252f75553c3afbeac119f3fc4810178f32
|
