查询DDM逻辑库详细信息
功能介绍
查询指定逻辑库的详细信息。
接口约束
无
URI
GET /v1/{project_id}/instances/{instance_id}/databases/{ddm_dbname}
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID。 |
instance_id |
是 |
String |
DDM实例ID。 |
ddm_dbname |
是 |
String |
需要查询的逻辑库名称，不区分大小写。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
database |
GetDDMDatabaseResponseBean object |
逻辑库信息。 |
参数 |
参数类型 |
描述 |
|---|---|---|
name |
String |
逻辑库名称。 |
created |
String |
逻辑库的创建时间。 |
status |
String |
状态。 |
updated |
String |
DDM实例最后更新时间。 |
databases |
Array of GetDDMDatabases objects |
逻辑库分片的详细信息。 |
shard_mode |
String |
逻辑库的工作模式。
|
shard_number |
Integer |
同一种工作模式下逻辑库分片的数量。 |
shard_unit |
Integer |
单个RDS上的逻辑库分片数。 |
dataVips |
Array of strings |
连接逻辑库使用的IP:端口。 |
used_rds |
Array of GetDDMDatabaseUsedrds objects |
关联RDS。 |
参数 |
参数类型 |
描述 |
|---|---|---|
dbslot |
Integer |
分片数。 |
name |
String |
分片名称。 |
status |
String |
状态。 |
created |
String |
创建时间。 |
updated |
String |
最近更新时间。 |
id |
String |
所在RDS的id。 |
idName |
String |
所在RDS的名称。 |
参数 |
参数类型 |
描述 |
|---|---|---|
id |
String |
关联RDS节点ID。 |
name |
String |
关联RDS名称。 |
status |
String |
关联RDS状态。 |
error_msg |
String |
响应信息，若无异常信息则不返回该参数。 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
errCode |
String |
业务错误码 |
externalMessage |
String |
错误信息 |
请求示例
GET https://{endpoint} /v1/{project_id}/instances/{instance_id}/databases/{ddm_dbname}
响应示例
状态码： 200
OK
{
"database" : {
"databases" : [ "id：ea81976b12e84d57822209169caddc11in01", "name：db_2305", "idName：db_2305", "status：RUNNING", "dbSlot：0", "created：1603861296004", "updated：1603861296004" ],
"dataVips" : [ "92.168.0.175:5066" ],
"status" : "RUNNING",
"created" : "0f58c8dc-4a78-42e6-9811-565679de8e9e",
"name" : "db_2305",
"updated" : "1604282063035",
"shard_mod" : "single",
"shard_number" : "1",
"shard_unit" : "1",
"used_rds" : [ "id：ea81976b12e84d57822209169caddc11in01", "status：RUNNING", "nam：rds-94c3-wuli" ]
}
}
状态码： 400
bad request
{
"externalMessage" : "Parameter error.",
"errCode" : "DBS.280001"
}
状态码
请参见状态码。
错误码
请参见错误码。
