awsclaw-rds

用途

awsclaw-rds 是 awsclaw 技能组中的一个技能，用于管理和检查 Amazon RDS 相关资源。该技能通过名为 RDSTool 的工具执行 AWS RDS 命令，命令类型覆盖查询类操作和生命周期操作。根据资料，当用户需要了解 RDS 数据库实例或 Aurora 集群、查看快照与备份或复制情况、查看数据库日志或事件、检查参数组/子网组/安全组、核对引擎版本与实例选项或建议、查看 RDS Proxy 或蓝绿部署，以及创建、修改、启动、停止、删除数据库实例或集群、创建快照或从快照恢复时，适用此技能。

主要能力

查询与检查

DescribeDBInstances：描述 RDS 数据库实例，可传入 DBInstanceIdentifier、Filters、Marker、MaxRecords。
DescribeDBClusters：描述 Aurora 数据库集群，可传入 DBClusterIdentifier、Filters、Marker、MaxRecords。
DescribeDBSnapshots：描述数据库实例快照。
DescribeDBClusterSnapshots：描述 Aurora 集群快照。
DescribeDBEngineVersions：查询可用的数据库引擎版本，可指定 Engine（如 mysql、postgres、aurora-mysql 等）与 EngineVersion。
DescribeDBLogFiles：列出数据库实例的日志文件，DBInstanceIdentifier 为必填。
DownloadDBLogFilePortion：下载数据库日志文件的一部分，DBInstanceIdentifier 与 LogFileName 均为必填，日志文件名来自 DescribeDBLogFiles。
DescribeDBParameterGroups、DescribeDBClusterParameterGroups：列出数据库参数组与 Aurora 集群参数组。
DescribeDBSubnetGroups：列出数据库子网组。
DescribeDBSecurityGroups：列出数据库安全组（EC2-Classic）。
DescribeDBProxies、DescribeDBProxyEndpoints：列出 RDS Proxy 实例与端点。
DescribeDBSnapshotAttributes：获取快照的共享权限。
DescribeDBInstanceAutomatedBackups、DescribeDBClusterAutomatedBackups：列出实例与 Aurora 集群的自动备份。
DescribeDBRecommendations：列出 RDS 建议。
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：列出预留数据库实例及其 offerings。
DescribeSourceRegions：列出跨区域功能可用的源区域。
DescribeTenantDatabases：列出租户数据库。
DescribeValidDBInstanceModifications：获取数据库实例的有效修改项，DBInstanceIdentifier 为必填。
DescribeResourceScan / DescribeStackRefactor 等：其他 describe 命令遵循相同的筛选与分页模式。
ListTagsForResource：列出 RDS 资源的标签，ResourceName（资源 ARN）为必填。

生命周期操作

CreateDBInstance：创建数据库实例，示例参数包括 DBInstanceIdentifier、DBInstanceClass、Engine、MasterUsername、MasterUserPassword。
ModifyDBInstance：修改数据库实例。
StartDBInstance：启动已停止的数据库实例。
StopDBInstance：停止数据库实例。
DeleteDBInstance：删除数据库实例，示例中使用 SkipFinalSnapshot。
CreateDBSnapshot：创建数据库快照。
RestoreDBInstanceFromDBSnapshot：从快照恢复数据库实例。
AddTagsToResource：为 RDS 资源添加标签，参数为 ResourceName 与 Tags 数组。
RemoveTagsFromResource：移除资源标签，参数为 ResourceName 与 TagKeys 数组。

使用方式

该技能通过 RDSTool 执行命令。资料强调：始终提供 params 对象。命令以 JSON 形式给出，例如：

{ "command": "DescribeDBInstances", "params": { "DBInstanceIdentifier": "my-db" } }

{ "command": "CreateDBInstance", "params": { "DBInstanceIdentifier": "my-db", "DBInstanceClass": "db.t3.micro", "Engine": "mysql", "MasterUsername": "admin", "MasterUserPassword": "Secret1234!" } }

{ "command": "DescribeDBLogFiles", "params": { "DBInstanceIdentifier": "my-db" } }

{ "command": "DownloadDBLogFilePortion", "params": { "DBInstanceIdentifier": "my-db", "LogFileName": "error/mysql-error.log" } }

常见参数包括 DBInstanceIdentifier、DBClusterIdentifier、Filters（由 Name 与 Values[] 组成的对象数组）、Marker（分页标记）、MaxRecords（返回记录上限）等。参数是否必填随命令不同而不同，例如 DescribeDBLogFiles 与 DownloadDBLogFilePortion 要求 DBInstanceIdentifier，ListTagsForResource 要求 ResourceName。

适用场景

查看 RDS 实例或 Aurora 集群的配置与状态。
检查快照、备份与复制情况，创建快照或从快照恢复。
查看数据库日志文件并下载日志片段。
检查参数组、子网组与安全组。
查询引擎版本、实例选项与 RDS 建议。
查看 RDS Proxy 与蓝绿部署。
执行实例或集群的创建、修改、启动、停止、删除等生命周期操作。
为 RDS 资源添加或移除标签。

限制

资料未提供该技能的安装方式、收费模式、平台支持范围及性能指标等信息，暂未提供。各命令的完整参数集合与返回结构，以 AWS RDS API 实际定义为准，资料中仅列出了部分常用参数。

技能介绍

用途