hcs-rds-instances

该 Skill 通过 Python 脚本调用华为云 RDS v3 接口，列出指定区域的 RDS 实例，可按实例名称前缀、实例 ID、引擎类型过滤；默认输出 JSON，也可输出 Markdown 表格，并提供 mock 模式用于无凭证验证。真实调用需通过环境变量提供 AK/SK。

yangaiwu

热度 11.17

最近更新 2026-08-20 06:02:35

分类：搜索依赖：代码执行 / 第三方 API应用场景：DevOps

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add hcs-rds-instances

Metadata

name: hcs-rds-instances
version: 0.1.0
description: 查询华为云 RDS 实例列表，支持列出指定 region 下 RDS 实例（实例ID/名称/引擎/版本/状态/规格/region），可选按名称/ID/引擎类型过滤。
triggers: ["查询华为云RDS","列出RDS实例","RDS实例列表","华为云数据库实例查询"]
tags: ["huawei-cloud","rds","query"]

hcs-rds-instances

查询华为云 RDS（关系型数据库服务）实例的技能，提供一个能力：

能力 A：列出指定 region 下 RDS 实例列表，可选按实例名称、实例 ID、引擎类型过滤。

环境变量（认证）

真实调用前需设置（不硬编码密钥）：

变量	必填	说明
`HWCLOUD_AK`	是	华为云 Access Key
`HWCLOUD_SK`	是	华为云 Secret Key
`HWCLOUD_PROJECT_ID`	否	项目 ID，缺省由 AK/SK 解析默认项目

使用

# 能力 A：列出 RDS 实例（默认区域 cn-north-4）
python3 scripts/hcs-rds-instances.py list --region cn-north-4

# 按实例名称过滤（前缀匹配）
python3 scripts/hcs-rds-instances.py list --name prod

# 按引擎类型过滤（MySQL/PostgreSQL/SQLServer）
python3 scripts/hcs-rds-instances.py list --datastore-type MySQL

# 按实例 ID 过滤
python3 scripts/hcs-rds-instances.py list --instance-id rds-1234567890abcdef

# Markdown 表格输出
python3 scripts/hcs-rds-instances.py list --format md

# 无凭证验证（内置模拟数据）
python3 scripts/hcs-rds-instances.py list --mock

输出

默认 JSON，字段：

{
  "capability": "list",
  "region": "cn-north-4",
  "project_id": null,
  "count": 2,
  "instances": [
    {"id": "rds-xxx", "name": "prod-mysql-01", "engine": "MySQL",
     "engine_version": "8.0", "status": "ACTIVE",
     "flavor_ref": "rds.mysql.c2.large.2.rds", "region": "cn-north-4"}
  ]
}

--format md 输出 Markdown 表格（实例ID/名称/引擎/引擎版本/状态/规格/区域）。

退出码

码	含义
0	成功
2	参数错误
3	缺少认证（未设置 HWCLOUD_AK/HWCLOUD_SK）
4	API 调用失败

依赖

Python 3.8+
真实调用：huaweicloudsdkrds（见 requirements.txt）
mock 模式无需任何第三方依赖

实现说明

使用华为云 RDS SDK v3 的 ListInstancesRequest 接口（GET /v3/{project_id}/instances），支持 limit + offset 分页。

归一化字段映射：

id — 实例 ID
name — 实例名称
engine — 引擎类型（datastore.type，如 MySQL/PostgreSQL/SQLServer）
engine_version — 引擎版本（datastore.version）
status — 实例状态（ACTIVE/STOPPED 等）
flavor_ref — 规格编码
region — 区域

详见 references/rds-instance-api.md。