天翼云 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签名认证，支持环境变量配置保护密钥安全
- 📊 功能全面 - 覆盖830+个API，支持27大服务模块
- 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，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集群、节点池、工作负载、配置管理、任务管理、命名空间 | 详细文档 |
| 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 (弹性文件服务) | - | - | 弹性文件存储管理（实现中） | - |
| 总计 | 785 | 830 | 覆盖天翼云核心服务 | 所有模块 |
📊 规模统计：61,000+行代码，830+个API，785+个命令，27大服务模块
📚 完整文档
🚀 快速开始
📖 功能文档
🔧 高级功能
❓ 帮助支持
🔗 相关链接
外部资源
- 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.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 个询价命令
v1.27.5 (2026-07-24)
- 🔧 ECS 模块清理与修复：移除 3 个旧版 mock 命令，修复
console对接真实 VNC API，启用可用区详情查询
v1.27.4 (2026-07-24)
- 🐛 Bug 修复：DPS / EMR / Kafka 模块输出不再截断实例 ID 与子网 ID
v1.27.3 (2026-07-24)
- 🐛 Bug 修复：
regions命令不再截断 regionID，输出完整 ID
v1.27.2 (2026-07-23)
- 🚀 VPC 模块新增 14 个命令：网络诊断、DHCP、私有DNS关联VPC、IPv6网关/带宽、IPv4网关
v1.27.1 (2026-07-23)
- 🚀 VPC 模块新增 14 个命令：网络ACL、前缀列表、流日志、网关负载均衡、二层网关、高可用VIP
v1.27.0 (2026-07-23)
- 🚀 VPC 模块新增 20 个命令：弹性公网IP监控/备案、带宽、流量包、终端节点/服务、私有DNS及记录管理
v1.26.2 (2026-07-21)
- 🚀 VPC 模块新增 13 个命令：NAT 网关、SNAT/DNAT、对等连接、路由表、安全组规则、端口管理
v1.26.1 (2026-07-21)
- 🚀 EBS 模块新增 6 个命令：云硬盘详情/按名称查询、快照列表/容量/策略
v1.26.0 (2026-07-20)
- 🚀 Redis 模块大幅扩展：新增 52 个命令，涵盖备份管理、安全配置、Key 分析、监控诊断、参数模板、迁移任务等
v1.25.0 (2026-07-17)
- 🆕 新增 APM（应用性能监控）模块：44 个命令，涵盖元数据、应用管理、链路追踪、性能分析、用量统计、告警、通知、Webhook
v1.24.6 (2026-07-17)
- 🚀 ELB 模块新增 19 个命令：访问控制、监控、SLA/证书、转发策略、健康检查、网关负载均衡、IP 监听
v1.24.5 (2026-07-17)
- 🚀 LTS 模块大幅扩展 + ZOS 模块新增命令：LTS 新增 168 个命令（项目/单元/主机组/采集/检索/转储/加工/告警/仪表盘等），ZOS 新增 39 个命令（桶/对象/IAM/标签管理）
v1.24.4 (2026-07-17)
- 🚀 CCE 模块新增命令：
query-cluster-id-by-order-id根据订单 ID 查询集群 ID
v1.24.3 (2026-07-17)
- 🚀 ECS 模块新增 6 个命令：安全组查询/详情、规格族实例、专属宿主机规格、元数据、命令执行结果
v1.24.2 (2026-07-01)
- 🚀 多模块新增 13 个标签管理 API：VPC（6个）/ CTMySQL（3个）/ ECS / ELB / Kafka / Redis 标签管理命令
v1.24.1 (2026-07-01)
- 🔧 Billing 模块对齐最新 API 文档：删除
balance/arrears无效命令，清理 11 个 mock 方法，保留 11 个有效命令全部对齐真实 API，完善模块帮助信息
v1.24.0 (2026-06-30)
- 🆕 新增 CSSCN（云安全中心）模块：10 个命令，涵盖资产查询、风险/服务器/Agent 统计、漏洞、告警、病毒检测、配额
v1.23.0 (2026-06-30)
- 🆕 新增 CTMySQL（云数据库 MySQL）模块：6 个命令，涵盖实例查询、标签管理、监控、询价（新购/升配/续订）
v1.22.0 (2026-06-29)
- 🆕 新增 DPS（数据迁移服务）模块：8 个命令，涵盖源端 OS/元数据/网卡/磁盘查询、迁移镜像、库存、任务列表与详情
v1.21.0 (2026-06-29)
- 🆕 新增 ZOS（对象存储）模块：
zos query-price存储套餐询价 - 🚀 多模块扩展 8 个 API：ECS 续订询价、ELB PGELB 询价（3个）、Monitor 拨测查询（2个）、OceanFS 续订/升配询价（2个）
v1.20.6 (2026-06-23)
- 🚀 Redis 模块新增 7 个监控与查询 API：
proxy-monitor-history/rw-sep/groups/cluster-member-info/node-memory/node-state/available-regions
v1.20.5 (2026-06-23)
- 🔧
redis price参数文档完善：为实例类型、主机类型、版本等参数补充枚举值说明和click.Choice约束
v1.20.4 (2026-06-23)
- 🚀 Redis 模块新增费用查询 API：
redis price，支持 9 种订单类型询价（订购/续费/升配/扩容/缩容/增减分片/增减副本）
v1.20.3 (2026-06-23)
- 🚀 Redis 模块新增 6 个运维 API：
node-list/log-download/replication-state/labels/running-logs/accounts
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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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
File details
Details for the file ctyun_cli-1.28.1.tar.gz.
File metadata
- Download URL: ctyun_cli-1.28.1.tar.gz
- Upload date:
- Size: 376.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
783e340e0592b43b80064f85c12588bbc73dd4f9150b08f459882f76cbe3f3d2
|
|
| MD5 |
ba5c33515a4f5f01de629cc3dd6be266
|
|
| BLAKE2b-256 |
37da5aa1ed72d39802ac8653f84a953b286accca80e93b71f4ebd6c213eba89c
|
File details
Details for the file ctyun_cli-1.28.1-py3-none-any.whl.
File metadata
- Download URL: ctyun_cli-1.28.1-py3-none-any.whl
- Upload date:
- Size: 400.1 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 |
d12d4082b86612642401c55fb8dc428df1036135ad79162d237876bce8add4a5
|
|
| MD5 |
81b382416b41addcba8d1ff539ab06ec
|
|
| BLAKE2b-256 |
8306310d4f549a4e2b3ef0ffb83f863006c85d8400be2d942147a792d4d1577a
|
