# 查询DDM逻辑库详细信息 #### 功能介绍 查询指定逻辑库的详细信息。 #### 接口约束 无 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ShowDatabase)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### URI GET /v1/{project_id}/instances/{instance_id}/databases/{ddm_dbname} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 | | instance_id | 是 | String | DDM实例ID。 | | ddm_dbname | 是 | String | 需要查询的逻辑库名称，不区分大小写。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 | #### 响应参数 **状态码： 200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | database | [GetDatabaseResponseBean] object | 逻辑库信息。 | 表4GetDatabaseResponseBean | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 逻辑库名称。 | | created | Long | 逻辑库的创建时间，UNIX时间戳格式，单位是毫秒。 | | status | String | 状态。 | | updated | Long | 逻辑库最后更新时间，UNIX时间戳格式，单位是毫秒。 | | databases | Array of [GetDatabases] objects | 逻辑库分片的详细信息。 | | shard_mode | String | 逻辑库的工作模式。 - cluster表示逻辑库是拆分模式。 - single表示逻辑库是非拆分模式。 | | shard_number | Integer | 同一种工作模式下逻辑库分片的数量。 | | shard_unit | Integer | 单个RDS上的逻辑库分片数。 | | dataVips | Array of strings | 连接逻辑库使用的IP:端口。 | | used_rds | Array of [GetDatabaseUsedRds] objects | 关联RDS。 | 表5GetDatabases | 参数 | 参数类型 | 描述 | |:---|:---|:---| | dbslot | Integer | 分片数。 | | name | String | 分片名称。 | | status | String | 逻辑库状态。 | | created | Long | 创建时间，UNIX时间戳格式，单位是毫秒。 | | updated | Long | 最近更新时间，UNIX时间戳格式，单位是毫秒。 | | id | String | 所在RDS的ID。 | | idName | String | 物理库的名称。 | 表6GetDatabaseUsedRds | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 关联RDS节点ID。 | | name | String | 关联RDS名称。 | | status | String | 关联RDS状态。 | | error_msg | String | 响应信息，若无异常信息则不返回该参数。 | **状态码： 400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 业务错误码。 | | externalMessage | String | 错误信息。 | **状态码： 500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | errCode | String | 业务错误码。 | | externalMessage | String | 错误信息。 | #### 请求示例 查询逻辑库详细信息。 ``` GET https://{endpoint} /v1/{project_id}/instances/{instance_id}/databases/{ddm_dbname} ``` #### 响应示例 **状态码： 200** OK ``` { "database" : { "name" : "db_7567", "created" : "1604631243234", "status" : "RUNNING", "updated" : "1604631243234", "databases" : [ { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0000", "idName" : "db_7567_0000", "dbslot" : 0, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0001", "idName" : "db_7567_0001", "dbslot" : 1, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0002", "idName" : "db_7567_0002", "dbslot" : 2, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0003", "idName" : "db_7567_0003", "dbslot" : 3, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0004", "idName" : "db_7567_0004", "dbslot" : 4, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0005", "idName" : "db_7567_0005", "dbslot" : 5, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0006", "idName" : "db_7567_0006", "dbslot" : 6, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 }, { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "db_7567_0007", "idName" : "db_7567_0007", "dbslot" : 7, "status" : "RUNNING", "created" : 1604631243234, "updated" : 1604631243234 } ], "shard_mode" : "cluster", "shard_number" : 8, "shard_unit" : 8, "dataVips" : [ "192.168.185.97:5066" ], "used_rds" : [ { "id" : "e70a82534a364492b795c5080e3a1591in01", "name" : "rds-5338", "status" : "normal" } ] } } ``` **状态码： 400** bad request ``` { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } ``` **状态码： 500** server error ``` { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | bad request | | 500 | server error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。