功能描述
查询 DRDS 库的所有分库。
请求参数
[backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]是否必须 | [backcolor=transparent]说明 |
Action | String | 是 | 系统规定参数,取值:DescribeShardDBs |
DrdsInstanceId | String | 是 | DRDS 实例 ID |
DbName | String | 是 | 数据库名 |
[backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]描述 |
公共返回值 | ||
Data | List<DbIntancePair> | 由 RdsInstance 组成的数组 |
[backcolor=transparent]参数名 | [backcolor=transparent]类型 | [backcolor=transparent]描述 |
SubDbName | String | 分库名 |
InstanceName | String | RDS 实例名 |
[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 |
参数错误 | InvalidParameter.Mismatch | The specified parameter does not match. | 400 |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您提供的信息,这是关于阿里云分布式关系型数据库服务(DRDS)中查询所有分库的操作描述。下面是对这一功能请求、返回值以及可能遇到的错误码的详细解析:
此功能允许用户查询指定DRDS实例下的某个数据库的所有分库信息。DRDS通过将单个数据库横向拆分为多个分库来实现数据的水平扩展,提高处理能力和存储容量。
DescribeShardDBs
,表示请求的操作类型是查询分库。成功响应时,返回的数据结构包含一个名为DataList
的数组,该数组由多个RdsInstance
对象组成,每个对象代表一个分库的信息: - SubDbName: 分库名称。 - InstanceName: 与该分库关联的RDS实例名称。
在调用接口过程中,可能会遇到以下错误: 1. InvalidDrdsInstanceId.NotFound: 错误代码,表示提供的DrdsInstanceId
不存在,即请求的DRDS实例ID在系统中未找到。HTTP状态码为404。 2. InvalidDbName.NotFound: 错误代码,意味着提供的数据库名DbName
在DRDS记录中不存在。同样返回404状态码。 3. InvalidParameter.Mismatch: 参数不匹配错误,当指定的某个参数不符合要求时触发。例如,参数格式错误等。HTTP状态码为400。
希望这些信息能帮助您顺利使用阿里云DRDS的查询分库功能。