天翼云 CLI 工具 🚀

PyPI version Python License APIs Commands Modules

天翼云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大服务模块

📚 完整文档

🚀 快速开始

📖 功能文档

🔧 高级功能

❓ 帮助支持

🔗 相关链接

外部资源

内部文档

🤝 技术支持

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

📝 更新日志

最新版本: v1.25.0 (2026-07-01)

  • 🆕 新增 APM（应用性能监控）模块：44 个命令，涵盖元数据、应用管理、链路追踪、性能分析、用量统计、告警、通知、Webhook

v1.24.6 (2026-07-01)

  • 🚀 ELB 模块新增 19 个命令：访问控制、监控、SLA/证书、转发策略、健康检查、网关负载均衡、IP 监听

v1.24.5 (2026-07-01)

  • 🚀 LTS 模块大幅扩展 + ZOS 模块新增命令：LTS 新增 168 个命令（项目/单元/主机组/采集/检索/转储/加工/告警/仪表盘等），ZOS 新增 38 个命令（桶/对象/IAM/标签管理）

v1.24.4 (2026-07-01)

  • 🚀 CCE 模块新增命令：query-cluster-id-by-order-id 根据订单 ID 查询集群 ID

v1.24.3 (2026-07-01)

  • 🚀 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

Project links

Data verified by PyPI on Jul 17, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.31.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for popfrog from gravatar.com popfrog

Credits

Author/Maintainer: Y.FENG

License

MIT

Requires

Python >=3.8

Provides Extra

dev test lint build

Tags

ctyun cloud cli management monitoring ecs redis distributed-cache query snapshot keypair volume backup affinity-group flavor resize vnc statistics api devops cda cloud-dedicated-access 专线 网关 vpc health-check link-probe

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ctyun_cli-1.25.0.tar.gz (341.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ctyun_cli-1.25.0-py3-none-any.whl (364.2 kB view details)

Uploaded Python 3

File details

Details for the file ctyun_cli-1.25.0.tar.gz.

File metadata

  • Download URL: ctyun_cli-1.25.0.tar.gz
  • Upload date:
  • Size: 341.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for ctyun_cli-1.25.0.tar.gz
Algorithm Hash digest
SHA256 0511871e0499fb2bf46bcb268ccade54d46d0e74868d6eb7d3124c9d8d2e47d5
MD5 2a848d6a63c9c98cc9b580050e53e914
BLAKE2b-256 b455297135ce4a9ef31b9766b3c3fc6d5ed7165488fc9923c439a313111e3498

See more details on using hashes here.

File details

Details for the file ctyun_cli-1.25.0-py3-none-any.whl.

File metadata

  • Download URL: ctyun_cli-1.25.0-py3-none-any.whl
  • Upload date:
  • Size: 364.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.12

File hashes

Hashes for ctyun_cli-1.25.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5739622a88d3ad2b968550ee44cf1cdf0c3f8d3ac9e98cb966872925a201092d
MD5 b96fa5f56638b0b46ff7de68166c97a8
BLAKE2b-256 6198113f7d8d373ea030d8784f50c35273f3d2a1409169c9edd9e4637872b726

See more details on using hashes here.

Release history Release notifications | RSS feed

1.31.2

1 file

1.31.1

1 file

1.31.0

1 file

1.30.0

1 file

1.29.2

1 file

1.29.1

1 file

1.29.0

1 file

1.28.1

2 files

1.28.0

2 files

1.27.5

2 files

1.27.4

2 files

1.27.3

2 files

1.27.2

2 files

1.27.1

2 files

1.27.0

2 files

1.26.2

2 files

1.26.1

2 files

1.26.0

2 files

This release

1.25.0 This release

2 files

1.24.6

2 files

1.24.5

2 files

1.24.4

2 files

1.24.3

2 files

1.24.2

2 files

1.24.1

2 files

1.24.0

2 files

1.23.0

2 files

1.22.0

2 files

1.21.0

2 files

1.20.6

2 files

1.20.5

2 files

1.20.4

2 files

1.20.3

1 file

1.20.2

2 files

1.20.1

2 files

1.20.0

2 files

1.19.1

2 files

1.19.0

2 files

1.18.5

2 files

1.18.4

2 files

1.18.1

2 files

1.18.0

1 file

1.17.1

1 file

1.17.0

1 file

1.15.0

1 file

1.14.0

1 file

1.13.0

1 file

1.12.0

2 files

1.9.0

1 file

1.8.3

2 files

1.8.2

2 files

1.8.1

2 files

1.8.0

2 files

1.7.17

2 files

1.7.16

2 files

1.7.15

2 files

1.7.14

2 files

1.7.13

1 file

1.7.12

2 files

1.7.11

2 files

1.7.10

1 file

1.7.9

1 file

1.7.8

1 file

1.7.7

1 file

1.7.6

2 files

1.7.5

1 file

1.7.4

2 files

1.7.2

2 files

1.7.0

1 file

1.6.3

1 file

1.6.2

1 file

1.6.1

1 file

1.6.0

1 file

1.5.0

1 file

1.4.0

1 file

1.3.11

2 files

1.3.10

1 file

1.3.9

2 files

1.3.8

1 file

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0

2 files

1.1.0

2 files

1.0.2

2 files

1.0.1

2 files

Pre-release

0.1.0a1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page