- name
- ctyun-cli
- description
- 天翼云CLI工具 - 企业级命令行工具，帮助您轻松管理天翼云资源。支持ECS、VPC、EBS、ELB、CCE、Redis、Kafka、CSS、EMR、监控、账务等15+服务模块，覆盖311+个API，217+个命令。
- homepage
- https://github.com/fengyucn/ctyun-cli
- pypi
- https://pypi.org/project/ctyun-cli/
- metadata
- {"clawdbot":{"emoji":"☁️","requires":{"bins":["ctyun-cli"]},"install":[{"id":"pip","kind":"pip","package":"ctyun-cli","bins":["ctyun-cli"],"label":"Install ctyun-cli (pip)"}]}}
天翼云 CLI (ctyun-cli)
天翼云 CLI 工具，功能强大的企业级命令行工具，帮助您轻松管理天翼云资源。支持云服务器(ECS)、监控告警、安全防护、Redis分布式缓存、弹性负载均衡(ELB)、容器引擎(CCE)、VPC网络、费用查询等核心功能。
规模统计： 39,000+行代码，311+个API，217+个命令，15+大服务模块
安装
使用 pip 安装（推荐）
pip install ctyun-cli使用 pipx 安装（隔离环境）
pipx install ctyun-cli从源码安装
git clone https://github.com/fengyucn/ctyun-cli.git
cd ctyun-cli
pip install -e .验证安装
ctyun-cli --version
ctyun-cli --help配置与认证
方式一：环境变量（推荐，更安全）
export CTYUN_ACCESS_KEY=your_access_key
export CTYUN_SECRET_KEY=your_secret_key将上述命令添加到 ~/.bashrc 或 ~/.zshrc 以实现永久配置。
方式二：交互式配置
ctyun-cli configure --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY --region cn-north-1查看当前配置
ctyun-cli show-config列出所有配置文件
ctyun-cli list-profiles测试 API 连接
ctyun-cli test全局选项
所有命令都支持以下全局选项：
--profile TEXT: 指定配置文件名称--access-key TEXT: 访问密钥--secret-key TEXT: 密钥--region TEXT: 区域--endpoint TEXT: API 端点--output [table|json|yaml]: 输出格式（默认 table）--debug: 启用调试模式
云服务器 (ECS) 管理
列出云主机实例
ctyun-cli ecs list
ctyun-cli ecs list --region cn-north-1 --output json查询云主机详情
ctyun-cli ecs detail --instance-id YOUR_INSTANCE_ID查询多台云主机详细信息
ctyun-cli ecs multidetail --instance-ids ID1,ID2,ID3查询云主机统计信息
ctyun-cli ecs statistics查询资源池列表
ctyun-cli ecs regions订单询价
ctyun-cli ecs query-price --flavor-id FLAVOR_ID --quantity 1虚拟私有云 (VPC) 管理
列出 VPC
ctyun-cli vpc list
ctyun-cli vpc new-list查询 VPC 详情
ctyun-cli vpc show --vpc-id YOUR_VPC_ID子网查询
ctyun-cli vpc subnet --vpc-id YOUR_VPC_ID安全组查询
ctyun-cli vpc security --vpc-id YOUR_VPC_ID路由表查询
ctyun-cli vpc route-table --vpc-id YOUR_VPC_ID弹性公网 IP 查询
ctyun-cli vpc eipNAT 网关查询
ctyun-cli vpc nat-gatewayVPC 对等连接查询
ctyun-cli vpc peering流日志查询
ctyun-cli vpc flow-log云硬盘 (EBS) 管理
列出云硬盘
ctyun-cli ebs list
ctyun-cli ebs list --region cn-north-1 --output json弹性负载均衡 (ELB) 管理
负载均衡器管理
ctyun-cli elb loadbalancer --help
ctyun-cli elb loadbalancer list监听器管理
ctyun-cli elb listener --help目标组管理
ctyun-cli elb targetgroup --help健康检查管理
ctyun-cli elb health-check --help监控数据管理
ctyun-cli elb monitor --help容器引擎 (CCE) 管理
列出集群
ctyun-cli cce list-clusters查询集群详情
ctyun-cli cce describe-cluster --cluster-id YOUR_CLUSTER_ID获取 Kubeconfig
ctyun-cli cce get-kubeconfig --cluster-id YOUR_CLUSTER_ID列出节点
ctyun-cli cce list-nodes --cluster-id YOUR_CLUSTER_ID查询节点详情
ctyun-cli cce get-node-detail --cluster-id CLUSTER_ID --node-id NODE_ID列出 Pod
ctyun-cli cce list-pods --cluster-id CLUSTER_ID列出 Deployment
ctyun-cli cce list-deployments --cluster-id CLUSTER_ID列出 Service
ctyun-cli cce list-services --cluster-id CLUSTER_ID集群日志管理
ctyun-cli cce logs --help节点池管理
ctyun-cli cce nodepool --help弹性伸缩管理
ctyun-cli cce autoscaling --helpConfigMap 管理
ctyun-cli cce configmap --help标签管理
ctyun-cli cce tag --helpNamespace 命名空间管理
# 列出命名空间
ctyun-cli cce namespace list --cluster-id CLUSTER_ID --region-id REGION_ID
# 查询命名空间详情
ctyun-cli cce namespace show --cluster-id CLUSTER_ID --namespace-name default --region-id REGION_ID
# 创建命名空间
ctyun-cli cce namespace create --cluster-id CLUSTER_ID --region-id REGION_ID --namespace-yaml "apiVersion: v1
kind: Namespace
metadata:
name: my-namespace"
# 更新命名空间
ctyun-cli cce namespace update --cluster-id CLUSTER_ID --namespace-name my-namespace --region-id REGION_ID --namespace-yaml "apiVersion: v1
kind: Namespace
metadata:
name: my-namespace
labels:
env: production"
# 删除命名空间
ctyun-cli cce namespace delete --cluster-id CLUSTER_ID --namespace-name my-namespace --region-id REGION_IDRedis 分布式缓存服务
列出 Redis 实例
ctyun-cli redis list查询实例详情
ctyun-cli redis describe --instance-id YOUR_INSTANCE_ID
ctyun-cli redis describe -i YOUR_INSTANCE_ID -f table查询实例网络信息
ctyun-cli redis network --instance-id YOUR_INSTANCE_ID
ctyun-cli redis network -i YOUR_INSTANCE_ID --region-id RESOURCE_POOL_ID查询实例逻辑拓扑
ctyun-cli redis topology --instance-id YOUR_INSTANCE_ID批量查询集群节点信息
ctyun-cli redis cluster-nodes
ctyun-cli redis cluster-nodes --page 1 --size 20创建 Redis 实例
ctyun-cli redis create-instance --help查询可用区
ctyun-cli redis zones查询引擎版本
ctyun-cli redis engine-version --instance-id INSTANCE_ID
ctyun-cli redis instance-version --instance-id INSTANCE_ID监控数据查询
ctyun-cli redis monitor-history --instance-id INSTANCE_ID诊断服务
ctyun-cli redis diagnose --instance-id INSTANCE_ID客户端连接管理
ctyun-cli redis clients --instance-id INSTANCE_ID云监控服务管理
查询监控数据
ctyun-cli monitor list查询告警规则
ctyun-cli monitor query-alarm-rules查询告警历史
ctyun-cli monitor query-alert-history查询资源组
ctyun-cli monitor query-resource-groups自定义监控指标查询
ctyun-cli monitor query-custom-trendCPU Top 排名
ctyun-cli monitor cpu-top内存 Top 排名
ctyun-cli monitor mem-top磁盘 Top 排名
ctyun-cli monitor disk-top账务中心管理
查询账户余额
ctyun-cli billing balance查询欠费信息
ctyun-cli billing arrears查询账户账单
ctyun-cli billing account-bill --bill-cycle 202503查询消费类型汇总
ctyun-cli billing bill-summary --bill-cycle 202503查询按需流水账单
ctyun-cli billing ondemand-flow --bill-cycle 202503查询包周期流水账单
ctyun-cli billing cycle-flow --bill-cycle 202503查询消费明细
ctyun-cli billing consumption统一身份认证 (IAM) 管理
查询企业项目列表
ctyun-cli iam list-projects查询企业项目详情
ctyun-cli iam get-project --project-id PROJECT_ID分页查询资源信息
ctyun-cli iam list-resources服务器安全卫士
查看使用示例
ctyun-cli security examples主机防护
ctyun-cli security wrapper --help防篡改更新
ctyun-cli security tamper-update --help云专线 (CDA) 管理
物理专线管理
ctyun-cli cda physical-line --help专线网关管理
ctyun-cli cda gateway --helpVPC 管理
ctyun-cli cda vpc --helpBGP 路由管理
ctyun-cli cda bgp-route --help静态路由管理
ctyun-cli cda static-route --help健康检查和链路探测管理
ctyun-cli cda health-check --help跨账号授权管理
ctyun-cli cda account-auth --help分布式消息服务 (Kafka) 管理
查询实例列表
ctyun-cli kafka list --region-id RESOURCE_POOL_ID
ctyun-cli kafka list -r xxx --name test --exact-match
ctyun-cli kafka list -r xxx --status 1 --page 1 --size 20查看实例节点状态
ctyun-cli kafka node-status --region-id RESOURCE_POOL_ID --instance-id INSTANCE_ID查询弹性IP列表
ctyun-cli kafka floating-ips --region-id RESOURCE_POOL_ID获取实例配置
ctyun-cli kafka config --region-id RESOURCE_POOL_ID --instance-id INSTANCE_ID云搜索服务 (CSS) 管理
查询实例列表
ctyun-cli css list --region-id RESOURCE_POOL_ID --type 1
ctyun-cli css list -r xxx --name test查询实例详情
ctyun-cli css describe --cluster-id CLUSTER_ID查询 Logstash 实例列表
ctyun-cli css logstash-list --region-id RESOURCE_POOL_ID翼 MapReduce (EMR) 管理
查询集群列表
ctyun-cli emr list --region-id RESOURCE_POOL_ID
ctyun-cli emr list -r xxx --name test --v2查询集群详情
ctyun-cli emr describe --cluster-id CLUSTER_ID
ctyun-cli emr describe --cluster-id CLUSTER_ID --v2查询节点组信息
ctyun-cli emr node-groups --cluster-id CLUSTER_ID
ctyun-cli emr node-groups --cluster-id CLUSTER_ID --v2查询节点组详情
ctyun-cli emr node-detail --cluster-id CLUSTER_ID
ctyun-cli emr node-detail --cluster-id CLUSTER_ID --node-state 8查询 Hive 元数据概览
ctyun-cli emr meta-overview --cluster-id CLUSTER_ID查询 Hive 表元数据
ctyun-cli emr meta-table --cluster-id CLUSTER_ID --database test_db --table test_table云日志服务 (LTS) 管理
ctyun-cli lts --help弹性文件服务 (SFS) 管理
ctyun-cli sfs --help海量文件服务 (OceanFS) 管理
ctyun-cli oceanfs --help边缘安全加速平台 (Aone) 管理
ctyun-cli aone --help网络管理
ctyun-cli network --help存储管理
ctyun-cli storage --help缓存管理
清空所有缓存
ctyun-cli clear-cache使用技巧
JSON 输出便于脚本处理
ctyun-cli ecs list --output json | jq '.[] | select(.status=="running")'YAML 输出便于阅读
ctyun-cli vpc show --vpc-id vpc-xxx --output yaml调试模式排查问题
ctyun-cli ecs list --debug使用指定配置文件
ctyun-cli ecs list --profile production注意事项
- 首次使用前必须先配置认证信息（推荐使用环境变量方式）
- 大部分命令需要指定资源 ID（如 instance-id、vpc-id 等）
- 建议使用
--help查看具体子命令的详细参数 - 使用 JSON 输出格式便于与其他工具集成
- 按需查询大量数据时建议分页或使用过滤参数
相关链接
- PyPI 包: https://pypi.org/project/ctyun-cli/
- GitHub 仓库: https://github.com/fengyucn/ctyun-cli
- 问题反馈: https://github.com/fengyucn/ctyun-cli/issues
- 作者邮箱: popfrog@gmail.com
版本信息
- 当前版本: v1.12.0 (2026-04-30)
- 开源协议: MIT
- Python 要求: Python 3.8+
- API 覆盖: 311+ 个 API
- 命令数量: 217+ 个命令
- 服务模块: 15+ 大服务模块
- 最新功能:
- 🆕 EMR（翼MapReduce）模块：集群/节点组/元数据管理共 8 个 API - 🆕 CSS（云搜索服务）模块：OpenSearch/Elasticsearch/Logstash 管理 - 🆕 Kafka（分布式消息服务）模块：实例/节点/弹性IP/配置管理 - 🆕 LTS/SFS/OceanFS/Aone 模块脚手架 - 🎯 Redis 模块完善：新增 topology/cluster-nodes 命令，修复 network/describe 命令