天翼云 CLI 工具 🚀

PyPI version Python License APIs Commands Modules

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

English | 简体中文

✨ 为什么选择天翼云 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大服务模块

📚 完整文档

🚀 快速开始

📖 功能文档

🔧 高级功能

❓ 帮助支持

🔗 相关链接

外部资源

内部文档

🤝 技术支持

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

📝 更新日志

最新版本: 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

Project links

Data verified by PyPI on Jul 23, 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.27.0.tar.gz (359.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.27.0-py3-none-any.whl (381.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: ctyun_cli-1.27.0.tar.gz
  • Upload date:
  • Size: 359.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.27.0.tar.gz
Algorithm Hash digest
SHA256 11870bb4007c0a4ab680d6e8009dfb3a8af182875e53f21650215b9091c988f5
MD5 a2b5ce561f57a2dba164c1d24ae4818b
BLAKE2b-256 63db3b3fd28bcd80f86f9bbb06eb59be2239bf2a117618c489380c584d790e74

See more details on using hashes here.

File details

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

File metadata

  • Download URL: ctyun_cli-1.27.0-py3-none-any.whl
  • Upload date:
  • Size: 381.5 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.27.0-py3-none-any.whl
Algorithm Hash digest
SHA256 772e5bfe0a7caf8cd5430aa25a0883b6dbc54acea69ad1e8fbfbe26aa010fb24
MD5 4f29325e4192e34541a9a18e6a60ac62
BLAKE2b-256 71d6f197f9ad921e727a0740efbc004f79b52fde2dc91d843eb675288d70e7a4

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

This release

1.27.0 This release

2 files

1.26.2

2 files

1.26.1

2 files

1.26.0

2 files

1.25.0

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