AddDatabase - 通过DG接入数据库

更新时间: 2024-07-18 10:59:21

调用此API可以将他云或本地的数据库接入至阿里云。

调试

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

授权信息

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

请求参数

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

网关 ID。

dg-8d9bqu1030m****
Hoststring

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

127.0.XX.XX
Portinteger

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

3306
DbTypestring

数据库类型。

MYSQL
DbUserNamestring

访问数据库所用的用户名。

test_usr
DbPasswordstring

访问数据库所用的密码。

说明 仅用于验证数据库是否可以连接成功,不做任何其他工作。
1234!2#%A***
DbDescriptionstring

数据库的描述。

测试
RegionIdstring

数据库所在地域。

cn-hangzhou
DbNamestring

数据库名称。

test
ClientTokenstring

该参数值由客户端生成,用于确保请求的幂等性。该参数值在不同请求间是唯一的,并且区分大小写,长度不超过 64 个 ASCII 字符。

ETnLKlblzczshOTUbOCzxxxx

返回参数

名称类型描述示例值
object
Codestring

响应码。

200
ErrorMsgstring

报错信息。

SYSTEM_ERR
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

A8B2EED2-70EF-51F1-8820-914F9AC9BAD2
Successboolean

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

  • true:请求成功
  • false:请求失败
true
DbInstanceobject

数据库连接实例列表。

Portinteger

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

3306
Hoststring

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

127.0.0.1
GatewayIdstring

网关 ID。

dg-8d9bqu1030mhk0ix
DbTypestring

数据库类型。

MYSQL
RegionIdstring

地域 ID。

cn-hangzhou
ConnectHoststring

数据库连接在 DG 服务侧的映射地址。

10.0.0.1
ConnectPortinteger

数据库连接在 DG 服务侧的映射端口。

32875
ServiceTypestring

DG 服务器类型。

ECS
NetworkTypestring

DG 服务器网络类型。

VPC
NodeIdstring

DG 服务器节点 ID。

dg-node-r0SR-E90lsIRNgj6B_9m
InstanceStatusstring

当前 DG 网关实例的状态。

SUCCESS
DbDescriptionstring

备注信息

test
InstanceIdstring

数据库连接实例 ID。

dg-db-rgfg9p4586o7y79b
GatewayNamestring

网关名称。

测试
UserIdstring

用户 ID。

167xxxxxxxxxx
ParentIdstring

归属主账号 ID。

167xxxxxxxxxx
VpcIdstring

DG 服务器所在 VPC 的 ID。

vpc-xxxxx
VpcInstanceIdstring

VPC 实例 ID。

i-xxxxxxx

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "ErrorMsg": "SYSTEM_ERR",
  "RequestId": "A8B2EED2-70EF-51F1-8820-914F9AC9BAD2",
  "Success": true,
  "DbInstance": {
    "Port": 3306,
    "Host": "127.0.0.1",
    "GatewayId": "dg-8d9bqu1030mhk0ix",
    "DbType": "MYSQL",
    "RegionId": "cn-hangzhou",
    "ConnectHost": "10.0.0.1",
    "ConnectPort": 32875,
    "ServiceType": "ECS",
    "NetworkType": "VPC",
    "NodeId": "dg-node-r0SR-E90lsIRNgj6B_9m",
    "InstanceStatus": "SUCCESS",
    "DbDescription": "test",
    "InstanceId": "dg-db-rgfg9p4586o7y79b",
    "GatewayName": "测试",
    "UserId": "167xxxxxxxxxx",
    "ParentId": "167xxxxxxxxxx",
    "VpcId": "vpc-xxxxx",
    "VpcInstanceId": "i-xxxxxxx"
  }
}

错误码

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

上一篇: CreateGateway - 创建网关 下一篇: AddDatabaseList - 通过DG批量接入数据库
阿里云首页 数据管理 相关技术圈