文档首页/ MapReduce服务 MRS/ API参考/ API V2/ 数据连接管理/ 创建数据连接-CreateDataConnector
更新时间：2026-05-28 GMT+08:00
查看PDF
分享

创建数据连接-CreateDataConnector

功能介绍

创建数据连接。

接口约束

无

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和受限项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    mrs:dataConnector:updateInstance

    Write

    -

    -

    -

    -

URI

POST /v2/{project_id}/data-connectors

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目编号。获取方法，请参见获取项目ID。

约束限制：

不涉及

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

data_connector

是

object

参数解释：

数据连接，请参见表3。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及
表3 DataConnector

参数

是否必选

参数类型

描述

connector_name

是

String

参数解释：

数据连接名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

source_type

是

String

参数解释：

数据连接类型。

约束限制：

不涉及

取值范围：

  • RDS_POSTGRES：RDS服务PostgreSQL数据库
  • RDS_MYSQL：RDS服务MySQL数据库
  • gaussdb-mysql：云数据库TaurusDB

默认取值：

不涉及

source_info

是

String

参数解释：

数据源信息，为json格式。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

响应参数

状态码：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"
}

状态码

状态码请参见状态码。

错误码

请参见错误码。

父主题： 数据连接管理