调用ListDatabases获取一个实例下的数据库列表详情信息

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListDatabases

系统规定参数。取值:ListDatabases。

InstanceId String 1

实例ID

PageNumber Integer 1

第几页

Tid Long -1

DMS企业版租户ID

PageSize Integer 10

每页记录数

返回数据

名称 类型 示例值 描述
DatabaseList

数据库详情列表

Database

数据库详情列表

CatalogName String 1

库CatalogName

DatabaseId String 1

库ID

DbType String mysql

数据库类型

DbaId String 1

库所属dba id

DbaName String dba_user

库所属dba昵称

Encoding String utf-8

库编码

EnvType String dev

库所属环境类型

Host String xxx.xxx.xxx.xxx

库所属实例连接地址

InstanceId String 1

库所属实例ID

OwnerIdList 1

库Owner id列表

OwnerIds

库Owner id列表

OwnerNameList owner_name

库Owner昵称列表

OwnerNames

库Owner昵称列表

Port Integer 3306

库所属实例连接端口

SchemaName String test

库名

SearchName String test@xxx.xxx.xxx.xxx:3306

库搜索名

Sid String test

库所属实例sid

State String NORMAL

库状态,取值和说明如下:

  • NORMAL: 正常
  • DISABLE:禁用
  • OFFLINE:下线
  • NOT_EXIST:不存在
ErrorCode String UnknownError

错误码

ErrorMessage String UnknownError

错误信息

RequestId String 5541CDA6-F674-435C-81BD-40C2FB926CE3

请求ID

Success Boolean true

请求是否成功

TotalCount Long 1

实例下面的库个数

示例

请求示例


http(s)://[Endpoint]/?Action=ListDatabases
&InstanceId=1
&PageNumber=1
&Tid=-1
&<公共请求参数>

正常返回示例

XML 格式

<TotalCount>1</TotalCount>
<RequestId>5541CDA6-F674-435C-81BD-40C2FB926CE3</RequestId>
<Success>true</Success>
<DatabaseList>
    <Database>
        <Encoding>utf8</Encoding>
        <Host>pc-xxx.rwlb.rds.aliyuncs.com</Host>
        <InstanceId>24710</InstanceId>
        <DbType>polardb</DbType>
        <EnvType>product</EnvType>
        <OwnerIdList>
            <OwnerIds>88653</OwnerIds>
        </OwnerIdList>
        <DbaId>104442</DbaId>
        <OwnerNameList>
            <OwnerNames>dmstest</OwnerNames>
        </OwnerNameList>
        <Port>3306</Port>
        <DatabaseId>116366</DatabaseId>
        <State>NORMAL</State>
        <SearchName>xxx_test@pc-xxx.rwlb.rds.aliyuncs.com:3306【xxx_test】</SearchName>
        <DbaName>xxx[子账号]</DbaName>
        <SchemaName>xxx_test</SchemaName>
    </Database>
</DatabaseList>

JSON 格式

{
	"TotalCount":1,
	"RequestId":"5541CDA6-F674-435C-81BD-40C2FB926CE3",
	"Success":true,
	"DatabaseList":{
		"Database":[
			{
				"Encoding":"utf8",
				"Host":"pc-xxx.rwlb.rds.aliyuncs.com",
				"InstanceId":24710,
				"DbType":"polardb",
				"EnvType":"product",
				"OwnerIdList":{
					"OwnerIds":[
						88653
					]
				},
				"DbaId":104442,
				"OwnerNameList":{
					"OwnerNames":[
						"dmstest"
					]
				},
				"Port":3306,
				"DatabaseId":116366,
				"State":"NORMAL",
				"SearchName":"xxx_test@pc-xxx.rwlb.rds.aliyuncs.com:3306【xxx_test】",
				"DbaName":"xxx[子账号]",
				"SchemaName":"xxx_test"
			}
		]
	}
}

错误码

访问错误中心查看更多错误码。