文档首页/ 数据治理中心 DataArts Studio/ 更多文档/ API参考 (联盟区域) / 数据开发API/ 连接管理API（待下线）/ 创建连接（待下线）
更新时间：2026-01-30 GMT+08:00
查看PDF
分享

创建连接（待下线）

连接管理能力由管理中心统一提供，相关接口已不再维护，推荐使用管理中心API进行连接管理。

功能介绍

创建一个新连接，当前支持的连接类型有DWS、DLI、SparkSQL、HIVE、RDS、CloudTable。

URI

  • URI格式

    POST /v1/{project_id}/connections

  • 参数说明
    表1 URI参数说明

    参数名

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

请求参数

表2 请求Header参数

参数名

是否必选

参数类型

说明

workspace

否

String

工作空间id。

  • 如果不设置该参数，默认查询default工作空间下的数据。
  • 如果需要查询其他工作空间的数据，需要带上该消息头。
表3 Connection参数说明

参数名

是否必选

参数类型

说明

name

是

String

连接名称，只能包含四种字符：英文字母、数字、中划线和下划线，且长度小于等于100个字符。连接名称不能重复。

type

是

String

连接类型，包含：

  • DWS
  • DLI
  • SparkSQL
  • HIVE
  • RDS
  • CloudTable
  • HOST

config

否

Map<String,String>

连接的配置项，不同类型的连接配置项不同。DLI类型的连接不需要配置。config参数，其他类型的连接请参考连接配置项说明。

description

否

String

描述，长度不能超过255个字符。
表4 DWS类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

否

String

DWS集群名称。

通过DWS管理控制台获取集群名称：

  1. 登录管理控制台。
  2. 单击“数据仓库服务”，左侧列表选择集群管理。

在集群管理列表中可以获取到集群名称。

默认值为空。

ip

否

String

DWS集群的访问地址。

通过DWS管理控制台获取访问地址：

  1. 登录管理控制台。
  2. 单击“数据仓库服务”，左侧列表选择集群管理。
  3. 单击集群名称，进入集群基本信息页面。

在数据库属性标签中可以查看到内网IP，如果有多个IP地址，选择第一个IP。

默认值为空。

port

否

String

DWS集群的访问端口。

通过DWS管理控制台获取访问集群的访问端口：

  1. 登录管理控制台。
  2. 单击“数据仓库服务”，左侧列表选择集群管理。
  3. 单击集群名称，进入集群基本信息页面。

在数据库属性标签中可以获取到端口信息。

例如8000，默认值为空。

userName

是

String

数据库的用户名，创建DWS集群的时输入的用户名。

password

是

String

数据库的访问密码，创建DWS集群的时候输入的密码。

sslEnable

是

boolean

是否使用ssl连接。

kmsKey

是

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称：

  1. 登录管理控制台。
  2. 单击“密钥管理服务”，左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

agentName

是

String

连接代理，即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成，在批量数据迁移集群列表可以获取到集群名称。
表5 Spark SQL类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

是

String

MRS集群名称。

通过MRS管理控制台获取集群名称：

  1. 登录管理控制台。
  2. 单击“MapReduce服务”，左侧列表选择现有集群。

在现有集群中可以获取到集群名称，例如mrsCluster1。

connectionMethod

是

String

连接方式：

  • agent ：通过代理连接。
  • direct ：直接连接。

userName

否

String

MRS集群的用户名，通过代理连接的时候，是必选项。

password

否

String

MRS集群的访问密码，通过代理连接的时候，是必选项。

agentName

否

String

连接代理，即CDM集群名称。通过代理连接的时候，是必选项。

通过DataArts Studio管理控制台 > 数据集成，在批量数据迁移集群列表可以获取到集群名称。

kmsKey

否

String

KMS密钥名称。通过代理连接的时候，是必选项。

通过KMS管理控制台获取密钥名称：

  1. 登录管理控制台。
  2. 单击“密钥管理服务”，左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。
表6 Hive类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

是

String

MRS集群名称，例如mrsCluster1

connectionMethod

是

String

连接方式：

  • agent：通过代理连接。
  • direct ：直接连接。

userName

否

String

MRS集群的用户名，通过代理连接的时候，是必选项。

password

否

String

MRS集群的访问密码，通过代理连接的时候，是必选。

agentName

否

String

连接代理，即CDM集群名称。通过代理连接的时候，是必选项。

通过DataArts Studio管理控制台 > 数据集成，在批量数据迁移集群列表可以获取到集群名称。

kmsKey

否

String

KMS密钥名称。通过代理连接的时候，是必选项。

通过KMS管理控制台获取密钥名称：

  1. 登录管理控制台。
  2. 单击“密钥管理服务”，左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。
表7 RDS类型的连接配置项说明

参数名

是否必选

参数类型

说明

ip

是

String

RDS的访问地址。

通过RDS管理控制台获取访问地址：

  1. 登录管理控制台。
  2. 单击“关系型数据库服务”，从左侧列表选择实例管理。
  3. 单击某一个实例名称，进入实例基本信息页面。

在连接信息标签中可以获取到内网地址。

port

是

String

RDS的访问端口。

通过RDS管理控制台获取访问端口：

  1. 登录管理控制台。
  2. 单击“关系型数据库服务”，左侧列表选择实例管理。
  3. 单击某一个实例名称，进入实例基本信息页面。

在连接信息标签中可以获取到数据库端口。

userName

是

String

数据库的用户名，创建集群的时候，输入的用户名。

password

是

String

数据库的访问密码，创建集群的时候，输入的密码。

kmsKey

是

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称：

  1. 登录管理控制台。
  2. 单击“密钥管理服务”，左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

agentName

是

String

连接代理，即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成，在批量数据迁移集群列表可以获取到集群名称。

driverName

是

String

驱动程序名称：

  • com.mysql.jdbc.Driver
  • org.postgresql.Driver

driverPath

是

String

驱动在OBS上路径。
表8 CloudTable类型的连接配置项说明

参数名

是否必选

参数类型

说明

clusterName

是

String

CloudTable集群名称

通过CloudTable管理控制台获取集群名称：

  1. 登录管理控制台。
  2. 单击“表格存储服务”，左侧列表选择集群模式。

在集群模式中可以获取到集群名称。
表9 HOST类型的连接配置项说明

参数名

是否必选

参数类型

说明

ip

是

String

主机的地址

port

是

String

主机的SSH端口号

userName

是

String

主机的登录用户名

password

是

String

主机的登录方式为密码时，填写主机的登录密码。

agentName

是

String

连接代理，即CDM集群名称。

通过DataArts Studio管理控制台 > 数据集成，在批量数据迁移集群列表可以获取到集群名称。

kmsKey

是

String

KMS密钥名称。

通过KMS管理控制台获取密钥名称：

  1. 登录管理控制台。
  2. 单击“密钥管理服务”，左侧列表选择密钥管理。

在密钥列表可以获取到密钥名称。

响应参数

无

请求示例

创建一个连接。 
POST /v1/b384b9e9ab9b4ee8994c8633aabc9505/connections
{
    "name":"connection1",
    "type":"DWS",
    "config":{
	    "clusterName":"test",
	    "userName":"dbadmin",
            "password":"*********",
	    "kmsKey":"cdm-dlf",		
	    "agentName":"cdm-donotdelete",		
	    "sslEnable":false
    }
}

响应示例

  • 成功响应

    HTTP状态码 204

  • 失败响应

    HTTP状态码 400

    {
    "error_code":"DLF.6309",
    "error_msg":"The name already exists."
}

状态码

状态码请参见状态码。