如何查询 DRDS 数据库
功能描述
查询 DRDS 数据库详情。
请求参数
| [backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]是否必须 | [backcolor=transparent]说明 |
| Action | String | 是 | 系统规定参数，取值：DescribeDrdsDB |
| DbName | String | 是 | 分布式数据库的名称 |
| DrdsInstanceId | String | 是 | DRDS 实例 ID |
返回值
| [backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]描述 |
| 公共返回值 | ||
| DbName | String | |
| Status | String | 0-建库中 1-正常 2-建库失败 3-删除中 4-删除失败 5-迁移中 6-迁移失败 |
| CreateTime | String | |
| Msg | String | 状态的详情，如果是错误状态，则包含错误信息 |
| Mode | String | 运行模式 |
错误码
| [backcolor=transparent]错误 | [backcolor=transparent]错误代码 | [backcolor=transparent]描述 | [backcolor=transparent]HTTP 状态码 |
| 通用错误码 | |||
| 实例不存在 | InvalidDRDSInstanceId.NotFound | The DrdsInstanceId provided does not exist in our records. | 404 |
| 指定的实例上不存在指定的分布式数据库 | InvalidDbName.NotFound | The Drds DbName provided does not exist in our records. | 404 |
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
您提到的功能描述是关于使用阿里云分布式关系型数据库服务（DRDS）查询特定数据库详情的API操作。下面是对这一操作的详细说明，包括请求参数、返回值以及可能遇到的错误码解析。
功能描述
此功能允许用户通过调用阿里云DRDS API来获取指定DRDS实例上的某个分布式数据库的详细信息，包括但不限于数据库名称（DbName）、状态（Status）、创建时间（CreateTime）、状态详情信息（Msg）、运行模式（Mode）等。
请求参数
- Action: 必须参数，固定值
DescribeDrdsDB，表示执行查询DRDS数据库详情的操作。 - DbName: 必须参数，类型为String，表示需要查询的分布式数据库的名称。
- DrdsInstanceId: 必须参数，类型为String，表示DRDS实例的ID，用于定位到具体的DRDS实例。
返回值
成功响应时，API将返回以下关键参数： - DbName: 分布式数据库的名称。 - Status: 数据库的状态，取值范围如下： - 0: 建库中 - 1: 正常 - 2: 建库失败 - 3: 删除中 - 4: 删除失败 - 5: 迁移中 - 6: 迁移失败 - CreateTime: 数据库的创建时间。 - Msg: 状态的详细描述信息，如果数据库处于错误状态，则该字段包含错误的具体信息。 - Mode: 数据库的运行模式。
错误码
在调用过程中，可能会遇到以下错误情况： - InvalidDRDSInstanceId.NotFound: 错误代码，表示提供的DrdsInstanceId不存在于系统记录中。HTTP状态码为404。 - InvalidDbName.NotFound: 错误代码，表示在指定的DRDS实例上找不到提供的DbName所对应的分布式数据库。HTTP状态码同样为404。
这些错误码提示用户在请求中可能存在参数输入错误或请求的目标资源不存在，请根据错误信息检查并修正请求参数后重试。
