⚡

// Skill profile

查询自定义实例（RC Instances）

Name: 查询自定义实例（RC Instances）
Author: chucklong

name: alicloud-database-rds-custom

by chucklong · published 2026-03-22

图像生成数据处理

Total installs

Stars

★ 0

Last updated

2026-03

// Install command

$ claw add gh:chucklong/chucklong-alicloud-database-rds-custom

View on GitHub

// Full documentation

---

name: alicloud-database-rds-custom

description: 查询阿里云自定义实例（RC 实例）。使用 aliyun CLI 调用 DescribeRCInstances API 查询 RDS 相关自定义实例。当用户需要查询 RC 实例、RDS 自定义实例或云资源时触发此技能。

license: MIT

---

# 查询自定义实例（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、内存、磁盘等监控指标查询

使用方式

基本查询

aliyun rds DescribeRCInstances --region cn-beijing

指定地域

aliyun rds DescribeRCInstances --region cn-hangzhou

格式化输出（表格）

aliyun rds DescribeRCInstances --region cn-beijing --output cols=InstanceId,InstanceName,Status,RegionId,Cpu,Memory

查询特定实例

aliyun rds DescribeRCInstances --region cn-beijing --InstanceId rc-xxx

使用 jq 过滤

# 只查询运行中的实例
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 实例脚本

cd /path/to/skill/scripts
./query_rc_instances.sh [地域]

示例输出

$ ./query_rc_instances.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

# 一键安装
/bin/bash -c "$(curl -fsSL https://aliyuncli.alicdn.com/install.sh)"

2. 配置凭证

aliyun configure

需要输入：

AccessKey ID

AccessKey Secret

默认地域（如：cn-beijing）

输出格式（json）

语言（zh）

3. 验证配置

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、内存等） |

查询实例详细信息

基本查询

aliyun rds DescribeRCInstanceAttribute \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID>

指定实例名称

aliyun rds DescribeRCInstanceAttribute \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  --InstanceName rc-<INSTANCE_ID>

格式化输出

aliyun rds DescribeRCInstanceAttribute \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  --output cols=InstanceId,InstanceName,Status,Cpu,Memory,RegionId,ZoneId

使用 jq 提取字段

# 提取基本信息
aliyun rds DescribeRCInstanceAttribute \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.RCInstances[0] | {InstanceId, InstanceName, Status, Cpu, Memory}'

# 提取网络信息
aliyun rds DescribeRCInstanceAttribute \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.RCInstances[0].VpcAttributes | {VpcId, VSwitchId, PrivateIpAddress}'

查询可用镜像列表

基本查询

aliyun rds DescribeRCImageList \
  --region cn-beijing

指定实例类型查询

aliyun rds DescribeRCImageList \
  --region cn-beijing \
  --InstanceType mysql.x2.xlarge.6cm

格式化输出

aliyun rds DescribeRCImageList \
  --region cn-beijing \
  --output cols=ImageId,ImageName,OSType,OSName

使用 jq 过滤

# 提取镜像基本信息
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 | 镜像版本 |

查询磁盘列表

基本查询

aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID>

按地域查询

aliyun rds DescribeRCDisks \
  --region cn-beijing

格式化输出

aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  --output cols=DiskId,DiskName,Size,Category,Status

使用 jq 提取字段

# 提取磁盘基本信息
aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Disks[] | {DiskId, DiskName, Size, Category}'

# 查询系统盘和数据盘
aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Disks[] | select(.Type == "system")'

# 统计磁盘总容量
aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '[.Disks[].Size | tonumber] | add'

# 统计磁盘数量
aliyun rds DescribeRCDisks \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Disks | length'

输出字段说明

| 字段 | 说明 |

|------|------|

| DiskId | 磁盘 ID |

| DiskName | 磁盘名称 |

| Size | 磁盘容量（GB） |

| Category | 磁盘种类（cloud_essd/cloud_ssd 等） |

| Status | 磁盘状态（In_Use/Available） |

| Type | 磁盘类型（system/data） |

| Device | 设备名（/dev/vda 等） |

| Encrypted | 是否加密 |

查询快照列表

基本查询

aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID>

按地域查询

aliyun rds DescribeRCSnapshots \
  --region cn-beijing

指定磁盘 ID 查询

aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --DiskId d-c5kyo15381wht249k498

格式化输出

aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  --output cols=SnapshotId,SnapshotName,Size,Status,CreationTime

使用 jq 提取字段

# 提取快照基本信息
aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Snapshots[] | {SnapshotId, SnapshotName, Size, Status}'

# 查询成功状态的快照
aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Snapshots[] | select(.Status == "success")'

# 统计快照总数量
aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '.Snapshots | length'

# 统计快照总容量
aliyun rds DescribeRCSnapshots \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  | jq '[.Snapshots[].Size | tonumber] | add'

输出字段说明

| 字段 | 说明 |

|------|------|

| SnapshotId | 快照 ID |

| SnapshotName | 快照名称 |

| Size | 快照容量（GB） |

| Status | 快照状态（success/failed/progressing） |

| CreationTime | 创建时间 |

| SourceDiskId | 源磁盘 ID |

| SourceInstanceId | 源实例 ID |

| Progress | 快照进度（百分比） |

| RetentionDays | 保留天数 |

监控指标查询

查询 CPU 使用率

aliyun rds DescribeRCMetricList \
  --region cn-beijing \
  --InstanceId rc-xxx \
  --MetricName CPUUtilization \
  --StartTime "2026-03-12 10:05:00" \
  --EndTime "2026-03-12 10:15:00" \
  --Period 60 \
  --Length 1000

查询内存使用率

aliyun rds DescribeRCMetricList \
  --region cn-beijing \
  --InstanceId rc-xxx \
  --MetricName MemoryUtilization \
  --StartTime "2026-03-12 10:05:00" \
  --EndTime "2026-03-12 10:15:00" \
  --Period 60

常用指标名称

| 指标名 | 说明 |

|--------|------|

| 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

# 计算 1 小时前的时间
START=$(date -d "1 hour ago" "+%Y-%m-%d %H:%M:%S")
END=$(date "+%Y-%m-%d %H:%M:%S")

aliyun rds DescribeRCMetricList \
  --region cn-beijing \
  --InstanceId rc-<INSTANCE_ID> \
  --MetricName CPUUtilization \
  --StartTime "$START" \
  --EndTime "$END" \
  --Period 300

使用 jq 提取数据

# 提取 CPU 使用率数据点
aliyun rds DescribeRCMetricList \
  --region cn-beijing \
  --InstanceId rc-xxx \
  --MetricName CPUUtilization \
  --StartTime "2026-03-12 10:05:00" \
  --EndTime "2026-03-12 10:15:00" \
  | jq '.Data[] | {Timestamp, Value}'

# 计算平均 CPU 使用率
aliyun rds DescribeRCMetricList \
  --region cn-beijing \
  --InstanceId rc-xxx \
  --MetricName CPUUtilization \
  --StartTime "2026-03-12 10:05:00" \
  --EndTime "2026-03-12 10:15:00" \
  | jq '[.Data[].Value | tonumber] | add / length'

输出字段说明

| 字段 | 说明 |

|------|------|

| 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`、`cn-shanghai`

3. CLI 未安装

bash: aliyun: command not found

**解决：** 参考前置条件安装 aliyun CLI

4. 返回空列表

{"RCInstances": [], "TotalCount": 0}

**解决：**

检查地域是否正确

确认当前账号下是否有 RC 实例

尝试其他地域查询

参考资料

[阿里云 CLI 文档](https://help.aliyun.com/product/29987.html)

[RDS API 文档](https://help.aliyun.com/document_detail/26223.html)

[OpenAPI 门户](https://api.aliyun.com/api?product=Rds&api=DescribeRCInstances)

// Comments

// Related skills

More tools from the same signal band

Order food/drinks (点餐) on an Android device paired as an OpenClaw node. Uses in-app menu and cart; add goods, view cart, submit order (demo, no real payment).

Sign plugins, rotate agent credentials without losing identity, and publicly attest to plugin behavior with verifiable claims and authenticated transfers.

The philosophical layer for AI agents. Maps behavior to Spinoza's 48 affects, calculates persistence scores, and generates geometric self-reports. Give your...

日历管理数据处理

1 installs★ 0