调用GetUserDatabases接口,返回用户数据库列表信息。

调试

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

请求参数

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

系统规定参数。取值:GetUserDatabases

GatewayId String dg-yhss6sdlaff****

网关ID。

PageSize String 10

分页大小。

PageNumber String 1

当前页码。

SearchKey String 网关

搜索关键字。

DbType String MySQL

数据库类型。

说明 目前数据库类型仅支持MySQL。
InstanceId String db

实例ID。

RegionId String cn-hangzhou

地域ID。

Host String 11.*.*.109

通过网关所在宿主机去访问数据库的地址。

Port Integer 3440

通过网关所在宿主机去访问数据库的端口。

返回数据

名称 类型 示例值 描述
Data String { “dbDescription” :“开发环境数据库” ,“dbType” :“MySQL” ,“dbUserName” :“dbatool” ,“gatewayId” :“test_gateway” ,“gatewayName” :“Gateway—1” ,“gmtCreate” :1560736969000,“gmtCreateString” :“2019-06-17 10:02” ,“host” :“11.*.*.109” ,“instanceId” :“instance_1” ,“parentId” :“134****” ,“port” :3440,“userId” :“134****” }

数据库列表信息。

RequestId String 951AE6AA-BFC5-4DD8-8CD6-DFD3D51E4170

请求ID。

Success String true

请求是否成功,返回值如下:

  • true:请求成功。
  • false:请求失败。
Code String OK

响应码。

ErrorMsg String

异常信息。

Count Integer 1

个数。

示例

请求示例

http(s)://dg.cn-hangzhou.aliyuncs.com/?Action=GetUserDatabases
&GatewayId=dg-yhss6sdlaff****
&PageSize=10
&PageNumber=1
&SearchKey=网关
&DbType=MySQL
&InstanceId=db
&RegionId=cn-hangzhou
&Host=11.*.*.109
&Port=3440
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<GetUserDatabasesResponse>
    <RequestId>951AE6AA-BFC5-4DD8-8CD6-DFD3D51E4170</RequestId>
    <ErrorMsg>无</ErrorMsg>
    <Data>[{ “dbDescription” :“开发环境数据库” ,“dbType” :“MySQL” ,“dbUserName” :“dbatool” ,“gatewayId” :“test_gateway” ,“gatewayName” :“Gateway—1” ,“gmtCreate” :1560736969000,“gmtCreateString” :“2019-06-17 10:02” ,“host” :“11.*.*.109” ,“instanceId” :“instance_1” ,“parentId” :“134****” ,“port” :3440,“userId” :“134****” }]</Data>
    <Count>1</Count>
    <Code>OK</Code>
    <Success>true</Success>
</GetUserDatabasesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "951AE6AA-BFC5-4DD8-8CD6-DFD3D51E4170",
  "ErrorMsg" : "无",
  "Data" : "[{ “dbDescription” :“开发环境数据库” ,“dbType” :“MySQL” ,“dbUserName” :“dbatool” ,“gatewayId” :“test_gateway” ,“gatewayName” :“Gateway—1” ,“gmtCreate” :1560736969000,“gmtCreateString” :“2019-06-17 10:02” ,“host” :“11.*.*.109” ,“instanceId” :“instance_1” ,“parentId” :“134****” ,“port” :3440,“userId” :“134****” }]",
  "Count" : "1",
  "Code" : "OK",
  "Success" : "true"
}

错误码

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