SuperAPI AI 工具集

alicloud-database-analyticdb-mysql

数据与分析

查看项目

更新于 10-15 09:33

技能介绍

用途

该技能用于通过阿里云 OpenAPI(RPC)管理 AnalyticDB for MySQL(ADB)资源。适用于用户需要执行 AnalyticDB 资源生命周期与配置操作的场景,包括资源清单查询、配置变更和状态诊断。

主要能力

技能围绕阿里云 OpenAPI 展开,配合官方 SDK 或 OpenAPI Explorer 使用。产品代码为 adb,默认 API 版本为 2021-12-01。可通过 OpenAPI 元数据端点列出 API 并获取 schema。高频操作模式包括:清单/列表优先使用 List* / Describe* API;变更/配置优先使用 Create* / Update* / Modify* / Set* API;状态/排障优先使用 Get* / Query* / Describe*Status API。

使用方式

工作流程为:先确认地域、资源标识和期望动作;再发现 API 列表与必需参数;随后用 SDK 或 OpenAPI Explorer 调用 API;最后用 describe/list API 验证结果。凭证优先级必须遵循:优先使用环境变量 ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET,ALICLOUD_REGION_ID 为可选默认;其次使用共享配置文件 ~/.alibabacloud/credentials。若未设置地域,应为任务选择最合理的地域,若不明确则询问用户。

快速开始采用元数据优先发现:运行 python scripts/list_openapi_meta_apis.py,可选覆盖参数 --product-code 与 --version。脚本会把 API 清单产物写入技能输出目录。

输出与验证

如需保存响应或生成的产物,应写入 output/alicloud-database-analyticdb-mysql/ 目录。验证方式为:创建该输出目录,对 scripts 目录下的每个 .py 文件执行 py_compile,并在输出目录生成 validate.txt;通过标准为命令退出码为 0 且 validate.txt 已生成。证据文件应包含关键参数(地域/资源 id/时间范围)以便复现。

适用场景

适用于需要通过编程方式管理 AnalyticDB for MySQL 资源的生命周期、配置和诊断任务的场景,例如资源盘点、配置变更和运行状态排障。

限制

执行前需配置最小权限的阿里云凭证。若地域不明确,在执行变更类操作前必须先询问用户。必须遵循 AccessKey 的优先顺序。产物与证据需保存在指定输出目录中。