ctyun-cli 1.19.0

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

天翼云 CLI 工具 🚀

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

English | 简体中文

✨ 为什么选择天翼云 CLI？

• 🚀 高效便捷 - 一行命令完成云资源查询和管理，告别繁琐的控制台操作
• 🔐 安全可靠 - 企业级EOP签名认证，支持环境变量配置保护密钥安全
• 📊 功能全面 - 覆盖260+个API，支持17大服务模块
• 🎯 简单易用 - 清晰的命令结构，丰富的使用示例，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	事件查询、资源池管理、跟踪任务管理	详细文档
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 (云日志服务)	-	-	日志采集、检索、投递、告警管理（实现中）	-
总计	391	405	覆盖天翼云核心服务	所有模块

📊 规模统计：43,000+行代码，405+个API，391+个命令，18大服务模块

📚 完整文档

🚀 快速开始

• 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.19.0 (2026-05-18)

• 🆕 新增云审计（Cloud Audit）模块：新增 8 个查询 API + 8 个 CLI 命令，涵盖事件查询、资源池管理、跟踪任务管理
  • audit list-events / get-event-selection / get-service-status / get-available-regions
  • audit get-user-authority / get-storage-region-info / list-tracks / get-track

v1.18.5 (2026-05-14)

• 🚀 监控模块大幅扩展：新增 21 个查询 API + 21 个 CLI 命令，涵盖数据订阅(2)、套餐管理(3)、监控看板(3)、资源列表(12)、设备类型监控项(1)
  • monitor query-message-subscription / describe-message-subscription
  • monitor notice-pack-list / notice-pack-used / notice-pack-limit-detail
  • monitor list-monitor-board / query-monitor-board-sys-services / query-monitor-board-view-data
  • monitor query-ecs-list / query-pms-list / query-evs-list / query-eip-list 等 12 个资源列表

v1.18.4 (2026-05-14)

• 🚀 ECS 查询 API 扩展：新增 12 个查询 API + 12 个 CLI 命令，涵盖资源池(3)、云助手(4)、宿主机(3)、网卡(2)
  • ecs get-region-summary / get-region-products / check-region-demand
  • ecs get-commands / get-command / get-ca-agent / describe-send-file-results
  • ecs list-dedicated-hosts / check-dedicated-host-demand / list-dedicated-host-flavors
  • ecs list-ports / show-port

v1.18.1 (2026-03-01)

• 🔧 CLI 初始化优化: configure/show-config/list-profiles/clear-cache 命令不再需要预先配置认证信息，全新环境可直接运行

v1.18.0 (2026-05-12)

• 🆕 IAM（统一身份认证）全面扩展：从 3 个 API 扩展至 34 个，覆盖 12 大功能分类
  • 用户管理（查询/列表/登录配置/访问控制）
  • 用户组管理（列表/详情/成员查询）
  • 权限管理（按账户/用户/用户组查询权限、继承权限、自身权限）
  • 策略管理（列表/详情）
  • 委托管理（列表/分页/详情）
  • 企业项目（关联用户组/策略查询）
  • AK/SK 管理（密钥/回收站）
  • 身份供应商（列表/详情）
  • MFA、敏感操作、服务管理、配额/资源池查询
• 🚀 CCE（容器引擎）持续增强：从 49 个命令扩展至 79 个，新增 42 个 API
  • 终端节点 cce-global.ctapi.ctyun.cn
  • 支持命名空间管理、任务管理、标签管理等更多场景

v1.17.0 (2026-05-08)

• 🚀 EIP 弹性公网IP增强：实现真实可用的 EIP 查询 API
  • vpc eip detail：查看EIP详情（带宽/绑定/计费信息）
  • vpc eip shared-bandwidths：查询共享带宽列表（支持模糊搜索）
• 🔧 VPC EIP 查询修复：vpc eip list 从空壳实现为可用状态，支持按状态/IP/实例过滤

v1.16.0 (2026-05-08)

• 🔧 VPC EIP 查询实现：vpc eip list 从 TODO 空壳变为真实的 POST 查询

v1.15.0 (2026-05-08)

• 🆕 新增 AIServer（模型推理服务）模块：终端节点 ctinfer-global.ctapi.ctyun.cn，实现 19 个 API
  • aiserver billing-models / billing-product / orders / service-groups / models / report-call 等

v1.14.0 (2026-05-07)

• 🆕 新增 CloudPC（云电脑/政企版）模块：终端节点 ecpc-global.ctapi.ctyun.cn，实现 10 个查询 API
  • cloudpc list / cloudpc ecs-list / cloudpc images / cloudpc volumes / cloudpc vpcs / cloudpc subnets / cloudpc users / cloudpc orgs / cloudpc service-status
• 🤷‍♂️ 求助：云电脑查询 API 已实现并验证通过，但云电脑使用独立的资源池 ID 体系

v1.13.0 (2026-05-02)

• 🚀 ECS监控增强：新增 cpu-latest/mem-latest/network-latest/disk-latest 实时监控命令，以及 cpu-history/mem-history/network-history/disk-history 历史数据查询命令
• 📋 ECS订单查询增强：新增 query-dedicated-host-uuid（宿主机）和 query-order-uuid（通用资源）命令

v1.12.0 (2026-04-30)

• 🆕 新增 EMR（翼MapReduce）模块：终端节点 emr-global.ctapi.ctyun.cn，实现 8 个 API

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

📜 开源协议

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

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

---

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

安装命令: pip install ctyun-cli