文档首页> MapReduce服务 MRS> API参考> API V2> 数据连接管理> 创建数据连接
更新时间：2023-09-14 GMT+08:00
查看PDF

创建数据连接

功能介绍

创建数据连接

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/data-connectors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

data_connector

是

object

数据连接，请参见表3。
表3 DataConnector

参数

是否必选

参数类型

描述

connector_name

是

String

数据连接名称。

source_type

是

String

数据连接类型。

  • RDS_POSTGRES：RDS服务PostgreSQL数据库
  • RDS_MYSQL：RDS服务MySQL数据库
  • gaussdb-mysql：云数据库GaussDB(for MySQL)

source_info

是

String

数据源信息，为json格式，不同数据连接有不同的信息，各数据源的source_info请求内容可参见示例。

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

connector_id

String

数据连接创建成功后系统返回的数据连接ID值。

请求示例

创建mysql数据连接

/v2/ac66f1a5-e8f4-4399-8ec6-2c8cb1aefda7/data-connector

{
  "data_connector" : {
    "connector_name" : "mrs-mysql-connector",
    "source_type" : "RDS_MYSQL",
    "source_info" : "{\"db_name\":\"default\",\"user_name\":\"mrs\",\"password\":\"*****\",\"rds_instance_id\":\"3aa55f1cb4c3491686936130f21e9f16in01\"}"
  }
}

响应示例

状态码：201

数据连接创建成功

{
  "connector_id" : "0822239c1e80d4502f82c008937da9b5"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： 数据连接管理