如何查看指定实例的 DB 列表

您描述的是阿里云分布式关系型数据库服务（DRDS）中，通过调用API来查看指定DRDS实例下数据库列表的功能。下面是对这一功能请求参数、返回值以及DRDS DB组成结构和可能遇到的错误码的详细解析：

请求参数

1. Action - 类型：String，是否必须：是

   • 说明：系统规定参数，用于指定要执行的操作，此处应填写 DescribeDrdsDBs 以查询DRDS实例的数据库列表。

2. DrdsInstanceId - 类型：String，是否必须：是

   • 说明：DRDS实例的ID，用于指定要查询哪个DRDS实例下的数据库列表。

返回值

• Items - 类型：List，描述：返回的DrdsDB对象列表，包含了所查询到的数据库信息。

DRDS DB 组成结构

每个DrdsDB对象包含以下属性：

1. DbName - 类型：String，描述：数据库名称。
2. Status - 类型：String，描述：数据库状态，包括但不限于：
   • 0：建库中
   • 1：正常
   • 2：建库失败
   • 3：删除中
   • 4：删除失败
   • 5：迁移中
   • 6：迁移失败
3. CreateTime - 类型：Long，描述：数据库创建时间的时间戳。
4. Msg - 类型：String，描述：状态的详情信息，如果状态为错误，则此字段包含具体的错误信息。
5. Mode - 类型：String，描述：数据库的运行模式。

错误码示例

• 错误：实例不存在
• 错误代码：InvalidDrdsInstanceId.NotFound
• 描述：提供的DrdsInstanceId在记录中不存在。
• HTTP 状态码：404

这意味着如果请求中指定的DRDS实例ID无效或不存在于阿里云系统中，将会收到一个404错误响应，并附带上述错误代码和描述。

使用该API时，请确保你有正确的DRDS实例ID，并且对该实例有查询权限。此外，根据实际需求，可以进一步处理返回的数据，比如筛选出状态为“正常”的数据库等。