首页 数据管理(兼容数据库备份) 开发参考 API参考-DG API目录 GetUserDatabases - 获取网关中的数据库列表

GetUserDatabases - 获取网关中的数据库列表

更新时间: 2024-07-12 15:30:45

调用此API可以查看指定网关中已添加的数据库列表信息。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
GatewayIdstring

网关 ID。

dg-nmz841r7b681****
PageSizestring

分页大小。

10
PageNumberstring

当前页码。

1
SearchKeystring

搜索关键字。

网关。
DbTypestring

数据库类型。

MYSQL
InstanceIdstring

数据库实例 ID。

db-22h1qa9d452f****
RegionIdstring

网关所在地域。

cn-hangzhou
Hoststring

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

127.0.XX.XX
Portinteger

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

3306

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID,用于定位日志,排查问题。

514F794F-7E30-5DAA-97C0-0B0D75DA0259
Successstring

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

  • true:请求成功。
  • false:请求失败。
true
Codestring

响应码。

200
ErrorMsgstring

报错信息。

Gateway exception, please launch local dg first
Countinteger

添加的数据库个数。

100
DbInstanceListarray<object>

数据库实例列表。

object

数据库实例。

Portinteger

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

3306
Hoststring

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

127.0.XX.XX
GatewayIdstring

网关 ID。

dg-pil582nbfe6p****
DbTypestring

数据库类型。

MYSQL
RegionIdstring

数据库所在地域。

cn-hangzhou
ConnectHoststring

云上 DG 服务代理 IP。

10.0.0.0
ConnectPortinteger

云上 DG 服务代理端口。

10001
ServiceTypestring

云上 DG 服务机器类型。

ECS
NetworkTypestring

云上 DG 服务代理节点网络类型。

VPC
NodeIdstring

云上 DG 服务代理节点 ID。

dg-node-xxxxx
InstanceStatusstring

当前实例的状态。

SUCCESS
DbDescriptionstring

备注信息。

测试库
InstanceIdstring

数据库实例 ID。

db-22h1qa9d452f****
GatewayNamestring

网关名称。

测试库
GmtCreatelong

创建时间。

2023-05-03 00:00:00
UserIdstring

用户 ID。

100XXXXX
ParentIdstring

归属主账号 ID。

100XXXXX
VpcIdstring

云上 DG 服务 VPC ID。

vpc-bp1alpkpdb8fh3avx****
VpcInstanceIdstring

云上 DG 服务实例 ID。

i-xxxxxxxxxx

示例

正常返回示例

JSON格式

{
  "RequestId": "514F794F-7E30-5DAA-97C0-0B0D75DA0259",
  "Success": "true",
  "Code": "200",
  "ErrorMsg": "Gateway exception, please launch local dg first",
  "Count": 100,
  "DbInstanceList": {
    "DbInstance": [
      {
        "Port": 3306,
        "Host": "127.0.XX.XX",
        "GatewayId": "dg-pil582nbfe6p****",
        "DbType": "MYSQL",
        "RegionId": "cn-hangzhou",
        "ConnectHost": "10.0.0.0",
        "ConnectPort": 10001,
        "ServiceType": "ECS",
        "NetworkType": "VPC",
        "NodeId": "dg-node-xxxxx",
        "InstanceStatus": "SUCCESS",
        "DbDescription": "测试库",
        "InstanceId": "db-22h1qa9d452f****\n",
        "GatewayName": "测试库",
        "GmtCreate": 0,
        "UserId": "100XXXXX",
        "ParentId": "100XXXXX",
        "VpcId": "vpc-bp1alpkpdb8fh3avx****",
        "VpcInstanceId": "i-xxxxxxxxxx"
      }
    ]
  }
}

错误码

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

上一篇: FindUserGatewayById - 获取网关的详细信息 下一篇: GetUserGatewayInstances - 获取网关节点详细信息
阿里云首页 数据管理 相关技术圈