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 例項、監控指標、資源配置等場景。

核心能力

支援的查詢命令

暫不支援的命令

以下命令在 Java SDK 中存在，但在 aliyun CLI v3.2.13 中暫不支援：

特性

• 多地域支援：支援指定地域查詢，預設 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 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'

輸出欄位說明

查詢磁碟列表

基本查詢

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'

輸出欄位說明

查詢快照列表

基本查詢

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 提取欄位

7w4.net收錄了海量優質技能外掛。

# 提取快照基本資訊
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'

輸出欄位說明

監控指標查詢

查詢 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

常用指標名稱

引數說明

示例：查詢最近 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'

輸出欄位說明

常見問題

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 文件
• RDS API 文件
• OpenAPI 門戶

這個 Skill 專門用於查詢阿里雲 RDS 自定義例項，功能定位清晰明確。文件內容詳實，提供了清晰的使用說明和操作示例，輔助指令碼可以幫助快速獲取例項資訊。整體質量良好，但功能覆蓋面有限，輔助指令碼能實現的功能較少，且文件中對某些不支援的功能缺少明確的替代操作指引。對於需要深度管理 RC 例項的使用者來說，可能需要額外查閱阿里雲官方文件補充操作方法。