天翼云 CLI (ctyun-cli)

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

规模统计： 43,000+行代码，397+个API，383+个命令，17大服务模块

安装

使用 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 eip

NAT 网关查询

ctyun-cli vpc nat-gateway

VPC 对等连接查询

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 --help

ConfigMap 管理

ctyun-cli cce configmap --help

标签管理

ctyun-cli cce tag --help

Namespace 命名空间管理

# 列出命名空间
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_ID

Redis 分布式缓存服务

列出 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-trend

CPU Top 排名

ctyun-cli monitor cpu-top

内存 Top 排名

ctyun-cli monitor mem-top

磁盘 Top 排名

ctyun-cli monitor disk-top

数据订阅管理

ctyun-cli monitor query-message-subscription
ctyun-cli monitor describe-message-subscription

通知套餐管理

ctyun-cli monitor notice-pack-list
ctyun-cli monitor notice-pack-used
ctyun-cli monitor notice-pack-limit-detail

监控看板

ctyun-cli monitor list-monitor-board
ctyun-cli monitor query-monitor-board-sys-services
ctyun-cli monitor query-monitor-board-view-data

监控对象资源列表

ctyun-cli monitor query-ecs-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-pms-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-evs-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-eip-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-traffic-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-elb-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-listener-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-scaling-group-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-zos-user-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-zos-bucket-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-vpc-endpoint-list --region-id RESOURCE_POOL_ID
ctyun-cli monitor query-vpc-endpoint-service-list --region-id RESOURCE_POOL_ID

设备类型监控项查询

ctyun-cli monitor query-monitor-items-by-device --region-id RESOURCE_POOL_ID

账务中心管理

查询账户余额

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 --help

VPC 管理

ctyun-cli cda vpc --help

BGP 路由管理

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 输出格式便于与其他工具集成
按需查询大量数据时建议分页或使用过滤参数

版本信息

当前版本: v1.18.5 (2026-05-14)
开源协议: MIT
Python 要求: Python 3.8+
API 覆盖: 397+ 个 API
命令数量: 383+ 个命令
服务模块: 17 大服务模块
最新功能:
- 🚀 监控模块新增 21 个 API：数据订阅、套餐管理、监控看板、资源列表查询(12类)
- 🚀 ECS 模块新增 12 个 API：资源池(3)、云助手(4)、宿主机(3)、网卡(2)
- 🆕 AIServer（模型推理服务）模块：预置模型/订单/服务组/报表共 19 个 API
- 🆕 CloudPC（云电脑/政企版）模块：实例/镜像/磁盘/用户/组织共 10 个 API
- 🆕 IAM 全面扩展：从 3 个 API 扩展至 34 个（用户/权限/策略/委托/AK-SK/MFA等）
- 🆕 Aone（边缘安全加速平台）模块：域名/证书/缓存/安全防护共 45 个 API
- 🆕 EMR/CSS/Kafka 模块

ctyun-cli-天翼云-命令行

天翼云 CLI (ctyun-cli)

安装

使用 pip 安装（推荐）

使用 pipx 安装（隔离环境）

从源码安装

验证安装

配置与认证

方式一：环境变量（推荐，更安全）

方式二：交互式配置

查看当前配置

列出所有配置文件

测试 API 连接

全局选项

云服务器 (ECS) 管理

列出云主机实例

查询云主机详情

查询多台云主机详细信息

查询云主机统计信息

查询资源池列表

订单询价

虚拟私有云 (VPC) 管理

列出 VPC

查询 VPC 详情

子网查询

安全组查询

路由表查询

弹性公网 IP 查询

NAT 网关查询

VPC 对等连接查询

流日志查询

云硬盘 (EBS) 管理

列出云硬盘

弹性负载均衡 (ELB) 管理

负载均衡器管理

监听器管理

目标组管理

健康检查管理

监控数据管理

容器引擎 (CCE) 管理

列出集群

查询集群详情

获取 Kubeconfig

列出节点

查询节点详情

列出 Pod

列出 Deployment

列出 Service

集群日志管理

节点池管理

弹性伸缩管理

ConfigMap 管理

标签管理

Namespace 命名空间管理

Redis 分布式缓存服务

列出 Redis 实例

查询实例详情

查询实例网络信息

查询实例逻辑拓扑

批量查询集群节点信息

创建 Redis 实例

查询可用区

查询引擎版本

监控数据查询

诊断服务

客户端连接管理

云监控服务管理

查询监控数据

查询告警规则

查询告警历史

查询资源组

自定义监控指标查询

CPU Top 排名

内存 Top 排名

磁盘 Top 排名

数据订阅管理

通知套餐管理

监控看板

监控对象资源列表

设备类型监控项查询