查询DDM逻辑库列表
功能介绍
查询DDM逻辑库列表。
接口约束
无
URI
GET /v1/{project_id}/instances/{instance_id}/databases
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID。 |
| instance_id | 是 | String | DDM实例ID。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| offset | 否 | Number | 分页参数:起始值 [大于等于0] 。 最小值:0 |
| limit | 否 | Number | 分页参数:每页多少条 [大于0且小于等于128]。 最小值:1 最大值:128 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| databases | Array of GetDDMDatabaseInfo objects | 逻辑库相关信息的集合。 |
| total | Integer | 总条数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | 逻辑库名称。 |
| shard_mode | String | 逻辑库的工作模式。
|
| shard_number | Integer | 同一种工作模式下逻辑库分片的数量。 |
| status | String | 逻辑库状态。 |
| created | String | 逻辑库的创建时间。 |
| used_rds | Array of GetDDMDatabaseUsedrds objects | 逻辑库关联的RDS实例信息。 |
| shard_unit | Integer | 单个RDS上的逻辑库分片数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 关联RDS节点ID。 |
| name | String | 关联RDS名称。 |
| status | String | 关联RDS状态。 |
| error_msg | String | 响应信息,若无异常信息则不返回该参数。 |
状态码: 400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 业务错误码 |
| error_msg | String | 错误信息 |
状态码: 500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| errCode | String | 业务错误码 |
| error_msg | String | 错误信息 |
请求示例
GET https://{endpoint}/v1/{project_id}/instances/{instance_id}/databases?offset={offset}&limit={limit} 响应示例
状态码: 400
bad request
{
"error_code": "DDM.1008",
"error_msg": "This DDM instance does not exist"
} 状态码: 500
Server failure
{
"error_code": "DDM.2061",
"error_msg": "Server failure"
} 状态码
请参见状态码。
错误码
请参见错误码。