查询自定义实例(RC Instances)
概述
本技能提供阿里云 RC(RDS Custom)实例全生命周期查询能力,通过 aliyun CLI 调用 RDS API 获取实例及相关资源信息。适用于查询 RC 实例、监控指标、资源配置等场景。
核心能力
支持的查询命令
| 命令 | 功能 | 状态 |
|---|
| INLINECODE0 | 查询 RC 实例列表 | ✅ |
| INLINECODE1 |
查询单个实例详细信息 | ✅ |
|
DescribeRCImageList | 查询可用镜像列表 | ✅ |
|
DescribeRCDisks | 查询磁盘列表 | ✅ |
|
DescribeRCSnapshots | 查询快照列表 | ✅ |
|
DescribeRCMetricList | 查询监控指标(CPU、内存等) | ✅ |
|
DescribeRCClusterConfig | 查询 ACK 集群 KubeConfig | ✅ |
|
DescribeRCNodePool | 查询边缘节点池配置 | ✅ |
|
DescribeRCInstanceVncUrl | 查询 VNC 登录地址 | ✅ |
暂不支持的命令
以下命令在 Java SDK 中存在,但在 aliyun CLI v3.2.13 中暂不支持:
| 命令 | 功能 | 替代方案 |
|---|
| INLINECODE9 | 查询云助手状态 | SSH 登录实例检查 |
| INLINECODE10 |
查询网络接口信息 | 使用 DescribeRCInstanceAttribute |
|
DescribeRCInstanceHistoryEvents | 查询历史事件 | 使用控制台查看 |
特性
- - 多地域支持:支持指定地域查询,默认 INLINECODE12
- 格式化输出:支持 JSON、表格等多种输出格式
- jq 过滤:提供丰富的 jq 数据提取示例
- 监控查询:支持 CPU、内存、磁盘等监控指标查询
使用方式
基本查询
CODEBLOCK0
指定地域
CODEBLOCK1
格式化输出(表格)
CODEBLOCK2
查询特定实例
CODEBLOCK3
使用 jq 过滤
CODEBLOCK4
脚本使用
查询 RC 实例脚本
CODEBLOCK5
示例输出
CODEBLOCK6
前置条件
1. 安装 aliyun CLI
CODEBLOCK7
2. 配置凭证
CODEBLOCK8
需要输入:
- - AccessKey ID
- AccessKey Secret
- 默认地域(如:cn-beijing)
- 输出格式(json)
- 语言(zh)
3. 验证配置
CODEBLOCK9
常用命令参考
| 命令 | 说明 |
|---|
| INLINECODE13 | 查询 RC 实例列表 |
| INLINECODE14 |
查询单个 RC 实例详细信息 |
|
aliyun rds DescribeRCImageList | 查询 RC 实例可用镜像列表 |
|
aliyun rds DescribeRCNetworkInterfaces | 查询 RC 实例网络接口信息 |
|
aliyun rds DescribeRCDeploymentSets | 查询 RC 实例部署集列表 |
|
aliyun rds DescribeRCDisks | 查询 RC 实例磁盘列表 |
|
aliyun rds DescribeRCSnapshots | 查询 RC 实例快照列表 |
|
aliyun rds DescribeRCInstanceHistoryEvents | 查询 RC 实例历史事件 |
|
aliyun rds DescribeRCCloudAssistantStatus | 查询 RC 实例云助手状态 |
|
aliyun rds DescribeRCMetricList | 查询 RC 实例监控指标(CPU、内存等) |
查询实例详细信息
基本查询
CODEBLOCK10
指定实例名称
CODEBLOCK11
格式化输出
CODEBLOCK12
使用 jq 提取字段
CODEBLOCK13
查询可用镜像列表
基本查询
CODEBLOCK14
指定实例类型查询
CODEBLOCK15
格式化输出
CODEBLOCK16
使用 jq 过滤
CODEBLOCK17
输出字段说明
| 字段 | 说明 |
|---|
| ImageId | 镜像 ID |
| ImageName |
镜像名称 |
| OSType | 操作系统类型(linux/windows) |
| OSName | 操作系统名称 |
| ImageVersion | 镜像版本 |
查询磁盘列表
基本查询
CODEBLOCK18
按地域查询
CODEBLOCK19
格式化输出
CODEBLOCK20
使用 jq 提取字段
CODEBLOCK21
输出字段说明
磁盘名称 |
| Size | 磁盘容量(GB) |
| Category | 磁盘种类(cloud
essd/cloudssd 等) |
| Status | 磁盘状态(In_Use/Available) |
| Type | 磁盘类型(system/data) |
| Device | 设备名(/dev/vda 等) |
| Encrypted | 是否加密 |
查询快照列表
基本查询
CODEBLOCK22
按地域查询
CODEBLOCK23
指定磁盘 ID 查询
CODEBLOCK24
格式化输出
CODEBLOCK25
使用 jq 提取字段
CODEBLOCK26
输出字段说明
| 字段 | 说明 |
|---|
| SnapshotId | 快照 ID |
| SnapshotName |
快照名称 |
| Size | 快照容量(GB) |
| Status | 快照状态(success/failed/progressing) |
| CreationTime | 创建时间 |
| SourceDiskId | 源磁盘 ID |
| SourceInstanceId | 源实例 ID |
| Progress | 快照进度(百分比) |
| RetentionDays | 保留天数 |
监控指标查询
查询 CPU 使用率
CODEBLOCK27
查询内存使用率
CODEBLOCK28
常用指标名称
| 指标名 | 说明 |
|---|
| CPUUtilization | CPU 使用率 (%) |
| MemoryUtilization |
内存使用率 (%) |
| DiskUtilization | 磁盘使用率 (%) |
| IOPS | 每秒 IO 操作数 |
| ConnectionUsage | 连接数使用率 |
参数说明
| 参数 | 必填 | 说明 |
|---|
| InstanceId | 是 | RC 实例 ID |
| MetricName |
是 | 指标名称 |
| StartTime | 是 | 开始时间,格式
YYYY-MM-DD HH:mm:ss |
| EndTime | 是 | 结束时间,格式
YYYY-MM-DD HH:mm:ss |
| Period | 否 | 采集周期(秒),默认 60 |
| Length | 否 | 返回数据点数,默认 1000 |
示例:查询最近 1 小时 CPU
CODEBLOCK29
使用 jq 提取数据
CODEBLOCK30
输出字段说明
| 字段 | 说明 |
|---|
| InstanceId | 实例 ID |
| InstanceName |
实例名称 |
| ClusterName | 集群名称 |
| Status | 运行状态(Running/Stopped 等) |
| Cpu | CPU 核数 |
| Memory | 内存大小(MB) |
| RegionId | 地域 ID |
| ZoneId | 可用区 ID |
| VpcId | VPC ID |
| PrivateIpAddress | 私网 IP |
| InstanceChargeType | 计费类型(PrePaid/PostPaid) |
| ExpiredTime | 到期时间 |
| GmtCreated | 创建时间 |
常见问题
1. 权限错误
ERROR: InvalidAccessKeyId.NotFound
解决: 检查
aliyun configure 配置的 AccessKey 是否正确
2. 地域错误
ERROR: InvalidRegionId.NotFound
解决: 使用有效的地域 ID,如
cn-beijing、
cn-hangzhou、 INLINECODE28
3. CLI 未安装
bash: aliyun: command not found
解决: 参考前置条件安装 aliyun CLI
4. 返回空列表
{"RCInstances": [], "TotalCount": 0}
解决:
- - 检查地域是否正确
- 确认当前账号下是否有 RC 实例
- 尝试其他地域查询
参考资料
查询自定义实例(RC Instances)
概述
本技能提供阿里云 RC(RDS Custom)实例全生命周期查询能力,通过 aliyun CLI 调用 RDS API 获取实例及相关资源信息。适用于查询 RC 实例、监控指标、资源配置等场景。
核心能力
支持的查询命令
| 命令 | 功能 | 状态 |
|---|
| DescribeRCInstances | 查询 RC 实例列表 | ✅ |
| DescribeRCInstanceAttribute |
查询单个实例详细信息 | ✅ |
| DescribeRCImageList | 查询可用镜像列表 | ✅ |
| DescribeRCDisks | 查询磁盘列表 | ✅ |
| DescribeRCSnapshots | 查询快照列表 | ✅ |
| DescribeRCMetricList | 查询监控指标(CPU、内存等) | ✅ |
| DescribeRCClusterConfig | 查询 ACK 集群 KubeConfig | ✅ |
| DescribeRCNodePool | 查询边缘节点池配置 | ✅ |
| DescribeRCInstanceVncUrl | 查询 VNC 登录地址 | ✅ |
暂不支持的命令
以下命令在 Java SDK 中存在,但在 aliyun CLI v3.2.13 中暂不支持:
| 命令 | 功能 | 替代方案 |
|---|
| DescribeRCCloudAssistantStatus | 查询云助手状态 | SSH 登录实例检查 |
| DescribeRCNetworkInterfaces |
查询网络接口信息 | 使用 DescribeRCInstanceAttribute |
| DescribeRCInstanceHistoryEvents | 查询历史事件 | 使用控制台查看 |
特性
- - 多地域支持:支持指定地域查询,默认 cn-beijing
- 格式化输出:支持 JSON、表格等多种输出格式
- jq 过滤:提供丰富的 jq 数据提取示例
- 监控查询:支持 CPU、内存、磁盘等监控指标查询
使用方式
基本查询
bash
aliyun rds DescribeRCInstances --region cn-beijing
指定地域
bash
aliyun rds DescribeRCInstances --region cn-hangzhou
格式化输出(表格)
bash
aliyun rds DescribeRCInstances --region cn-beijing --output cols=InstanceId,InstanceName,Status,RegionId,Cpu,Memory
查询特定实例
bash
aliyun rds DescribeRCInstances --region cn-beijing --InstanceId rc-xxx
使用 jq 过滤
bash
只查询运行中的实例
aliyun rds DescribeRCInstances --region cn-beijing | jq .RCInstances[] | select(.Status == Running)
提取关键字段
aliyun rds DescribeRCInstances --region cn-beijing | jq .RCInstances[] | {InstanceId, InstanceName, Status, Cpu, Memory}
脚本使用
查询 RC 实例脚本
bash
cd /path/to/skill/scripts
./queryrcinstances.sh [地域]
示例输出
bash
$ ./queryrcinstances.sh cn-beijing
=== RC 实例列表 (cn-beijing) ===
实例 ID: rc-xxxxxxxxxxxxx
实例名称:rc-xxxxxxxxxxxxx
集群名称:RCC-xxxxxxxxxxxxxxx
状态:Running
CPU: 4 核
内存:32 GB
地域:cn-beijing
可用区:cn-beijing-x
私网 IP: 10.x.x.xxx
VPC: vpc-xxxxxxxxxxxxxxxxx
创建时间:2026-01-20 18:45:50
到期时间:2026-04-20T16:00:00Z
总计:1 台实例
前置条件
1. 安装 aliyun CLI
bash
一键安装
/bin/bash -c $(curl -fsSL https://aliyuncli.alicdn.com/install.sh)
2. 配置凭证
bash
aliyun configure
需要输入:
- - AccessKey ID
- AccessKey Secret
- 默认地域(如:cn-beijing)
- 输出格式(json)
- 语言(zh)
3. 验证配置
bash
aliyun version
aliyun rds DescribeRCInstances --region cn-beijing
常用命令参考
| 命令 | 说明 |
|---|
| aliyun rds DescribeRCInstances | 查询 RC 实例列表 |
| aliyun rds DescribeRCInstanceAttribute |
查询单个 RC 实例详细信息 |
| aliyun rds DescribeRCImageList | 查询 RC 实例可用镜像列表 |
| aliyun rds DescribeRCNetworkInterfaces | 查询 RC 实例网络接口信息 |
| aliyun rds DescribeRCDeploymentSets | 查询 RC 实例部署集列表 |
| aliyun rds DescribeRCDisks | 查询 RC 实例磁盘列表 |
| aliyun rds DescribeRCSnapshots | 查询 RC 实例快照列表 |
| aliyun rds DescribeRCInstanceHistoryEvents | 查询 RC 实例历史事件 |
| aliyun rds DescribeRCCloudAssistantStatus | 查询 RC 实例云助手状态 |
| aliyun rds DescribeRCMetricList | 查询 RC 实例监控指标(CPU、内存等) |
查询实例详细信息
基本查询
bash
aliyun rds DescribeRCInstanceAttribute \
--region cn-beijing \
--InstanceId rc-
指定实例名称
bash
aliyun rds DescribeRCInstanceAttribute \
--region cn-beijing \
--InstanceId rc- \
--InstanceName rc-
格式化输出
bash
aliyun rds DescribeRCInstanceAttribute \
--region cn-beijing \
--InstanceId rc- \
--output cols=InstanceId,InstanceName,Status,Cpu,Memory,RegionId,ZoneId
使用 jq 提取字段
bash
提取基本信息
aliyun rds DescribeRCInstanceAttribute \
--region cn-beijing \
--InstanceId rc-
\
| jq .RCInstances[0] | {InstanceId, InstanceName, Status, Cpu, Memory}
提取网络信息
aliyun rds DescribeRCInstanceAttribute \
--region cn-beijing \
--InstanceId rc- \
| jq .RCInstances[0].VpcAttributes | {VpcId, VSwitchId, PrivateIpAddress}
查询可用镜像列表
基本查询
bash
aliyun rds DescribeRCImageList \
--region cn-beijing
指定实例类型查询
bash
aliyun rds DescribeRCImageList \
--region cn-beijing \
--InstanceType mysql.x2.xlarge.6cm
格式化输出
bash
aliyun rds DescribeRCImageList \
--region cn-beijing \
--output cols=ImageId,ImageName,OSType,OSName
使用 jq 过滤
bash
提取镜像基本信息
aliyun rds DescribeRCImageList \
--region cn-beijing \
| jq .Images[] | {ImageId, ImageName, OSType}
查询 Alibaba Cloud Linux 镜像
aliyun rds DescribeRCImageList \
--region cn-beijing \
| jq .Images[] | select(.OSName | contains(Alibaba Cloud Linux))
统计镜像数量
aliyun rds DescribeRCImageList \
--region cn-beijing \
| jq .Images | length
输出字段说明
| 字段 | 说明 |
|---|
| ImageId | 镜像 ID |
| ImageName |
镜像名称 |
| OSType | 操作系统类型(linux/windows) |
| OSName | 操作系统名称 |
| ImageVersion | 镜像版本 |
查询磁盘列表
基本查询
bash
aliyun rds DescribeRCDisks \
--region cn-beijing \
--InstanceId rc-
按地域查询
bash
aliyun rds DescribeRCDisks \
--region cn-beijing
格式化输出
bash
aliyun rds DescribeRCDisks \
--region cn-beijing \
--InstanceId rc- \
--output cols=DiskId,DiskName,Size,Category,Status
使用 jq 提取字段
bash
提取磁盘基本信息
aliyun rds DescribeRCDisks \
--region cn-beijing \
--InstanceId rc- \
| jq .Disks[] | {DiskId, DiskName, Size, Category}
查询系统盘和数据盘