用途
awsflow-rds 是一个用于管理和检查 Amazon RDS 资源的技能。当用户询问 RDS 数据库实例或 Aurora 集群、需要查看快照/备份/复制情况、查看数据库日志或事件、了解参数组/子网组/安全组、检查引擎版本或实例选项与建议、检查 RDS 代理或蓝绿部署,或者需要创建、修改、启动、停止、删除数据库实例或集群、创建快照或从快照恢复时,可以使用该技能。
主要能力
该技能通过工具 RDSTool 执行 AWS RDS 命令,其中包含生命周期操作。使用时始终需要提供 params 对象。
描述与查询类命令
- DescribeDBInstances:描述 RDS 数据库实例。参数包括 DBInstanceIdentifier(可选)、Filters(可选,含 Name 和 Values[])、Marker(可选)、MaxRecords(可选)。
- DescribeDBClusters:描述 Aurora 数据库集群。参数包括 DBClusterIdentifier(可选)、Filters(可选)、Marker(可选)、MaxRecords(可选)。
- DescribeDBSnapshots:描述数据库实例快照。参数包括 DBInstanceIdentifier(可选)、Filters、Marker、MaxRecords。
- DescribeDBClusterSnapshots:描述 Aurora 集群快照。参数包括 DBClusterIdentifier(可选)、Filters、Marker、MaxRecords。
- DescribeDBEngineVersions:描述可用数据库引擎版本。参数包括 Engine(可选,如 mysql、postgres、aurora-mysql 等)、EngineVersion(可选)、Marker、MaxRecords。
- DescribeDBLogFiles:列出数据库实例的日志文件。DBInstanceIdentifier 为必填,Marker、MaxRecords 可选。
- DownloadDBLogFilePortion:下载数据库日志文件的某一部分。DBInstanceIdentifier 与 LogFileName 均为必填(LogFileName 来自 DescribeDBLogFiles),Marker、MaxRecords 可选。
- DescribeDBParameterGroups:列出数据库参数组。DBParameterGroupName 可选,另有 Marker、MaxRecords。
- DescribeDBClusterParameterGroups:列出 Aurora 集群参数组。
- DescribeDBSubnetGroups:列出数据库子网组。
- DescribeDBSecurityGroups:列出数据库安全组(EC2-Classic)。
- DescribeDBProxies:列出 RDS 代理实例。参数包括 Filters、Marker、MaxRecords。
- DescribeDBProxyEndpoints:列出 RDS 代理端点。
- DescribeDBSnapshotAttributes:获取快照的共享权限。
- DescribeDBInstanceAutomatedBackups:列出数据库实例的自动备份。
- DescribeDBClusterAutomatedBackups:列出 Aurora 集群的自动备份,DBClusterIdentifier 可选。
- DescribeDBRecommendations:列出 RDS 建议。
生命周期命令
- CreateDBInstance:创建数据库实例,示例参数包括 DBInstanceIdentifier、DBInstanceClass、Engine、MasterUsername、MasterUserPassword。
- ModifyDBInstance:修改数据库实例,示例参数包括 DBInstanceIdentifier、AllocatedStorage。
- StartDBInstance:启动已停止的数据库实例。
- StopDBInstance:停止数据库实例。
- DeleteDBInstance:删除数据库实例,示例参数包括 DBInstanceIdentifier、SkipFinalSnapshot。
- CreateDBSnapshot:创建数据库快照,参数包括 DBInstanceIdentifier、DBSnapshotIdentifier。
- RestoreDBInstanceFromDBSnapshot:从快照恢复数据库实例,参数包括 DBInstanceIdentifier、DBSnapshotIdentifier。
- AddTagsToResource:为 RDS 资源添加标签,参数包括 ResourceName、Tags(数组,含 Key 和 Value)。
- RemoveTagsFromResource:移除资源标签,参数包括 ResourceName、TagKeys。
其他命令
- DescribeBlueGreenDeployments:列出蓝绿部署资源。
- DescribeEvents:列出 RDS 事件。参数包括 StartTime、EndTime、Duration(分钟)、Marker、MaxRecords(均为可选)。
- DescribeEventSubscriptions:列出 RDS 事件订阅。
- DescribeOrderableDBInstanceOptions:列出可用的数据库实例选项。参数包括 Engine(可选)、EngineVersion(可选)。
- DescribeAccountAttributes:获取 RDS 账户属性与配额。
- DescribeCertificates:列出 RDS 证书。
- DescribeEngineDefaultParameters:获取默认引擎参数设置。
- DescribeExportTasks:列出快照导出任务。
- DescribeGlobalClusters:列出 Aurora 全局数据库集群。
- DescribeIntegrations:列出 zero-ETL 集成。
- DescribeOptionGroups:列出选项组。
- DescribePendingMaintenanceActions:列出待处理的维护操作。
- DescribeReservedDBInstances:列出预留数据库实例。
- DescribeReservedDBInstancesOfferings:列出预留数据库实例产品。
- DescribeSourceRegions:列出跨区域功能的源区域。
- DescribeTenantDatabases:列出租户数据库。
- DescribeValidDBInstanceModifications:获取数据库实例的有效修改项。DBInstanceIdentifier 为必填。
- ListTagsForResource:列出 RDS 资源的标签。ResourceName(资源 ARN)为必填。
资料中另有说明:DescribeResourceScan / DescribeStackRefactor 等额外 describe 命令遵循相同模式,配合适当的过滤与分页。
使用方式
该技能通过 RDSTool 执行命令,命令采用 JSON 形式,例如:
{ "command": "DescribeDBInstances", "params": { "DBInstanceIdentifier": "my-db" } }
{ "command": "CreateDBInstance", "params": { "DBInstanceIdentifier": "my-db", "DBInstanceClass": "db.t3.micro", "Engine": "mysql", "MasterUsername": "admin", "MasterUserPassword": "Secret1234!" } }
使用生命周期操作时,需要提供相应的 params 对象。具体命令与参数以上述能力说明为准。
适用场景
- 查询和巡检 RDS 实例与 Aurora 集群的名录与配置。
- 查看快照、自动备份、标签与共享权限,处理备份与恢复任务。
- 查看数据库日志文件与日志片段、RDS 事件与事件订阅。
- 管理参数组、子网组、安全组、选项组与证书。
- 检查引擎版本、可订购实例选项、账户属性与配额、待处理维护操作、预留实例与建议。
- 检查 RDS 代理、代理端点、蓝绿部署、全局集群、zero-ETL 集成与租户数据库。
- 执行创建、修改、启动、停止、删除数据库实例、创建快照与从快照恢复等生命周期操作。
与其他服务的关联
- RDS → CloudWatch Logs:数据库日志(错误、慢查询、审计)会发布到 CloudWatch,日志组为 /aws/rds/instance/{instanceId}/{logType} 或 /aws/rds/cluster/{clusterId}/{logType},可使用 CloudWatchLogTool 读取。
- RDS → RDS Data API:对于启用了 Data API 的 Aurora Serverless 集群,可使用 RDSDataTool 直接执行 SQL(参见 awsflow-rdsdata 技能)。
- RDS → EC2:RDS 使用 VPC、子网与安全组,可使用 EC2Tool 检查网络。
- RDS → IAM:RDS 可启用 IAM 身份验证,可使用 IAMTool 管理访问。
- RDS → CloudFormation:由 CloudFormation 栈管理的 RDS 资源。
- RDS → S3:快照导出会写入 S3,可使用 DescribeExportTasks 查找。
限制
资料未提供关于定价、权限模型细节、区域可用性、配额上限或错误处理方式的更多说明,这些内容暂未提供。