ctyun-cli-天翼云-命令行

作者 admin

2026年11月12日 28 分钟阅读

1 0

下载地址

代码

https://www.zhengdianxue.com/wp-content/uploads/skills/user_70730af0--ctyun-cli-skill.zip

将提示词发送给你的 AI 安装该 skills

代码

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_70730af0/ctyun-cli-skill。

天翼云CLI工具 – 企业级命令行工具，帮助您轻松管理天翼云资源。支持ECS、VPC、EBS、ELB、CCE、Redis、Kafka、CSS、EMR、监控、账务、IAM、Aone、CloudPC、AIServer等17大服务模块，覆盖397+个API，383+个命令。

阅读全文（展开查看完整说明）

概述

天翼云 CLI (ctyun-cli)

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

规模统计： 71,000+行代码，1,132+个API，1,080+个命令，31+大服务模块

阅读路径

本文件按"先结论、后细节"分层组织，按需读取，不必通读：

层级	章节	什么时候看
L0 结论层	[快速开始](#快速开始5-分钟) · [场景速查表](#场景速查表我要做-x用哪个命令) · [模块索引](#模块索引) · [能力边界与使用约束](#能力边界与使用约束)	接到"帮我查 XX 资源"的任务，先读这四节即可开工
L1 排错层	[异常处理与错误排查](#异常处理与错误排查) · [反模式与常见问题](#反模式与常见问题-faq)	命令报错、结果为空、JSON 解析失败、怀疑数据不可信
L2 参考层	[模块索引](#模块索引) → 对应模块小节	已知要查什么，按模块小节精确取参数
L3 附录	[询价](#询价–价格查询) · [使用技巧](#使用技巧) · [注意事项](#注意事项) · [版本信息](#版本信息)	询价、脚本集成、版本核对

判断标准：只要任务能靠"场景速查表"定位到命令，就不必往下读；只有在参数报错、结果异常或需要精确字段名时，才进入 L1/L2。

快速开始（5 分钟）

BASH

# 1) 安装
pip install ctyun-cli                 # 或 pipx install ctyun-cli

# 2) 配置（二选一）
export CTYUN_ACCESS_KEY=xxx CTYUN_SECRET_KEY=xxx     # 环境变量（推荐，不落盘）
ctyun-cli configure --access-key xxx --secret-key xxx --region cn-north-1

# 3) 自检
ctyun-cli show-config                  # 确认 region / endpoint / 超时 / 重试
ctyun-cli --help                       # 33 个模块分组 + 5 个工具命令

# 4) 第一条查询
ctyun-cli ecs list --region-id 200000001852 --page-size 5

# 5) 脚本化（JSON 放在子命令之后）
ctyun-cli ecs list --region-id 200000001852 --page-size 5 --output json

完整说明见 [安装](#安装) 与 [配置与认证](#配置与认证)。

两条最容易踩的规则

--region-id 传资源池 ID（如 200000001852），--region 传区域名（如 cn-north-1）。两者混用会查不到数据。
--output 的位置取决于命令：命令自带该选项时写在子命令之后（ecs list ... --output json）；命令没有该选项时写在模块之前（ctyun-cli --output json cda qos list ...）。不确定就先 --help 看 Options 里有没有 --output。

输出长什么样

表格输出（首行是总量，实例 ID 完整不截断）：

代码

$ ctyun-cli ecs list --region-id 200000001852 --page-size 2
云主机列表 (总计: 451 台, 当前页: 2 台, 第1/226页)

+--------------------------------------+------------------+---------+---------------+----------------+-------------------------+----------------------+
| 实例ID                               | 实例名称         | 状态    | IP地址        | 规格           | 镜像                    | 到期时间             |
+======================================+==================+=========+===============+================+=========================+======================+
| b2af5dc1-bf2d-2851-a36b-d54a80b09c38 | cld-t-ty0119-NG  | running | 10.217.17.144 | hs1.small.1    | nginx-image-xin-6.26    | 2027-01-11T06:35:26Z |
|                                      |                  |         |               | 1C1G           |                         |                      |
+--------------------------------------+------------------+---------+---------------+----------------+-------------------------+----------------------+
| 3c981fc4-653e-ca53-5b11-5b7c6cd06958 | cld-t-ty00706-NG | running | 10.217.16.141 | hs1.small.1    | nginx-image-xinzheng... | 2026-11-26T05:45:16Z |
|                                      |                  |         |               | 1C1G           |                         |                      |
+--------------------------------------+------------------+---------+---------------+----------------+-------------------------+----------------------+

提示: 使用 --page 参数查看其他页

JSON 输出（--output json，供脚本消费；字段较多，此处仅摘录关键项）：

代码

$ ctyun-cli ecs list --region-id 200000001852 --page-size 1 --output json
[
  {
    "azName": "cn-huabei2-tj1A-public-ctcloud",
    "expiredTime": "2027-01-11T06:35:26Z",
    "projectID": "6c97c94e8e3948cf959bfeb737039a59",
    "instanceID": "b2af5dc1-bf2d-2851-a36b-d54a80b09c38",
    "displayName": "cld-t-ty0119-NG",
    "instanceStatus": "running",
    "onDemand": false
  }
]

两种输出前面都会带 1~2 行 INFO 日志（写到 stdout），脚本解析请先剥掉，详见 [反模式与常见问题](#反模式与常见问题-faq)。

场景速查表（我要做 X，用哪个命令）

#	场景	命令	关键参数	说明
1	盘点某资源池的全部云主机	`ecs list`	`--region-id` `--page-size`	表头给出"总计 N 台"，JSON 里是 `totalCount`
2	看主机数量/到期/容量汇总	`ecs statistics`	`--region-id`	数量、CPU 核数、内存 GB
3	查单台主机详情	`ecs detail`	`--instance-id`
4	批量查多台主机	`ecs multidetail`	`--instance-ids`	逗号分隔
5	查主机网卡与 EIP 绑定关系	`ecs list-ports`	`--device-id` 或 `--subnet-id`	查"某内网 IP 的 EIP"首选
6	查可用区 / 资源池	`ecs get-availability-zones-details`、`ecs regions`
7	查 VPC / 子网	`vpc list`、`vpc subnet list`	`--vpc-id`
8	查 EIP 及状态	`vpc eip list`、`vpc eip detail`	`--eip-id`
9	查安全组及规则	`vpc security-group list`、`vpc security-group rules`	`--security-group-id`
10	查云硬盘 / 快照	`ebs list`、`ebs info`、`ebs snapshots`	`--disk-id`	`list-by-name` 按名称查
11	查负载均衡器 / 监听器 / 目标组	`elb loadbalancer list`、`elb listener list`、`elb targetgroup list`	`--loadbalancer-id`
12	查容器集群 / 节点 / Pod	`cce list-clusters`、`cce list-nodes`、`cce list-pods`	`--cluster-id`
13	取 Kubeconfig 接入集群	`cce get-kubeconfig`	`--cluster-id`
14	查 Redis 实例 / 详情	`redis list`、`redis describe`	`-i` / `--instance-id`
15	查 Redis 监控 / 慢日志	`redis monitor-items-v2`、`redis slow-log`	`--prod-inst-id`
16	查 Kafka / MySQL 实例	`kafka list`、`ctmysql list`	`--region-id`
17	查监控指标 / 告警	`monitor query-latest-metric-data`、`monitor query-alarm-rules`、`monitor query-alert-history`	`--region-id`	告警定位用 `query-alarm-top-resource`
18	查账单 / 消费汇总	`billing bill-summary <账期>`、`billing bill-list`	账期 `YYYYMM`
19	查新版账单明细（包周期+按需合并）	`billing product-cycle-v2`、`billing resource-detail-v2`、`billing usage-detail-v2`	`--region-id`	支持 `--group-by-day`
20	查企业项目	`iam list-projects`	`--account-id`
21	查镜像	`ims describe`、`ims list-available`
22	查对象存储桶 / 对象	`zos list-buckets`、`zos list-objects`	`--region-id`
23	检索日志	`lts search logs-v1`、`lts unit list-v1`	`--region-id`	支持 SQL 分析语句与游标翻页
24	查云专线（网关/专线/路由/QOS）	`cda gateway list`、`cda physical-line list`、`cda static-route list`、`cda qos list`	`--region-id` `--line-id`	网关类需 `--account`；实际字段为 `vrfName`
25	查云防火墙资产 / 防护策略	`cfw asset list`、`cfw policy list`	`--region-id`
26	查容器镜像	`swr list-instances`、`swr list-namespaces`、`swr list-repositories`、`swr list-tags`	`--region-id` `--instance-id` `--repository-id`	详情用 `get-instance`/`get-namespace`/`get-repository`/`get-tag`
27	查应用性能 / 调用链	`apm app list`、`apm trace list`	`--region-id`
28	查物理机	`dps list`、`dps describe`	`--region-id`
29	查微服务引擎 / Nacos	`mse instance list`、`mse nacos service list`	`--region-id`
30	询价（新购/续订/变配）	见 [询价 / 价格查询](#询价–价格查询)		8 个模块 41+ 个询价 API
31	清理本地缓存	`clear-cache`
32	自检配置 / 连通性	`show-config`、`test`		`test` 只校验配置与客户端初始化，不发真实请求

模块索引

按模块定位命令小节：

模块	命令组	小节
云服务器	`ecs`	[云服务器 (ECS) 管理](#云服务器-ecs-管理)
虚拟私有云	`vpc`	[虚拟私有云 (VPC) 管理](#虚拟私有云-vpc-管理)
云硬盘	`ebs`	[云硬盘 (EBS) 管理](#云硬盘-ebs-管理)
弹性负载均衡	`elb`	[弹性负载均衡 (ELB) 管理](#弹性负载均衡-elb-管理)
容器引擎	`cce`	[容器引擎 (CCE) 管理](#容器引擎-cce-管理)
分布式缓存	`redis`	[Redis 分布式缓存服务](#redis-分布式缓存服务)
云监控	`monitor`	[云监控服务管理](#云监控服务管理)
账务中心	`billing`	[账务中心管理](#账务中心管理)
统一身份认证	`iam`	[统一身份认证 (IAM) 管理](#统一身份认证-iam-管理)
服务器安全卫士	`security` / `csscn`	[服务器安全卫士](#服务器安全卫士) · [服务器安全卫士（原生版）](#服务器安全卫士原生版)
关系数据库 MySQL 版	`ctmysql`	[关系数据库MySQL版 (RDS)](#关系数据库mysql版-rds)
云专线	`cda`	[云专线 (CDA) 管理](#云专线-cda-管理)
分布式消息	`kafka`	[分布式消息服务 (Kafka) 管理](#分布式消息服务-kafka-管理)
云搜索	`css`	[云搜索服务 (CSS) 管理](#云搜索服务-css-管理)
翼 MapReduce	`emr`	[翼 MapReduce (EMR) 管理](#翼-mapreduce-emr-管理)
云日志服务	`lts`	[云日志服务 (LTS) 管理](#云日志服务-lts-管理)
弹性文件服务	`sfs`	[弹性文件服务 (SFS) 管理](#弹性文件服务-sfs-管理)
海量文件服务	`oceanfs`	[海量文件服务 (OceanFS) 管理](#海量文件服务-oceanfs-管理)
对象存储	`zos`	[对象存储 (ZOS) 管理](#对象存储-zos-管理)
应用性能监控	`apm`	[应用性能监控 (APM) 管理](#应用性能监控-apm-管理)
物理机	`dps`	[物理机 (DPS) 管理](#物理机-dps-管理)
边缘安全加速	`aone`	[边缘安全加速平台 (Aone) 管理](#边缘安全加速平台-aone-管理)
微服务引擎	`mse`	[微服务引擎 (MSE) 管理](#微服务引擎-mse-管理)
云防火墙	`cfw`	[云防火墙 (CFW) 管理](#云防火墙-cfw-管理)
容器镜像服务	`swr`	[容器镜像服务 (SWR) 管理](#容器镜像服务-swr-管理)
其他分组	`aiserver` `audit` `cloudpc` `ec` `ims` `network` `storage`	`ctyun-cli <模块> --help` 自查

能力边界与使用约束

1. 写操作边界

1,051 个服务命令中约 950 个是查询（只读）类；约 100 个是变更类（命令名含 create delete update modify bind unbind start stop restart reset renew change apply import grant revoke remove enable disable sync upload 等）。
默认只做查询。确需变更时先跑对应的 *-price 询价命令、再用 --help 逐项核对参数；变更类命令没有 dry-run，参数错了就是真的改了云资源。
变更类命令的典型分布：cce create-cluster / cce delete-cluster、cce namespace create|update|delete、cce tag bind|unbind、redis create-instance、zos put-bucket-tagging、lts tag bind|unbind、lts transfer kafka-start|kafka-stop、monitor create-data-export-task。

2. 调用频率与分页

天翼云 OpenAPI 常见限流为 1000 次 / 60 秒（云专线 CDA 接口文档明确标注该值），其他模块以各自接口文档为准。
大结果集要循环分页并校验 totalCount 是否拉全；实测出现过只拿到部分数据的情况，拉全后再做统计。
单页条数建议 ≤100（ecs list --page-size 100 实测每页正常返回 100 条；命令 docstring 里写的"最大 50"已过时）。
分页参数名各模块不统一：--page / --page-no / --size / --page-size，用前先 --help。

3. 稳定性与容错

项	行为
超时	默认 30 秒，配置项 `[default] timeout`（`~/.ctyun/config`）
重试	默认 3 次，urllib3 `Retry` + 指数退避（`backoff_factor=1`），配置项 `[default] retry`
多端点容灾	云专线 CDA 客户端内置 4 个端点依次回退：`cda-global` → `cda` → `ctcda-global` → `global-cda`，全部失败才报"所有端点都失败"
缓存	仅 ECS 资源池列表走本地缓存（键 `ecs:regions:*`，TTL 24 小时）；其余命令不缓存
清理缓存	`ctyun-cli clear-cache`
TLS	自 v1.31.3 起全量校验证书，代理环境需保证证书链完整

4. 凭据与数据安全

凭据只放环境变量或 ~/.ctyun/config（文件权限 600，目录 700），不要写进代码、脚本、命令行历史或对话内容。
--debug 会对 eop-authorization / authorization 头脱敏（仅保留前 8 字符），可以放心用于排查，但 debug 日志仍含资源 ID 等业务信息。
内部接口文档（todoapi/）与凭据一律不得提交到仓库。

异常处理与错误排查

错误输出形态对照表

以下均为实测输出，退出码可用 echo $? 复核：

输出形态	触发条件	含义	处置	退出码
`Error: Missing option '--region-id'.` + Usage	必填参数缺失	Click 参数校验失败	补参数，或 `--help` 查必填项	2
`Error: No such command 'xxx'.`	命令名拼错	层级不对	`ctyun-cli <模块> --help` 确认子命令名	2
`API错误 [CODE]: message` + `请求ID: xxx`	服务端返回业务错误	权限/资源状态/参数不合法	按 message 修正；带请求 ID 提工单	1
`错误: <异常文本>`	本地异常（网络、解析）	请求未完成	加 `--debug` 看异常栈	1
`查询失败: <message>`	服务端非 800 业务码	参数或资源不被接受	核对资源池 ID、ID 是否存在	0 ⚠️
`所有端点都失败，已尝试: ...`	多端点全部不可达	网络不通或鉴权失败	检查出口网络/白名单、AK/SK	0/1
`⚠️ 注意: 当前显示的是模拟数据，实际API调用失败`	ECS 接口异常后的兜底	数据是假的，不可用于任何结论	排查资源池/权限后重查	0 ⚠️
VPC 列表里出现 `测试VPC` / `vpc-test12345678`	VPC 接口返回 HTTP 401/403 时的兜底	静默返回模拟数据，连警告都没有	立刻用 `show-config` 核对 AK/SK	0 ⚠️
`没有找到云主机实例` / `总数 0`	结果集为空	可能是鉴权失败被静默吞掉	用 `show-config` 核对 AK/SK，换已知有资源的资源池复验	0 ⚠️
表格里 `description` / `error` 两行	服务端 statusCode 900	资源池不存在或无权访问	改 `--region-id`	0 ⚠️

标 ⚠️ 的行最容易踩坑：它们不报错、退出码也是 0，脚本里必须显式校验内容，不能只看 $?。

退出码的规律：Click 的参数/用法错误一律是 2；模块命令用 handle_error 装饰器捕获的异常是 1；而"查询失败: …"这类业务失败是打印后直接返回，退出码仍是 0——EOP 签名类模块（ECS/VPC/CDA/Billing/Monitor…）普遍如此。

两个真实失败样例

参数错误（退出码 2）：

代码

$ ctyun-cli cda gateway list --region-id 200000001852
Usage: ctyun-cli cda gateway list [OPTIONS]
Try 'ctyun-cli cda gateway list --help' for help.

Error: Missing option '--account'.

资源池不存在 → ECS 回退到模拟数据（退出码仍是 0）：

代码

$ ctyun-cli ecs list --region-id 999999999999
... - WARNING - API返回错误: region info empty, please try again. If multiple attempts fail, please submit a work order
云主机列表 (总计: 1 台, 当前页: 1 台, 第1/1页)
⚠️  注意: 当前显示的是模拟数据，实际API调用失败
+-------------------+------------+---------+------------------+--------+--------+------------+
| 实例ID            | 实例名称   | 状态    | IP地址           | 规格   | 镜像   | 到期时间   |
+===================+============+=========+==================+========+========+============+
| instance-demo-001 | Web服务器1 | running | ['192.168.1.10'] | C0G    |        | 按量付费   |
+-------------------+------------+---------+------------------+--------+--------+------------+

看到 instance-demo-001 / Web服务器1 这类样例数据，就说明这次查询根本没拿到真实数据。

标准排查流程（5 步）

BASH

# 1. 配置对不对（区域、端点、超时、重试）
ctyun-cli show-config

# 2. 是不是参数问题（先看必填项和真实参数名）
ctyun-cli <模块> <命令> --help

# 3. 打开调试，看真实请求与响应
ctyun-cli --debug <模块> <命令> --region-id 200000001852
#   日志里关注：请求URL / 请求头(已脱敏) / 响应状态码 / 响应内容

# 4. 换一个已知有数据的资源池复验，区分"资源为空"和"鉴权/网络失败"
ctyun-cli ecs statistics --region-id 200000001852

# 5. 需要原始响应时改用 JSON 输出核对
ctyun-cli <模块> <命令> --output json

--debug 关键日志样例：

代码

... - DEBUG - 请求URL: https://api.ctyun.cn/v4/ecs/list-instances
... - DEBUG - 请求头: {'eop-authorization': 'CtyunEOP***', ...}     # 认证头已脱敏
... - DEBUG - 响应状态码: 200
... - DEBUG - 响应内容: {"returnObj": {"currentCount": 0, "totalCount": 0, ...}, "statusCode": 800}

最后一行就是"结果为空"的真相：HTTP 200 + statusCode: 800 + 空数组，通常意味着 AK/SK 无效或该资源池无权访问，而不是"没有资源"。

反模式与常见问题 (FAQ)

反模式对照表

反模式	后果	正确做法
把 `--output json` 放在模块名之前	命令不认这个位置，输出仍是表格	命令自带该选项 → 放子命令之后；否则放模块之前（见快速开始）
直接把 CLI 输出喂给 `jq`	INFO 日志混进 stdout，`jq` 报 parse error	先剥日志行：`ctyun-cli ... \| sed -n '/^[[{]/,$p'`
结果为空就下"没有资源"的结论	鉴权失败被静默吞掉	换已知有资源的资源池复验 + `--debug` 看响应体
忽略 `⚠️ 当前显示的是模拟数据`	拿 mock 数据做统计/告警	看到该提示即判定本次结果无效
忽略数据里出现的 `测试VPC` / `vpc-test12345678`	VPC 在 401/403 时静默返回模拟数据	出现样例名称即判定本次结果无效
截断实例 ID/磁盘 ID 以便显示	后续命令无法使用	ID 保持完整（CLI 只截断镜像名称等长文本）
一次性拉全量再本地过滤	触发限流 / 只拿到部分数据	用服务端过滤参数 + 循环分页 + 校验 `totalCount`
假设分页参数都叫 `--page-size`	参数报错	各模块不统一，先 `--help`
混用 `--region` 与 `--region-id`	查不到数据	资源池 ID 用 `--region-id`，区域名用 `--region`
把 `todoapi/` 内部接口文档提交进仓库	内部资料外泄	保持在仓库外并加入 `.gitignore`
在脚本里硬编码 AK/SK	凭据泄露	用环境变量或 `--profile`
不看 `--help` 直接执行变更类命令	误改云资源	变更前先跑 `*-price` 询价并逐项核对参数
CDA 网关类查询传 `gatewayName`	`vrfName can not be null`	实际字段是 `vrfName`；VPC 查询用 `GET /v4/cda/vpc/list`
用 ECS/VPC/Security 的空结果做巡检结论	结论基于 mock 或空数据	必须同时校验"无 mock 提示"和 `totalCount`

FAQ

Q1. 输出到底是表格还是 JSON？A. 取决于命令实现。ecs list --output json 走的是命令自带的 --output 选项；cda qos list 没有这个选项，要用全局位置 ctyun-cli --output json cda qos list ...。不确定就 --help 看 Options。

Q2. 怎么知道一共能查到多少条？A. 表格首行写明"总计 N 条"，JSON 里是 totalCount。以 totalCount 为准，不要用 --page-size 当总数。

Q3. 怎么翻页？A. 表格末尾会提示"使用 –page 参数查看其他页"；JSON 用 totalCount 除以每页条数算页数循环拉取。

Q4. --debug 会泄露凭据吗？A. 不会，认证头已脱敏为 CtyunEOP***。但 debug 日志含资源 ID、请求体等业务信息，分享前请自行脱敏。

Q5. 缓存会让结果不新鲜吗？A. 只有 ECS 资源池列表走 24 小时本地缓存，其余命令每次实时请求。需要强制刷新就 ctyun-cli clear-cache。

Q6. 超时和重试能调吗？A. 能。编辑 ~/.ctyun/config 的 [default] 段：timeout（秒，默认 30）、retry（默认 3），改完用 show-config 复核。

Q7. 同一命令别人能跑、我这跑不出来？A. 大概率是三选一：AK/SK 权限不同、--region-id 不同、企业项目不同。用 iam list-projects --account-id <账号ID> 确认可见的企业项目。

Q8. test 能证明网络通吗？A. 不能。test 只校验配置读取与客户端初始化，不发真实 API 请求。网络与凭据是否可用，以任意一条真实查询命令的结果为准。

Q9. 能直接把结果喂给其他工具吗？A. 可以，但要剥掉 INFO 日志行：

BASH

ctyun-cli ecs list --region-id 200000001852 --page-size 5 --output json 2>/dev/null 
  | sed -n '/^[[{]/,$p' 
  | jq '.[].instanceID'

Q10. 可以用于生产环境的资源变更吗？A. 可以执行，但请遵守：先询价、再 --help 核对参数、先在测试资源池验证、变更后立刻复查。变更类命令没有 dry-run 与回滚开关。

安装

使用 pip 安装（推荐）

BASH

pip install ctyun-cli

使用 pipx 安装（隔离环境）

BASH

pipx install ctyun-cli

从源码安装

BASH

git clone https://github.com/fengyucn/ctyun-cli.git
cd ctyun-cli
pip install -e .

验证安装

BASH

ctyun-cli --help          # 查看全部模块分组与全局选项
pip show ctyun-cli       # 查看已安装版本（CLI 未提供 --version 选项）

配置与认证

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

BASH

export CTYUN_ACCESS_KEY=your_access_key
export CTYUN_SECRET_KEY=your_secret_key

将上述命令添加到 ~/.bashrc 或 ~/.zshrc 以实现永久配置。

方式二：交互式配置

BASH

ctyun-cli configure --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY --region cn-north-1

查看当前配置

BASH

ctyun-cli show-config

列出所有配置文件

BASH

ctyun-cli list-profiles

测试 API 连接

BASH

ctyun-cli test

全局选项

所有命令都支持以下全局选项：

--profile TEXT: 指定配置文件名称
--access-key TEXT: 访问密钥
--secret-key TEXT: 密钥
--region TEXT: 区域
--endpoint TEXT: API 端点
--output [table|json|yaml]: 输出格式（默认 table）
--debug: 启用调试模式

云服务器 (ECS) 管理

列出云主机实例

BASH

ctyun-cli ecs list
ctyun-cli ecs list --region cn-north-1 --output json

查询云主机详情

BASH

ctyun-cli ecs detail --instance-id YOUR_INSTANCE_ID

查询多台云主机详细信息

BASH

ctyun-cli ecs multidetail --instance-ids ID1,ID2,ID3

查询云主机统计信息

BASH

ctyun-cli ecs statistics

查询资源池列表

BASH

ctyun-cli ecs regions

订单询价

BASH

ctyun-cli ecs query-price --flavor-id FLAVOR_ID --quantity 1

资源续订询价

BASH

ctyun-cli ecs renew-price --region-id REGION_ID --resource-type VM --resource-uuid RESOURCE_UUID --cycle-type MONTH --cycle-count 1

虚拟私有云 (VPC) 管理

终端节点 ctvpc-global.ctapi.ctyun.cn。共 96 个命令，覆盖 VPC/子网/路由表/安全组/EIP/NAT/SNAT/DNAT/网卡/对等连接/流日志/共享带宽/共享流量包/终端节点/内网DNS/网络ACL/前缀列表/流量控制/GWLB/L2GW/HaVip/网络诊断/DHCP-VPC绑定/IPv6/IPv4网关/标签。

VPC 与子网

BASH

ctyun-cli vpc list                              # 查询VPC列表
ctyun-cli vpc new-list                          # 新查询VPC列表（支持游标分页）
ctyun-cli vpc show --vpc-id VPC_ID              # 查询VPC详情
ctyun-cli vpc subnet list                       # 子网列表
ctyun-cli vpc subnet new-list                   # 新查询子网列表
ctyun-cli vpc subnet show --subnet-id SUBNET_ID # 子网详情
ctyun-cli vpc subnet used-ips --subnet-id SUBNET_ID  # 子网已使用IP

路由表

BASH

ctyun-cli vpc route-table list                                  # 路由表列表
ctyun-cli vpc route-table new-list                              # 新查询路由表列表
ctyun-cli vpc route-table rules --route-table-id RTB_ID         # 路由表规则列表
ctyun-cli vpc route-table new-rules --route-table-id RTB_ID     # 新查询路由表规则列表

安全组

BASH

ctyun-cli vpc security-group list                                # 安全组列表
ctyun-cli vpc security-group new-query                           # 新查询安全组列表
ctyun-cli vpc security-group show --security-group-id SG_ID      # 安全组详情（含规则）
ctyun-cli vpc security-group rules                               # 获取安全组规则列表
ctyun-cli vpc security-group vms --security-group-id SG_ID       # 获取安全组绑定机器列表

弹性公网 IP EIP（9 个命令）

BASH

ctyun-cli vpc eip list                                  # EIP列表
ctyun-cli vpc eip detail --eip-id EIP_ID                # EIP详情
ctyun-cli vpc eip shared-bandwidths                     # 共享带宽列表（旧）
ctyun-cli vpc eip realtime-monitor                      # EIP实时监控（旧版）
ctyun-cli vpc eip new-realtime-monitor                  # EIP实时监控（新版）
ctyun-cli vpc eip history-monitor --device-ids IP1,IP2 --metric-names ingress_throughput --start-time '2026-07-22 00:00:00' --end-time '2026-07-23 00:00:00'
ctyun-cli vpc eip new-history-monitor                   # EIP历史监控（新版）
ctyun-cli vpc eip filing-status --eip-id EIP_ID         # 端口备案状态
ctyun-cli vpc eip check-address --eip-address 1.1.1.1   # 检查EIP是否可用

共享带宽 / 共享流量包

BASH

ctyun-cli vpc bandwidth show --bandwidth-id BW_ID       # 共享带宽详情
ctyun-cli vpc bandwidth new-list                        # 新查询共享带宽列表
ctyun-cli vpc flow-package list                         # 共享流量包列表
ctyun-cli vpc flow-package show --sdp-id SDP_ID         # 共享流量包详情
ctyun-cli vpc flow-package metric --sdp-id SDP_ID --start-time '...' --end-time '...'  # 流量包监控

NAT 网关 / SNAT / DNAT

BASH

ctyun-cli vpc nat-gateway list                          # NAT网关列表
ctyun-cli vpc nat-gateway show --nat-gateway-id NAT_ID  # NAT网关详情
ctyun-cli vpc nat-gateway snat list                     # SNAT规则列表
ctyun-cli vpc nat-gateway snat show --snat-id SNAT_ID   # SNAT规则详情
ctyun-cli vpc nat-gateway dnat list --nat-gateway-id NAT_ID      # DNAT规则列表
ctyun-cli vpc nat-gateway dnat show --nat-gateway-id NAT_ID --dnat-id DNAT_ID  # DNAT规则详情

网卡

BASH

ctyun-cli vpc port list                # 网卡列表
ctyun-cli vpc port new-list            # 新查询网卡列表

对等连接与流日志

BASH

ctyun-cli vpc peering list                              # 对等连接列表
ctyun-cli vpc peering show --peering-connection-id P_ID # 对等连接详情
ctyun-cli vpc flow-log list                             # 流日志列表

VPC 终端节点（VPCE）

BASH

ctyun-cli vpc vpce list                                 # 终端节点列表
ctyun-cli vpc vpce new-list                             # 新查看终端节点列表
ctyun-cli vpc vpce service list                         # 终端节点服务列表
ctyun-cli vpc vpce service new-list                     # 新查看终端节点服务列表
ctyun-cli vpc vpce service backends --endpoint-service-id EPS_ID  # 终端节点服务后端列表

内网 DNS

BASH

ctyun-cli vpc dns list                                  # 内网DNS列表
ctyun-cli vpc dns new-list                              # 新内网DNS列表
ctyun-cli vpc dns record list                           # DNS记录列表
ctyun-cli vpc dns record new-list                       # 新DNS记录列表

网络 ACL

BASH

ctyun-cli vpc acl list                          # ACL列表（旧）
ctyun-cli vpc acl new-list                      # 新ACL列表
ctyun-cli vpc acl rules --acl-id ACL_ID         # ACL规则列表

前缀列表

BASH

ctyun-cli vpc prefix-list list                          # 前缀列表
ctyun-cli vpc prefix-list show --prefix-list-id PL_ID   # 前缀列表详情
ctyun-cli vpc prefix-list associations --prefix-list-id PL_ID  # 关联资源

流量控制（镜像流）

BASH

ctyun-cli vpc flow filters                                    # 过滤条件列表
ctyun-cli vpc flow filter-rules --mirror-filter-id MF_ID --direction in  # 过滤规则列表
ctyun-cli vpc flow sessions                                   # 流量会话列表

网关负载均衡 GWLB

BASH

ctyun-cli vpc gwlb list                                # GWLB 列表
ctyun-cli vpc gwlb ip-listener-list                    # IP监听器列表

二层网关 L2GW

BASH

ctyun-cli vpc l2gw list                                # L2GW 列表
ctyun-cli vpc l2gw connection-list                     # L2GW connection 列表

高可用虚拟 IP HaVip

BASH

ctyun-cli vpc havip list                               # HaVip 列表（自动生成 clientToken）
ctyun-cli vpc havip list --filter vpcID=vpc-xxx        # 按 vpcID 筛选（支持多次 --filter）

网络诊断 VNIA

BASH

ctyun-cli vpc diagnose instances                      # 实例诊断列表（支持按 resourceID/type 过滤）
ctyun-cli vpc diagnose records                        # 实例诊断记录列表
ctyun-cli vpc diagnose paths                          # 网络路径列表
ctyun-cli vpc diagnose analyses --network-path-id NP_ID  # 网络路径分析列表
ctyun-cli vpc diagnose reports --analysis-id NPA_ID   # 网络路径分析报告列表

DHCP 与 VPC 绑定关系

BASH

ctyun-cli vpc dhcp bound-vpcs --dhcp-option-sets-id DHCP_ID    # DHCP 已绑定的 VPC 列表
ctyun-cli vpc dhcp unbound-vpcs                                # 未绑定 DHCP 的 VPC 列表
ctyun-cli vpc dns vpcs --zone-id ZONE_ID                       # zone 绑定的 VPC 列表

IPv6 网关 / 地址 / 带宽

BASH

ctyun-cli vpc ipv6 gateways                          # IPv6 网关列表
ctyun-cli vpc ipv6 list                              # IPv6 地址列表
ctyun-cli vpc ipv6 new-list                          # 新查询 IPv6 地址列表
ctyun-cli vpc ipv6 bw-list                           # IPv6 带宽列表
ctyun-cli vpc ipv6 bw-new-list                       # 新查询 IPv6 带宽列表

IPv4 网关

BASH

ctyun-cli vpc ipv4-gw list                           # IPv4 网关列表

标签查询（7个）

BASH

ctyun-cli vpc label-query-resources                  # 根据标签获取资源列表
ctyun-cli vpc label-query-by-resource --resource-type TYPE --resource-id ID
ctyun-cli vpc label-vpc-peer --vpc-peer-id PEER_ID
ctyun-cli vpc label-vpce-endpoint --endpoint-id EP_ID
ctyun-cli vpc label-vpce-service --endpoint-service-id EPS_ID
ctyun-cli vpc label-private-dns --zone-id ZONE_ID

云硬盘 (EBS) 管理

终端节点 ebs-global.ctapi.ctyun.cn。共 7 个查询命令。

云硬盘查询

BASH

ctyun-cli ebs list                                    # 云硬盘列表
ctyun-cli ebs info --disk-id DISK_ID                  # 云硬盘详情（基于diskID）
ctyun-cli ebs info-by-name --disk-name NAME           # 云硬盘详情（基于名称）
ctyun-cli ebs list-by-name --disk-name NAME           # 云硬盘列表（基于名称）

快照查询

BASH

ctyun-cli ebs snapshots                               # 快照列表（支持多种过滤）
ctyun-cli ebs snapshot-size                           # 快照使用量
ctyun-cli ebs snapshot-policy                         # 自动快照策略

弹性负载均衡 (ELB) 管理

负载均衡器管理

BASH

ctyun-cli elb loadbalancer --help
ctyun-cli elb loadbalancer list

监听器管理

BASH

ctyun-cli elb listener list --region-id REGION_ID
ctyun-cli elb listener get --region-id REGION_ID --listener-id LISTENER_ID
# 停止监听器（--client-token 可选，用于幂等）
ctyun-cli elb listener stop --region-id REGION_ID --listener-id LISTENER_ID [--client-token TOKEN]

目标组管理

BASH

ctyun-cli elb targetgroup --help

健康检查管理

BASH

ctyun-cli elb health-check --help

监控数据管理

BASH

ctyun-cli elb monitor --help

保障型负载均衡询价

BASH

# 创建询价
ctyun-cli elb pgelb-create-price --region-id REGION_ID --subnet-id SUBNET_ID --name my-elb --sla-name elb.s2.small --resource-type internal --cycle-type month --cycle-count 1

# 续订询价
ctyun-cli elb pgelb-renew-price --region-id REGION_ID --elb-id ELB_ID --cycle-type month --cycle-count 1

# 变配询价
ctyun-cli elb pgelb-modify-price --region-id REGION_ID --elb-id ELB_ID --sla-name elb.s3.small

ELB 查询类 API（19个）

BASH

# 访问控制策略组（地址组，供监听器黑白名单引用）
ctyun-cli elb list-access-controls --region-id REGION_ID
ctyun-cli elb show-access-control --region-id REGION_ID --access-control-id AC_ID
ctyun-cli elb create-access-control --region-id REGION_ID --name my-acl 
  --source-ips 10.0.0.1/32,192.168.0.0/24 [--description 描述]
ctyun-cli elb update-access-control --region-id REGION_ID --access-control-id AC_ID 
  --source-ips 10.0.0.2/32,10.0.0.3/32   # 单次最多10条；也可 --name/--description
ctyun-cli elb delete-access-control --region-id REGION_ID --access-control-id AC_ID
# clientToken 不传自动生成 uuid4（幂等）

# 规格/证书
ctyun-cli elb list-sla --region-id REGION_ID
ctyun-cli elb list-certificates --region-id REGION_ID
ctyun-cli elb show-certificate --region-id REGION_ID --certificate-id CERT_ID
ctyun-cli elb list-domain-cert-links --region-id REGION_ID

# 转发规则/健康检查
ctyun-cli elb list-rules --region-id REGION_ID --listener-id LISTENER_ID
ctyun-cli elb show-rule --region-id REGION_ID --policy-id POLICY_ID
ctyun-cli elb list-health-checks --region-id REGION_ID

# 旧版监控
ctyun-cli elb legacy-history-monitor --region-id REGION_ID --device-ids '["ID"]' --metric-names '["metric"]' --start-time 2026-07-01 --end-time 2026-07-17
ctyun-cli elb legacy-realtime-monitor --region-id REGION_ID

# GWLB 网关负载均衡
ctyun-cli elb list-gwlb --region-id REGION_ID
ctyun-cli elb show-gwlb --region-id REGION_ID --gwlb-id GWLB_ID
ctyun-cli elb gwlb-list-targets --region-id REGION_ID
ctyun-cli elb gwlb-show-target --region-id REGION_ID
ctyun-cli elb gwlb-list-target-groups --region-id REGION_ID
ctyun-cli elb gwlb-show-target-group --region-id REGION_ID

# IP 监听器
ctyun-cli elb list-ip-listeners --region-id REGION_ID
ctyun-cli elb show-ip-listener --region-id REGION_ID

# 标签
ctyun-cli elb list-labels --region-id REGION_ID --elb-id ELB_ID

容器引擎 (CCE) 管理

列出集群

BASH

ctyun-cli cce list-clusters

查询集群详情

BASH

ctyun-cli cce describe-cluster --cluster-id YOUR_CLUSTER_ID

获取 Kubeconfig

BASH

ctyun-cli cce get-kubeconfig --cluster-id YOUR_CLUSTER_ID

列出节点

BASH

ctyun-cli cce list-nodes --cluster-id YOUR_CLUSTER_ID

查询节点详情

BASH

ctyun-cli cce get-node-detail --cluster-id CLUSTER_ID --node-id NODE_ID

列出 Pod

BASH

ctyun-cli cce list-pods --cluster-id CLUSTER_ID

列出 Deployment

BASH

ctyun-cli cce list-deployments --cluster-id CLUSTER_ID

列出 Service

BASH

ctyun-cli cce list-services --cluster-id CLUSTER_ID

集群日志管理

BASH

ctyun-cli cce logs --help

节点池管理

BASH

ctyun-cli cce nodepool --help

弹性伸缩管理

BASH

ctyun-cli cce autoscaling --help

ConfigMap 管理

BASH

ctyun-cli cce configmap --help

标签管理

BASH

ctyun-cli cce tag --help

Namespace 命名空间管理

BASH

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

BASH

ctyun-cli redis list

查询实例详情

BASH

ctyun-cli redis describe --instance-id YOUR_INSTANCE_ID
ctyun-cli redis describe -i YOUR_INSTANCE_ID -f table

查询实例网络信息

BASH

ctyun-cli redis network --instance-id YOUR_INSTANCE_ID
ctyun-cli redis network -i YOUR_INSTANCE_ID --region-id RESOURCE_POOL_ID

查询实例逻辑拓扑

BASH

ctyun-cli redis topology --instance-id YOUR_INSTANCE_ID

批量查询集群节点信息

BASH

ctyun-cli redis cluster-nodes
ctyun-cli redis cluster-nodes --page 1 --size 20

创建 Redis 实例

BASH

ctyun-cli redis create-instance --help

查询可用区

BASH

ctyun-cli redis zones

查询引擎版本

BASH

ctyun-cli redis engine-version --instance-id INSTANCE_ID
ctyun-cli redis instance-version --instance-id INSTANCE_ID

监控数据查询

BASH

ctyun-cli redis monitor-history --instance-id INSTANCE_ID

诊断服务

BASH

ctyun-cli redis diagnose --instance-id INSTANCE_ID

客户端连接管理

BASH

ctyun-cli redis clients --instance-id INSTANCE_ID

节点列表查询

BASH

ctyun-cli redis node-list --prod-inst-id INSTANCE_ID --region-id REGION_ID

日志下载

BASH

ctyun-cli redis log-download --prod-inst-id INSTANCE_ID --node-name NODE_NAME --date 2026-06-23

副本状态查询

BASH

ctyun-cli redis replication-state --prod-inst-id INSTANCE_ID --fragment-name redis-0

租户标签查询

BASH

ctyun-cli redis labels --region-id REGION_ID
ctyun-cli redis labels -r REGION_ID --label-key APPNAME

运行日志查询

BASH

ctyun-cli redis running-logs --prod-inst-id INSTANCE_ID --node-name NODE_NAME

实例账号查询

BASH

ctyun-cli redis accounts --prod-inst-id INSTANCE_ID

费用查询（询价）

BASH

# 订购询价
ctyun-cli redis price --order-type BUY --charge-type PrePaid --period 1 --edition DirectCluster --shard-mem-size 1 --shard-count 3 --engine-version 6.0 --capacity 3

# 变配询价
ctyun-cli redis price --order-type EXPANSION --prod-inst-id INSTANCE_ID

Redis 查询类 API 扩展（52+ 个）

实例生命周期与统计

BASH

# 回收站实例
ctyun-cli redis recycle-bin --region-id REGION_ID
ctyun-cli redis running-statistics --region-id REGION_ID
ctyun-cli redis quota --region-id REGION_ID
ctyun-cli redis dedicated-cluster-instances --region-id REGION_ID
ctyun-cli redis export-task --task-id TASK_ID --region-id REGION_ID
ctyun-cli redis auto-renew -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis can-expand -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis maintain-time -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis maintain-az -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis port-modify-range -i INSTANCE_ID --region-id REGION_ID

备份恢复

BASH

ctyun-cli redis backups -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis backup-tasks -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis backup-policy -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis backup-download-url -i INSTANCE_ID --restore-name BACKUP_NAME --ip-type publicIp --region-id REGION_ID
ctyun-cli redis data-flashback -i INSTANCE_ID --region-id REGION_ID

安全与 SSL

BASH

ctyun-cli redis ssl -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis security-ips -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis rename-command -i INSTANCE_ID --region-id REGION_ID

命令与日志监控

BASH

ctyun-cli redis slow-log -i INSTANCE_ID --node-name NODE_NAME --region-id REGION_ID
ctyun-cli redis slow-log-history -i INSTANCE_ID --node-name NODE_NAME --start-time '2026-07-20 08:00:00' --end-time '2026-07-20 10:00:00' --region-id REGION_ID
ctyun-cli redis command-audit-status -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis monitor-items-v2 -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis node-monitor-values -i INSTANCE_ID --type string --node-name NODE_NAME --start-time '...' --end-time '...' --region-id REGION_ID
ctyun-cli redis node-command-list -i INSTANCE_ID --node-name NODE_NAME --start-time '...' --end-time '...' --region-id REGION_ID
ctyun-cli redis node-command-monitor -i INSTANCE_ID --node-name NODE_NAME --start-time '...' --end-time '...' --type redis_latency_insight_max --region-id REGION_ID
ctyun-cli redis hit-rate -i INSTANCE_ID --node-name NODE_NAME --region-id REGION_ID

会话与客户端

BASH

ctyun-cli redis client-map -i INSTANCE_ID --node-name NODE_NAME --region-id REGION_ID

参数与模板管理

BASH

ctyun-cli redis instance-config-v3 -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis param-history -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis templates --type sys --region-id REGION_ID
ctyun-cli redis templates --type custom --region-id REGION_ID
ctyun-cli redis template-detail --template-id TEMPLATE_ID --region-id REGION_ID

Key 管理与分析

BASH

ctyun-cli redis dbkey-count -i INSTANCE_ID --groups 1 --region-id REGION_ID
ctyun-cli redis auto-scan-conf -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis scan-logs -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis eviction-strategy -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis big-and-hot-keys -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis big-hot-key-history -i INSTANCE_ID --node-name NODE_NAME --start-time '...' --end-time '...' --region-id REGION_ID

大key/热key 分析工具

BASH

ctyun-cli redis big-key-tasks -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis hot-key-tasks -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis big-key-policy -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis hot-key-policy -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis key-task-record -i INSTANCE_ID --task-id TASK_ID --region-id REGION_ID
ctyun-cli redis diagnosis-tasks -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis offline-key-analysis-list -i INSTANCE_ID --region-id REGION_ID
ctyun-cli redis offline-key-analysis-info -i INSTANCE_ID --task-id TASK_ID --region-id REGION_ID

数据迁移与任务中心

BASH

ctyun-cli redis transfer-tasks --page-num 1 --page-size 10 --region-id REGION_ID
ctyun-cli redis transfer-task-info --task-id TASK_ID --region-id REGION_ID
ctyun-cli redis transfer-progress --task-id TASK_ID --region-id REGION_ID
ctyun-cli redis transfer-running-log --task-id TASK_ID --search-date 2026-07-20 --region-id REGION_ID
ctyun-cli redis task-center-list --start-time 20260701 --end-time 20260720 --status -1 --region-id REGION_ID
ctyun-cli redis task-center-info --task-id TASK_ID --region-id REGION_ID

混沌工程故障查询

BASH

ctyun-cli redis experiments -i INSTANCE_ID --region-id REGION_ID

云监控服务管理

查询监控数据

BASH

ctyun-cli monitor list

查询告警规则

BASH

ctyun-cli monitor query-alarm-rules

查询告警历史

BASH

ctyun-cli monitor query-alert-history

查询资源组

BASH

ctyun-cli monitor query-resource-groups

自定义监控指标查询

BASH

ctyun-cli monitor query-custom-trend

CPU Top 排名

BASH

ctyun-cli monitor cpu-top

内存 Top 排名

BASH

ctyun-cli monitor mem-top

磁盘 Top 排名

BASH

ctyun-cli monitor disk-top

数据订阅管理

BASH

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

通知套餐管理

BASH

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

监控看板

BASH

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

监控对象资源列表

BASH

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

设备类型监控项查询

BASH

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

数据导出任务管理

BASH

# 查询数据导出任务列表
ctyun-cli monitor data-export-tasks --region-id REGION_ID

# 创建数据导出任务
ctyun-cli monitor create-data-export-task --region-id REGION_ID --task-name my-task

# 删除数据导出任务
ctyun-cli monitor delete-data-export-task --region-id REGION_ID --task-ids TASK_ID1,TASK_ID2

# 下载导出文件
ctyun-cli monitor download-data-export-task --region-id REGION_ID --task-id TASK_ID

拨测管理

BASH

# 查询拨测点列表
ctyun-cli monitor query-detection-point

# 查询即时拨测任务结果
ctyun-cli monitor query-instant-detection-task --task-id TASK_ID --detect-type http

账务中心管理

消费类型汇总

BASH

ctyun-cli billing bill-summary 202606

账户账单（按账户ID）

BASH

ctyun-cli billing account-bill 202606 --account-id ACCOUNT_ID

账单详情（按账单ID）

BASH

ctyun-cli billing bill-detail BILL_ID

包周期流水账单

BASH

ctyun-cli billing cycle-flow 202606 --page-size 10

包周期订单账单详情

BASH

ctyun-cli billing cycle-bill 202606 --page-size 10

包周期账单明细（按产品汇总）

BASH

ctyun-cli billing cycle-product 202606

按需流水账单

BASH

ctyun-cli billing ondemand-flow 202606 --page-size 10

按需账单明细（按产品汇总）

BASH

ctyun-cli billing ondemand-product 202606

按需账单明细（资源+明细）

BASH

ctyun-cli billing bill-list 202606 --page-size 10

按需账单明细（资源+账期）

BASH

ctyun-cli billing ondemand-resource-cycle 202606

按需账单明细（使用量类型+账期）

BASH

ctyun-cli billing ondemand-usage 202606

按需账单明细（使用量类型+明细）

BASH

ctyun-cli billing ondemand-detail 202606

新版账单详情（包周期 + 按需合并查询）

终端节点 acct-global.ctapi.ctyun.cn，接口前缀 /acct/acct-openapi/，共 5 个命令。

BASH

# 产品按账期/按天账单（queryProductCycleBill）
ctyun-cli billing product-cycle-v2 202508 --page-size 10
ctyun-cli billing product-cycle-v2 202508 --group-by-day 1

# 资源明细账单（queryResourceDetailBill）
ctyun-cli billing resource-detail-v2 202508 --page-size 10

# 资源按账期/按天账单（queryResourceCycleBill）
ctyun-cli billing resource-cycle-v2 202508 --group-by-day 1

# 使用量明细账单（queryUsageDetailBill）
ctyun-cli billing usage-detail-v2 202508 --product-code PRODUCT_CODE

# 使用量按账期/按天账单（queryUsageCycleBill）
ctyun-cli billing usage-cycle-v2 202508 --group-by-day 1 --bill-mode 2

通用选项（resource-detail-v2 / usage-detail-v2 不支持 --group-by-day）：

选项	说明
`--page` / `--page-size`	分页，默认 1 / 10
`--bill-mode 1\|2`	计费模式：1-包周期，2-按需
`--bill-type N`	账单类型：7-按需，其他-包周期
`--contract-id` / `--project-id`	合同 ID / 企业项目 ID
`--product-code` / `--resource-id`	产品编码 / 资源 ID 过滤
`--pay-method`	支付方式
`--offset`	偏移量（仅按需有效）
`--group-by-day 0\|1`	0-按账期，1-按天（仅 3 个 cycle 类命令）
`--is-zero-filter`	过滤应付金额为 0 的账单

响应兼容 statusCode/msg/returnObj 与 success/errorCode/result 两种结构；表格金额统一保留两位小数。

统一身份认证 (IAM) 管理

查询企业项目列表

BASH

ctyun-cli iam list-projects

查询企业项目详情

BASH

ctyun-cli iam get-project --project-id PROJECT_ID

分页查询资源信息

BASH

ctyun-cli iam list-resources

服务器安全卫士

查看使用示例

BASH

ctyun-cli security examples

主机防护

BASH

ctyun-cli security scan --help        # 主机防护扫描
ctyun-cli security summary --help     # 防护概览
ctyun-cli security vuln-list --help   # 漏洞列表
ctyun-cli security vuln-detail --help # 漏洞详情

防篡改更新

BASH

ctyun-cli security tamper-update --help

服务器安全卫士（原生版）

服务器管理

BASH

# 服务器列表
ctyun-cli csscn list --size 20

# 服务器详情
ctyun-cli csscn describe --agent-guid AGENT_GUID

安全总览统计

BASH

# 待处理风险统计
ctyun-cli csscn risk-stats

# 服务器统计
ctyun-cli csscn server-stats

# Agent防护状态统计
ctyun-cli csscn agent-stats

# Agent在线/离线分布
ctyun-cli csscn agent-distribution

# 漏洞统计
ctyun-cli csscn vuln-stats

安全事件查询

BASH

# 告警列表
ctyun-cli csscn alarms --time-type LAST_ONE_WEEK --severity 3

# 病毒事件列表
ctyun-cli csscn viruses --os-type 3 --time-type LAST_ONE_MONTH

配额管理

BASH

ctyun-cli csscn quotas --version 3 --size 20

关系数据库MySQL版 (RDS)

查询实例列表

BASH

ctyun-cli ctmysql list --region-id REGION_ID --page-size 10
ctyun-cli ctmysql list --region-id REGION_ID --engine 8.0 --name mysql-prod

实例标签管理

BASH

# 绑定标签
ctyun-cli ctmysql batch-label --region-id REGION_ID --action bind --instance-ids ID1,ID2 --label env=prod

# 解绑标签
ctyun-cli ctmysql batch-label --region-id REGION_ID --action unbind --instance-ids ID1 --label env=prod

监控数据查询

BASH

ctyun-cli ctmysql batch-monitor --region-id REGION_ID --instance-ids ID1,ID2 --metric mysql_monitor_tcp_states --period 60 --last-hours 1

询价

BASH

# 新建实例询价
ctyun-cli ctmysql inquiry --region-id REGION_ID --project-id 0 --bill-mode 1 --prod-version 5.7 --host-type S7 --period 1 --count 1 --auto-renew 0 --prod-id 10001003 --node-type master --inst-spec 1 --storage-type SATA --storage-space 100 --perf-spec 2C4G --az-name AZ_NAME

# 变更实例询价（磁盘扩容）
ctyun-cli ctmysql inquiry-upgrade --region-id REGION_ID --project-id 0 --inst-id INSTANCE_ID --disk-volume 200 --node-type master

# 续费询价
ctyun-cli ctmysql inquiry-renew --region-id REGION_ID --inst-id INSTANCE_ID --month 1

云专线 (CDA) 管理

物理专线管理

BASH

ctyun-cli cda physical-line --help

专线网关管理

BASH

ctyun-cli cda gateway --help

VPC 管理

BASH

ctyun-cli cda vpc --help

BGP 路由管理

BASH

ctyun-cli cda bgp-route --help

静态路由管理

BASH

ctyun-cli cda static-route --help

QOS 管理

BASH

# 物理专线关联的 QOS
ctyun-cli cda qos list --region-id REGION_ID --line-id LINE_ID

# QOS 策略（可按策略ID过滤）
ctyun-cli cda qos policy list --region-id REGION_ID --line-id LINE_ID
ctyun-cli cda qos policy list --region-id REGION_ID --line-id LINE_ID --policy-id POLICY_ID

# QOS 规则（可按规则ID/是否在用过滤）
ctyun-cli cda qos rule list --region-id REGION_ID --line-id LINE_ID
ctyun-cli cda qos rule list --region-id REGION_ID --line-id LINE_ID --in-use

网关类查询的 gatewayName 在实际接口中以 vrfName 字段传递；VPC 查询使用 GET /v4/cda/vpc/list。

健康检查和链路探测管理

BASH

ctyun-cli cda health-check --help

跨账号授权管理

BASH

ctyun-cli cda account-auth --help

分布式消息服务 (Kafka) 管理

查询实例列表

BASH

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

查看实例节点状态

BASH

ctyun-cli kafka node-status --region-id RESOURCE_POOL_ID --instance-id INSTANCE_ID

查询弹性IP列表

BASH

ctyun-cli kafka floating-ips --region-id RESOURCE_POOL_ID

获取实例配置

BASH

ctyun-cli kafka config --region-id RESOURCE_POOL_ID --instance-id INSTANCE_ID

云搜索服务 (CSS) 管理

查询实例列表

BASH

ctyun-cli css list --region-id RESOURCE_POOL_ID --type 1
ctyun-cli css list -r xxx --name test

查询实例详情

BASH

ctyun-cli css describe --cluster-id CLUSTER_ID

查询 Logstash 实例列表

BASH

ctyun-cli css logstash-list --region-id RESOURCE_POOL_ID

翼 MapReduce (EMR) 管理

查询集群列表

BASH

ctyun-cli emr list --region-id RESOURCE_POOL_ID
ctyun-cli emr list -r xxx --name test --v2

查询集群详情

BASH

ctyun-cli emr describe --cluster-id CLUSTER_ID
ctyun-cli emr describe --cluster-id CLUSTER_ID --v2

查询节点组信息

BASH

ctyun-cli emr node-groups --cluster-id CLUSTER_ID
ctyun-cli emr node-groups --cluster-id CLUSTER_ID --v2

查询节点组详情

BASH

ctyun-cli emr node-detail --cluster-id CLUSTER_ID
ctyun-cli emr node-detail --cluster-id CLUSTER_ID --node-state 8

查询 Hive 元数据概览

BASH

ctyun-cli emr meta-overview --cluster-id CLUSTER_ID

查询 Hive 表元数据

BASH

ctyun-cli emr meta-table --cluster-id CLUSTER_ID --database test_db --table test_table

云日志服务 (LTS) 管理

共 171 个命令，覆盖日志项目/单元、主机组、采集配置、检索、转储、加工、告警、仪表盘。

v1 检索接口

BASH

# 日志单元列表（GET /v1/unit/list）
ctyun-cli lts unit list-v1 --region-id REGION_ID --project-code PROJECT_CODE

# 查询单元索引信息（GET /v1/index/getIndex）
ctyun-cli lts unit get-index-v1 --region-id REGION_ID --project-code PROJECT_CODE --unit-code UNIT_CODE

# 日志检索（POST /v1/content/getLogs）
ctyun-cli lts search logs-v1 --region-id REGION_ID --project-code PROJECT_CODE --unit-code UNIT_CODE 
  --query 'status:200' --hours 1 --limit 100
ctyun-cli lts search logs-v1 --region-id REGION_ID --project-code PROJECT_CODE --unit-code UNIT_CODE 
  --query '* | select count(*) from log' --start-time 1750000000 --end-time 1750003600

v1 接口成功码为 0（非 800），支持游标翻页（--cursor + --search-type）。

弹性文件服务 (SFS) 管理

BASH

ctyun-cli sfs --help

海量文件服务 (OceanFS) 管理

BASH

ctyun-cli oceanfs --help
ctyun-cli oceanfs renew-price --region-id REGION_ID --sfs-uid FS_ID --cycle-type month --cycle-cnt 1
ctyun-cli oceanfs upgrade-price --region-id REGION_ID --sfs-uid FS_ID --sfs-size 100

对象存储 (ZOS) 管理

桶管理查询

BASH

# 查询所有桶
ctyun-cli zos list-buckets --region-id REGION_ID

# 桶信息/位置/统计
ctyun-cli zos get-bucket-info --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-location --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-statistics --region-id REGION_ID --bucket BUCKET

# 桶配置查询
ctyun-cli zos get-bucket-acl --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-encryption --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-lifecycle --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-logging --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-policy --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-versioning --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-bucket-tagging --region-id REGION_ID --bucket BUCKET
ctyun-cli zos head-bucket --region-id REGION_ID --bucket BUCKET

对象管理查询

BASH

# 对象列表/版本/分段
ctyun-cli zos list-objects --region-id REGION_ID --bucket BUCKET
ctyun-cli zos list-object-versions --region-id REGION_ID --bucket BUCKET
ctyun-cli zos list-multipart-uploads --region-id REGION_ID --bucket BUCKET
ctyun-cli zos list-all-parts --region-id REGION_ID --bucket BUCKET
ctyun-cli zos list-parts --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY --upload-id UPLOAD_ID

# 对象详情/ACL/标签
ctyun-cli zos head-object --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY
ctyun-cli zos get-object-acl --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY
ctyun-cli zos get-object-tagging --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY
ctyun-cli zos get-object-retention --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY

# 碎片/数量
ctyun-cli zos get-fragment-num --region-id REGION_ID --bucket BUCKET
ctyun-cli zos get-object-num --region-id REGION_ID --bucket BUCKET

IAM/资源/服务管理

BASH

ctyun-cli zos get-keys --region-id REGION_ID
ctyun-cli zos get-endpoint --region-id REGION_ID
ctyun-cli zos list-regions --region-id REGION_ID
ctyun-cli zos get-service-status --region-id REGION_ID
ctyun-cli zos list-policies --region-id REGION_ID
ctyun-cli zos get-policy-detail --region-id REGION_ID --policy-id POLICY_ID
ctyun-cli zos list-roles --region-id REGION_ID
ctyun-cli zos get-role-detail --region-id REGION_ID --role-id ROLE_ID
ctyun-cli zos get-user-event-bridge --region-id REGION_ID
ctyun-cli zos get-object-lock-conf --region-id REGION_ID --bucket BUCKET

标签管理

BASH

# 设置/查询/删除桶标签
ctyun-cli zos put-bucket-tagging --region-id REGION_ID --bucket BUCKET --tag key1=value1 --tag key2=value2
ctyun-cli zos get-bucket-tagging --region-id REGION_ID --bucket BUCKET
ctyun-cli zos delete-bucket-tagging --region-id REGION_ID --bucket BUCKET

# 设置/查询/删除对象标签
ctyun-cli zos put-object-tagging --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY --tag env=prod
ctyun-cli zos get-object-tagging --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY
ctyun-cli zos delete-object-tagging --region-id REGION_ID --bucket BUCKET --key OBJECT_KEY

询价

BASH

ctyun-cli zos query-price --region-id REGION_ID --pkg-type zosSize --pkg-spec-type ...

应用性能监控 (APM) 管理

终端节点 arms-global.ctapi.ctyun.cn，regionId 通过 header 传递。共 44 个查询类命令，分 8 个子组。

基础配置与元数据

BASH

ctyun-cli apm meta project-metadata --region-id REGION_ID
ctyun-cli apm meta env-types --region-id REGION_ID
ctyun-cli apm meta envs --region-id REGION_ID
ctyun-cli apm meta app-conf --region-id REGION_ID --service-name APP --project-code PROJ --deployment ENV
ctyun-cli apm meta license-key --region-id REGION_ID
ctyun-cli apm meta monitor-status --region-id REGION_ID --environment-code ENV_CODE
ctyun-cli apm meta default-jobs --region-id REGION_ID --environment-code ENV_CODE
ctyun-cli apm meta common-labels --region-id REGION_ID --environment-code ENV_CODE

应用与实例管理

BASH

ctyun-cli apm app list --region-id REGION_ID
ctyun-cli apm app transaction-types --region-id REGION_ID
ctyun-cli apm app agents --region-id REGION_ID --agent-status 1
ctyun-cli apm app env-instances --region-id REGION_ID --env-type CS
ctyun-cli apm app tasks --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --deployment ENV --env-uuid ENV_UUID
ctyun-cli apm app instances-stat --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP

调用链与拓扑

BASH

ctyun-cli apm trace detail --region-id REGION_ID --trace-id TRACE_ID
ctyun-cli apm trace span-detail --region-id REGION_ID --trace-id TRACE_ID --span-id SPAN_ID
ctyun-cli apm trace list --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm trace topology --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP

性能监控数据

BASH

ctyun-cli apm perf overview --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf request-curve --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf http-code-curve --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf slow-transactions --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf exceptions --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf sql-stat-page --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP --db-types mysql
ctyun-cli apm perf sql-stat-histogram --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf nosql-stat-histogram --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf nosql-stat-page --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf mq-stat-page --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf transaction-stat --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf jvm-info --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf app-instance-curve --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf jvm-gc-count --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP
ctyun-cli apm perf jvm-thread-count --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --service-name APP

用量统计

BASH

ctyun-cli apm usage total-view --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201
ctyun-cli apm usage span-report --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --step 3600
ctyun-cli apm usage agent-hour --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --step 3600
ctyun-cli apm usage span-store --region-id REGION_ID --start-time 1715656183201 --end-time 1716174583201 --step 3600

告警/通知/Webhook 管理

BASH

# 告警规则
ctyun-cli apm alert rules --region-id REGION_ID --obj-type ctgcache
ctyun-cli apm alert rule-templates --region-id REGION_ID --obj-type ctgcache
ctyun-cli apm alert send-history --region-id REGION_ID --page-num 1 --page-size 10

# 通知管理
ctyun-cli apm notify contacts --region-id REGION_ID --page-num 1 --page-size 10
ctyun-cli apm notify contact-groups --region-id REGION_ID --page-num 1 --page-size 10
ctyun-cli apm notify strategies --region-id REGION_ID --page-num 1 --page-size 10

# Webhook
ctyun-cli apm webhook list --region-id REGION_ID --page-num 1 --page-size 10

物理机 (DPS) 管理

查询操作系统列表

BASH

ctyun-cli dps list-os --region-id REGION_ID --az-name AZ_NAME

批量查询物理机列表

BASH

ctyun-cli dps list --region-id REGION_ID --az-name AZ_NAME
ctyun-cli dps list --region-id REGION_ID --az-name AZ_NAME --status RUNNING --page-size 20

查询单台物理机详情

BASH

ctyun-cli dps describe --region-id REGION_ID --az-name AZ_NAME --instance-uuid INSTANCE_UUID

查询物理机网卡信息

BASH

ctyun-cli dps interfaces --region-id REGION_ID --az-name AZ_NAME --instance-uuid INSTANCE_UUID

查询挂载卷ID列表

BASH

ctyun-cli dps volumes --region-id REGION_ID --az-name AZ_NAME --instance-uuid INSTANCE_UUID

查询镜像信息

BASH

ctyun-cli dps image --region-id REGION_ID --az-name AZ_NAME --instance-uuid INSTANCE_UUID

查询元数据

BASH

ctyun-cli dps metadata --region-id REGION_ID --az-name AZ_NAME --instance-uuid INSTANCE_UUID

查询物理机库存

BASH

ctyun-cli dps stock --region-id REGION_ID --az-name AZ_NAME
ctyun-cli dps stock --region-id REGION_ID --az-name AZ_NAME --device-type physical.t3.large --count 2

边缘安全加速平台 (Aone) 管理

覆盖域名、证书、开通服务/资源包、缓存刷新/预取、数据统计、访问控制、CC/WAF/DDoS 防护，共 49 个命令。服务端点 accessone-global.ctapi.ctyun.cn（文档中的 esa.ctapi.ctyun.cn 对这些接口返回 404）。

开通服务与资源包

BASH

# 查询账号下开通的服务基本信息（产品编码/状态/计费方式/版本/域名数）
ctyun-cli aone query-service-detail
ctyun-cli aone query-service-detail --product-code 020

# 查询安全与加速资源包列表（无资源包时返回"未查询到资源包"）
ctyun-cli aone query-resource-packages

域名协议类型

BASH

# --product-code 仅支持 009(应用加速) / 024(边缘接入)
ctyun-cli aone query-domain-protocol --product-code 024 --domain aaa.ctyun.cn
# 无域名接入方式时改用实例名
ctyun-cli aone query-domain-protocol --product-code 024 --access-mode 2 --instance inst_name

带宽数据统计

BASH

# 时间戳为秒级；1m 粒度可查最近 7 天，5m/1h/24h 粒度可查最近 365 天
ctyun-cli aone query-bandwidth-data --start-time 1662413100 --end-time 1662413700
# 多维度聚合（domain / application_layer_protocol / province / isp 等）
ctyun-cli aone query-bandwidth-data --start-time 1662413100 --end-time 1662413700 
  --group-by domain --group-by application_layer_protocol

表格同时给出 带宽(bps) 原值与 Kbps/Mbps/Gbps 可读值；--output json 保留接口原始数值。

域名与证书

BASH

ctyun-cli aone query-domain-list --product-code 020
ctyun-cli aone query-domain-list-basic --product-code 020
ctyun-cli aone query-domain-status --domains aaa.ctyun.cn --product-code 020
ctyun-cli aone query-cert-list --page 1 --per-page 100
ctyun-cli aone query-cert-detail --name CERT_NAME

缓存刷新与预取

BASH

ctyun-cli aone query-refresh-tasks --type 0 --start-time 1662413100 --end-time 1662413700
ctyun-cli aone query-preload-tasks --type 0 --start-time 1662413100 --end-time 1662413700

攻击与安全防护

BASH

# CC 攻击报告（时间为 yyyy-MM-dd HH:mm:ss 字符串）
ctyun-cli aone query-cc-attack-report --product-code 020 
  --start-time "2026-10-01 00:00:00" --end-time "2026-10-02 00:00:00"

ctyun-cli aone query-waf-config --domain aaa.ctyun.cn --product-code 020
ctyun-cli aone query-tamper-protect --domain aaa.ctyun.cn --product-code 020

域名状态与访问控制

BASH

# 应用加速/边缘接入（009/024）按实例或域名停用 / 启用 / 删除（--action 1 停用, 2 启用, 3 删除）
ctyun-cli aone change-domain-status --product-code 024 --action 1 --domain aaa.ctyun.cn
# 无域名接入方式时改用实例名（--access-mode 2）
ctyun-cli aone change-domain-status --product-code 024 --action 2 --access-mode 2 --instance inst_name

# 边缘云版产品（010/011/020）按域名停用 / 启用 / 删除（与上面 009/024 的接口不同）
ctyun-cli aone manage-domain --product-code 020 --domain www.ctyun.cn --action 1

# 新增访问控制策略（--domains 可多次指定；每条规则一个 --config JSON 对象）
ctyun-cli aone access-control-insert --product-code 020 --domains aaa.ctyun.cn 
  --config '{"mod":"ON","act":"BLOCK","ruleName":"block-bad-ip","ruleDesc":"封禁恶意IP","publicRange":[[{"equal":"TRUE","zone":"IP","publicContent":"1.2.3.4","operator":"STR"}]]}'

# 修改访问控制策略（按 rule_id 更新，可设优先级 priority；规则JSON原样透传）
ctyun-cli aone access-control-modify --domain aaa.ctyun.cn --product-code 020 
  --config '{"rule_id":17377,"act":"BLOCK","priority":1,"rule_name":"block-bad-ip"}'

两个状态接口不要混用：change-domain-status（009/024，支持 --access-mode 2 --instance 无域名接入）与 manage-domain（010/011/020，按域名维度，状态流转须为启用→停用→删除正向切换）。--action 与 --config 中的 act（规则动作 LOG/ACCEPT/BLOCK/DROP/CHECK/JUMP/JCJS/PIC）也是两套枚举。

微服务引擎 (MSE) 管理

覆盖实例、Nacos 注册配置中心、云原生 API 网关，共 48 个命令。

实例管理

BASH

ctyun-cli mse instance list --region-id REGION_ID
ctyun-cli mse instance detail --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse instance node-status --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse instance metrics --region-id REGION_ID --instance-id INSTANCE_ID

Nacos 服务与配置管理

BASH

# 服务管理
ctyun-cli mse nacos service list --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse nacos service detail --region-id REGION_ID --instance-id INSTANCE_ID --service-name SERVICE
ctyun-cli mse nacos service instances --region-id REGION_ID --instance-id INSTANCE_ID --service-name SERVICE

# 配置管理
ctyun-cli mse nacos config list --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse nacos config content --region-id REGION_ID --instance-id INSTANCE_ID --data-id DATA_ID --group GROUP
ctyun-cli mse nacos config history-list --region-id REGION_ID --instance-id INSTANCE_ID --data-id DATA_ID --group GROUP

# 命名空间 / 用户 / AKSK
ctyun-cli mse nacos namespace list --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse nacos user list --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse nacos aksk list --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli mse nacos blackwhite-list --region-id REGION_ID --instance-id INSTANCE_ID

云原生 API 网关

BASH

ctyun-cli mse gateway list --region-id REGION_ID
ctyun-cli mse gateway detail --region-id REGION_ID --spu-inst-id INST_ID
ctyun-cli mse gateway route list --region-id REGION_ID --inst-id INST_ID
ctyun-cli mse gateway upstream list --region-id REGION_ID --inst-id INST_ID
ctyun-cli mse gateway domain list --region-id REGION_ID --inst-id INST_ID
ctyun-cli mse gateway elb bound --region-id REGION_ID --inst-id INST_ID

云防火墙 (CFW) 管理

云防火墙原生版，共 66 个查询命令。

防火墙与概览

BASH

ctyun-cli cfw list --region-id REGION_ID
ctyun-cli cfw show --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw overview --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw protection-overview --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw asset-overview --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw acl-overview --region-id REGION_ID --firewall-id FIREWALL_ID

资产与防护规则

BASH

ctyun-cli cfw asset list --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw asset statistics --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw policy list --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw blackwhite list --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw address-book list --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw ips rules --region-id REGION_ID --firewall-id FIREWALL_ID

告警 / 日志 / 报表

BASH

ctyun-cli cfw alarm list --region-id REGION_ID --firewall-id FIREWALL_ID --start-time 2026-07-01T00:00:00Z --finish-time 2026-07-28T00:00:00Z
ctyun-cli cfw log flow-list --region-id REGION_ID --firewall-id FIREWALL_ID --start-time 2026-07-01T00:00:00Z --finish-time 2026-07-28T00:00:00Z
ctyun-cli cfw log storage --region-id REGION_ID --firewall-id FIREWALL_ID
ctyun-cli cfw report list --region-id REGION_ID --firewall-id FIREWALL_ID --start-time 2026-07-01T00:00:00Z --end-time 2026-07-28T00:00:00Z --report-type DAY

询价

BASH

# C100 型：新购 / 续订 / 升配
ctyun-cli cfw price new --region-id REGION_ID --cycle-type MONTH --cycle-cnt 1 --spec Advanced --protection-ip-num 20 --flow-processing-capacity 10
ctyun-cli cfw price renew --region-id REGION_ID --firewall-id FIREWALL_ID --cycle-type MONTH --cycle-cnt 1
# N100 型（orders 数组 JSON）
ctyun-cli cfw price new-n100 --region-id REGION_ID --orders-json '[{...}]'

容器镜像服务 (SWR) 管理

终端节点 crs-global.ctapi.ctyun.cn，共 18 个查询命令（文档全量 269 个接口，当前覆盖只读链路：实例 → 命名空间 → 仓库 → Tag → 制品 → Chart）。

实例

BASH

# 镜像实例列表（支持名称过滤；--all-region 遍历全部资源池）
ctyun-cli swr list-instances --region-id REGION_ID
ctyun-cli swr list-instances --region-id REGION_ID --instance-name my-swr
ctyun-cli swr list-instances --region-id REGION_ID --all-region

# 实例详情（实例类型、状态、企业项目、公网/内网地址、Chart 地址）
ctyun-cli swr get-instance --region-id REGION_ID --instance-id INSTANCE_ID

# 实例配额（命名空间/仓库配额与用量、存储配额）
ctyun-cli swr get-instance-usage --region-id REGION_ID --instance-id INSTANCE_ID

# 实例个数 / 对象存储配置 / 可用资源池
ctyun-cli swr get-instance-count --region-id REGION_ID [--all-region]
ctyun-cli swr get-storage-config --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli swr list-instance-regions --region-id REGION_ID

命名空间 / 仓库 / Tag / 制品

BASH

# 命名空间列表与详情
ctyun-cli swr list-namespaces --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli swr get-namespace --region-id REGION_ID --instance-id INSTANCE_ID --namespace-name hb

# 仓库列表与详情（repositoryId 取列表返回的 repositoryId 列）
ctyun-cli swr list-repositories --region-id REGION_ID --instance-id INSTANCE_ID --page-size 50
ctyun-cli swr get-repository --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID

# 镜像版本（Tag）
ctyun-cli swr list-tags --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID
ctyun-cli swr get-tag --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID --tag-name v1.0.0

# 制品（Artifact）
ctyun-cli swr list-artifacts --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID
ctyun-cli swr get-artifact --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID --reference v1.0.0

Chart（Helm）

BASH

ctyun-cli swr list-chart-namespaces --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli swr get-chart-namespace --region-id REGION_ID --instance-id INSTANCE_ID --namespace-name hb
ctyun-cli swr list-chart-repositories --region-id REGION_ID --instance-id INSTANCE_ID
ctyun-cli swr list-chart-tags --region-id REGION_ID --instance-id INSTANCE_ID --repository-id REPO_ID

链路关系：list-instances → instanceId → list-namespaces / list-repositories → repositoryId → list-tags / list-artifacts。

分页参数为 --page-num / --page-size（默认 10，最大 50），--output json 返回原始 returnObj.records。

网络管理

BASH

ctyun-cli network --help

存储管理

BASH

ctyun-cli storage --help

缓存管理

清空所有缓存

BASH

ctyun-cli clear-cache

使用技巧

JSON 输出便于脚本处理

CLI 会把 INFO 日志打到 stdout，直接喂给 jq 会 parse 失败，先剥掉日志行：

BASH

# 命令自带 --output 选项时，放在子命令之后
ctyun-cli ecs list --region-id 200000001852 --page-size 5 --output json 2>/dev/null 
  | sed -n '/^[[{]/,$p' 
  | jq '.[].instanceID'

YAML 输出便于阅读

BASH

ctyun-cli vpc show --vpc-id vpc-xxx --output yaml

调试模式排查问题

BASH

ctyun-cli ecs list --region-id 200000001852 --debug
# 关注：请求URL / 请求头(已脱敏) / 响应状态码 / 响应内容

使用指定配置文件

BASH

ctyun-cli ecs list --profile production

分页拉全并校验总数

BASH

# 先用 totalCount 判断应拉多少页，再循环，最后核对条数
ctyun-cli ecs list --region-id 200000001852 --page-size 100 --output json 
  | sed -n '/^[[{]/,$p' | jq 'length'

注意事项

首次使用前必须先配置认证信息（推荐使用环境变量方式）
大部分命令需要指定资源 ID（如 instance-id、vpc-id 等）
建议使用 --help 查看具体子命令的详细参数（分页参数名各模块不统一）
使用 JSON 输出格式便于与其他工具集成，注意先剥掉 stdout 上的 INFO 日志行
按需查询大量数据时建议分页或使用过滤参数，并以 totalCount 校验是否拉全
结果为空不一定是没有资源，也可能是鉴权失败或资源池无权访问——详见 [异常处理与错误排查](#异常处理与错误排查)
看到 ⚠️ 当前显示的是模拟数据 说明本次结果无效（ECS/VPC/Security 兜底行为）
默认只做查询；约 100 个变更类命令会真实修改云资源，执行前先询价并核对参数
资源 ID 不要截断，后续命令需要完整 ID
凭据与内部接口文档（todoapi/）一律不得进入代码仓库

询价 / 价格查询

支持 8 个模块共 41+ 个询价 API（不同 URI 视为独立 API）。

ECS 弹性云主机询价

BASH

ctyun-cli ecs query-price --resource-type EBS --disk-type SATA --disk-size 100 --disk-mode VBD  # 旧版订单询价
ctyun-cli ecs renew-price --resource-type VM --resource-uuid xxx --cycle-type MONTH --cycle-count 1  # 旧版续订询价
ctyun-cli ecs new-order-price --resource-type EBS --disk-type SATA --disk-size 100 --disk-mode VBD --cycle-type MONTH --cycle-count 1  # 新订单询价
ctyun-cli ecs upgrade-order-price --region-id REGION_ID --resource-id xxx --resource-type VM --flavor-name s2.small.1  # 订单升级询价
ctyun-cli ecs renew-order-price --region-id REGION_ID --resource-id xxx --resource-type VM --cycle-type MONTH --cycle-count 1  # 订单续订询价
ctyun-cli ecs upgrade-by-uuid-price --region-id REGION_ID --resource-uuid xxx --resource-type VM --flavor-name s2.small.1  # UUID升级询价

Redis 询价

BASH

ctyun-cli redis price --order-type BUY --charge-type PrePaid --period 1 --edition DirectCluster --shard-mem-size 1 --shard-count 3 --engine-version 6.0 --capacity 3

Kafka 询价

BASH

ctyun-cli kafka create-price -r REGION_ID --spec-name kafka.8u16g.cluster --node-num 3 --zone-list AZ1 --disk-type SSD --disk-size 300 --cycle-type 3 --cycle-cnt 1
ctyun-cli kafka renew-price -r REGION_ID -i INSTANCE_ID --cycle-cnt 1
ctyun-cli kafka spec-change-price -r REGION_ID -i INSTANCE_ID --spec-name kafka.16u32g.cluster
ctyun-cli kafka disk-change-price -r REGION_ID -i INSTANCE_ID --disk-size 600
ctyun-cli kafka node-change-price -r REGION_ID -i INSTANCE_ID --node-num 5

VPC 询价（18 个命令）

BASH

ctyun-cli vpc price eip create --region-id REGION_ID --cycle-type month --name test --bandwidth 5
ctyun-cli vpc price eip modify --region-id REGION_ID --eip-id EIP_ID --bandwidth 10
ctyun-cli vpc price eip renew --region-id REGION_ID --eip-id EIP_ID --cycle-type month --cycle-count 1
ctyun-cli vpc price nat create --region-id REGION_ID --vpc-id VPC_ID --name nat --spec 1 --az-name AZ --cycle-type month --cycle-count 1
ctyun-cli vpc price nat modify --region-id REGION_ID --nat-gateway-id NAT_ID --spec 2
ctyun-cli vpc price nat renew --region-id REGION_ID --nat-gateway-id NAT_ID --cycle-type month --cycle-count 1
ctyun-cli vpc price bw create --region-id REGION_ID --bandwidth 10 --cycle-type month --cycle-count 1 --name bw
ctyun-cli vpc price bw modify --region-id REGION_ID --bandwidth-id BW_ID --bandwidth 20
ctyun-cli vpc price bw renew --region-id REGION_ID --bandwidth-id BW_ID --cycle-type month --cycle-count 1
ctyun-cli vpc price flow-package --region-id REGION_ID --cycle-type MONTH --cycle-count 1 --count 1 --spec 10
ctyun-cli vpc price ipv6 create --region-id REGION_ID ...   # IPv6 带宽创建询价
ctyun-cli vpc price ipv6 modify --region-id REGION_ID ...   # IPv6 带宽变配询价
ctyun-cli vpc price ipv6 renew --region-id REGION_ID ...    # IPv6 带宽续订询价
ctyun-cli vpc price vpce --region-id REGION_ID --endpoint-service-id EPS_ID --endpoint-name test --subnet-id SUBNET_ID --vpc-id VPC_ID
ctyun-cli vpc price l2gw create --region-id REGION_ID ...   # L2GW 订购询价
ctyun-cli vpc price l2gw renew --region-id REGION_ID ...    # L2GW 续订询价
ctyun-cli vpc price to-cycle --region-id REGION_ID --resource-id EIP_ID --resource-type eip --cycle-type month --cycle-count 1  # 按需转包周期
ctyun-cli vpc price to-ondemand --region-id REGION_ID --resource-id EIP_ID --resource-type eip  # 包周期转按需

CloudPC 云电脑询价

BASH

ctyun-cli cloudpc volume-price --bill-mode Cycle --disk-type uhio --count 1 --volume-size 50 --encryption false
ctyun-cli cloudpc ecs-price --bill-mode Cycle --os-type Windows --template-oid OID --image-oid OID --subnet-oid OID --security-group-oid OID --sys-disk-type uhio --sys-disk-size 50 --instance-num 1
ctyun-cli cloudpc expand-price --cycle-type Month --cycle-cnt 1 --volume-oid OID --volume-size 100
ctyun-cli cloudpc renew-ecs-price --cycle-type Month --cycle-cnt 1 --desktop-oids OID1,OID2
ctyun-cli cloudpc renew-volume-price --cycle-type Month --cycle-cnt 1 --volume-oid OID
ctyun-cli cloudpc resize-sysdisk-price --desktop-oid OID --disk-size 100

SFS / OceanFS 询价

BASH

ctyun-cli sfs create-price --region-id REGION_ID --order-num 1 --cycle-type year --sfs-size 500 --volume-type hdd --cycle-cnt 3
ctyun-cli sfs expand-price --region-id REGION_ID --sfs-uid FS_ID --sfs-size 1000
ctyun-cli sfs renew-price --region-id REGION_ID --sfs-uid FS_ID --cycle-type year --cycle-cnt 1
ctyun-cli oceanfs create-price --region-id REGION_ID --order-num 1 --sfs-size 500 --sfs-type massive --on-demand

云间高速 EC 询价（新模块）

BASH

ctyun-cli ec price new --region-id REGION_ID --ec-id EC_ID --bandwidth 5 --cycle-type month --cycle-count 1
ctyun-cli ec price upgrade --region-id REGION_ID --ec-id EC_ID --bandwidth 10 --resource-id RES_ID
ctyun-cli ec price renew --region-id REGION_ID --ec-id EC_ID --resource-id RES_ID --cycle-type month --cycle-count 1

微服务引擎 MSE 询价（新模块）

BASH

ctyun-cli mse create-price --engine-type nacos --cycle-type 3 --cycle-cnt 1 --auto-pay false --auto-renew-cycle-type 3 --auto-renew-cycle-count 1 --instance-num 3 --cpu-num 4 --region-id REGION_ID

版本信息

当前版本: v1.33.4 (2026-11-06)
开源协议: MIT
Python 要求: Python 3.8+
API 覆盖: 1,132+ 个 API
命令数量: 1,080+ 个命令
服务模块: 31+ 大服务模块
最新功能:
- 🆕 ELB 补齐访问控制策略组管理（v1.33.4）：create-access-control / update-access-control / delete-access-control（/v4/elb/*-access-control），clientToken 不传自动生成；更新时 sourceIps 单次最多 10 条
- 🆕 Aone 新增 access-control-modify（v1.33.3）：按 rule_id 修改访问控制策略并设置 priority（POST /ctapi/v1/accessControlConf/updateAccessControl），规则 JSON 原样透传
- 🆕 Aone 新增 manage-domain（v1.33.2）：边缘云版产品（010/011/020）按域名停用/启用/删除（POST /ctapi/v1/accessone/domain/manage）；与 change-domain-status（009/024，支持无域名接入）是两个接口；状态流转须为启用→停用→删除
- 🆕 SWR 容器镜像服务新增 16 个只读命令（v1.33.1）：实例详情/配额/个数/资源池/存储配置、命名空间、仓库详情、Tag 列表与详情、制品列表与详情、Chart 命名空间/仓库/版本；SWR 由 2 个扩到 18 个命令
  - 分页统一 --page-num / --page-size（默认 10，最大 50）；链路实例→命名空间→仓库→Tag/制品
  - 资源池列表实际响应字段为 regionId/regionCode/regionName（文档写作 region），已兼容两种
- 🆕 Aone 新增 2 个管理命令（v1.33.0）：change-domain-status（停用/启用/删除域名，支持域名接入与无域名接入）、access-control-insert（多域名批量下发访问控制策略）
- 🆕 ELB 新增 listener stop（v1.33.0）：停止监听器（POST /v4/elb/stop-listener，支持 --client-token 幂等）
- 🔧 Aone 边缘安全加速平台接口修复（v1.32.4）：query-domain-protocol / query-resource-packages 修正 API 路径（此前分别返回 "API Not Found" 与"参数校验失败"）
  - query-service-detail 表格重构：展开 attribute，补充产品类型/业务状态字典/计费方式/版本/域名数列
  - query-bandwidth-data 表格增加可读时间与动态聚合维度列，带宽同时输出 bps 与 Kbps/Mbps/Gbps
- 🔧 修复 4 处 --help 崩溃（v1.32.4）：click.Choice 整型枚举导致 vpc price nat create/modify、ctmysql batch-monitor、redis task-center-list 帮助信息抛 TypeError
- 🆕 CDA 云专线新增 3 个 QOS 查询命令（v1.32.3）：qos list / qos policy list / qos rule list
  - 修复 cda vpc list / vpc count / static-route list 传参，统一使用 GET + vrfName
  - 兼容真实响应字段 vrfName / displayName / lineID / vpcList，修复空路由字段导致的表格崩溃
- 🆕 Billing 模块新增 5 个新版账单详情命令（v1.32.2）：product-cycle-v2 / resource-detail-v2 / resource-cycle-v2 / usage-detail-v2 / usage-cycle-v2
  - 包周期+按需合并查询，支持按天分组（--group-by-day）、企业项目/资源/产品过滤、零金额过滤
  - 兼容 statusCode 与 success/errorCode 两种响应结构，表格金额统一保留两位小数
- 🚀 LTS 模块首批可用命令（v1.32.1）：unit list-v1 / unit get-index-v1 / search logs-v1，v1 接口成功码为 0
- 🆕 新增 SWR 容器镜像服务模块（v1.32.0）：镜像实例列表、镜像仓库列表，终端节点 crs-global.ctapi.ctyun.cn
- 🔒 安全加固（v1.31.3）：全量启用 TLS 证书校验、debug 日志认证头脱敏、凭据/缓存文件权限收紧
- 🚀 CCE 模块新增 V2 查询 API（v1.31.0）：新增 10 个 V2 版本查询命令（升级类 6 个 + 全新类 4 个），与现有 V1.1 接口并存，命令统一加 -v2 后缀
- 🔧 Aone 模块响应解析修复（v1.31.2）：修复 CLI 误报"查询失败: success"问题（兼容 statusCode/code 两种响应结构），修正 WAF/访问控制查询参数命名
- 🔧 Redis 模块监控 API 修复（v1.31.1）：修复 4 个监控类 API 路径错误（404），修正参数名、时间格式与签名编码
- 🆕 新增 CFW 云防火墙模块（v1.30.0）：66 个查询命令，终端节点 ctcfw-global.ctapi.ctyun.cn
  - 防火墙/概览/版本配额/网络工具/资产/防护规则/黑白名单/地址簿/IPS/应用/告警/日志/报表/询价（C100+N100）
  - excel 模板导出支持二进制文件下载（--output 指定保存路径）
- 🚀 MSE 微服务引擎大扩展（v1.29.0~v1.29.2）：从 1 个扩展到 48 个命令
  - Nacos 注册配置中心（服务/配置/命名空间/用户/AKSK，21+8 个命令）
  - 云原生 API 网关（网关/路由/服务/域名/ELB，18 个命令）
- 🎉 VPC 模块查询列表类 API 全部完成（v1.27.2）：96 个命令
- 🚀 VPC 模块扩展（第 3 波）（v1.27.1）：从 68 个扩展到 82 个命令
  - 网络 ACL：ACL 列表（旧/新）、ACL 规则列表
  - 前缀列表：前缀列表、详情、关联资源
  - 流量控制（镜像流）：过滤规则、过滤条件、流量会话列表
  - GWLB：GWLB 列表、IP 监听器列表
  - L2GW：L2GW 列表、L2GW connection 列表
  - HaVip：高可用虚拟 IP 列表（自动生成 clientToken）
- 🚀 VPC 模块大扩展（第 2 波）：从 42 个扩展到 68 个命令（v1.27.0）
  - EIP 监控：实时监控（旧/新版）、历史监控（旧/新版）、端口备案状态、EIP 地址可用性检查
  - 共享带宽/流量包：共享带宽详情、新查询共享带宽列表、共享流量包列表/详情/监控
  - VPC 终端节点（VPCE）：终端节点列表（旧/新）、终端节点服务列表（旧/新）、后端列表
  - 内网 DNS：DNS 列表（旧/新）、DNS 记录列表（旧/新）
  - 新增 _simple_post 通用 POST 辅助方法
- 🚀 VPC 模块扩展（第 1 波）：从 23 个扩展到 42 个命令（v1.26.2）
  - NAT网关详情、SNAT/DNAT规则列表与详情、对等连接详情
  - 新查询路由表列表、路由表规则列表、新查询路由表规则列表
  - 安全组规则列表、安全组绑定机器列表、网卡列表/新查询网卡列表
  - 修复 NAT网关列表/对等连接列表/流日志列表的 TODO 桩代码实现
- 🆕 EVS 云硬盘模块扩充：从 1 个扩展到 7 个查询命令
  - 云硬盘详情（基于diskID/名称）、列表（基于名称）、快照列表/使用量、自动快照策略
- 🚀 Redis 查询类 API 全面扩充：新增 52 个查询命令，Redis 模块从 33 个扩展到 85 个命令
  - 实例生命周期/回收站/配额/专属集群、备份恢复/数据闪回、SSL/IP白名单/危险命令重命名
  - 慢日志/审计日志/节点命令监控/命中率分析、参数模板(V3)/修改历史
  - 大key/热key/离线全量key分析、过期key扫描、淘汰策略、数据迁移进度/日志、任务中心、混沌工程故障
- 🆕 APM（应用性能监控）模块：终端节点 arms-global.ctapi.ctyun.cn，实现 44 个查询类 API
  - 基础配置(项目/环境/LicenseKey/采集状态)、应用与实例、调用链与拓扑、性能监控(SQL/NoSQL/MQ/JVM)、用量统计、告警/通知/Webhook
- 🚀 ZOS（对象存储）全面增强：从仅询价扩展到 39 个命令（桶/对象/IAM/服务/标签管理）
- 🚀 ELB 查询类 API：新增 19 个查询命令（访问控制/规格/证书/转发规则/健康检查/GWLB/IP监听器/旧版监控/标签）
- 🆕 ctmysql（关系数据库MySQL版）模块：实例列表、标签管理、监控查询、询价（新建/变更/续费）
- 🆕 csscn（服务器安全卫士原生版）模块：10个命令，服务器/风险/漏洞/告警/病毒/配额查询
- 🔧 billing 模块清理：移除全部 mock 数据逻辑，删除失效的 balance/arrears 命令
- 🆕 DPS（物理机）模块：8个命令，实例/网卡/镜像/元数据/库存查询
- 🚀 ELB 新增3个PGELB询价API（创建/续订/变配）
- 🚀 ECS 新增资源续订询价（支持VM/EBS/IP/NAT/BMS等9种资源类型）
- 🚀 Monitor 新增拨测点查询和拨测任务结果查询
- 🚀 OceanFS 新增续订询价和扩容询价
- 🚀 Redis 新增7个API：Proxy监控、读写分离、分片管理、节点状态、可用区查询
- 🆕 Aone（边缘安全加速平台）/ AIServer（模型推理服务）/ CloudPC（云电脑）模块

2026 年 11 月
一	二	三	四	五	六	日
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30