文档首页/ 数据湖探索 DLI/ API参考/ 历史API/ 经典型跨源连接相关API（废弃）/ 创建经典型跨源连接
更新时间：2024-07-30 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建经典型跨源连接

功能介绍

该API用于创建与其他服务的经典型跨源连接。

当前接口已废弃，不推荐使用。

调试

您可以在API Explorer中调试该接口。

URI

  • URI格式

    POST /v2.0/{project_id}/datasource-connection

  • 参数说明
    表1 URI参数

    参数名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    项目编号，用于资源隔离。获取方式请参考获取项目ID。

请求消息

表2 请求参数

参数名称

是否必选

参数类型

说明

name

是

String

连接名称。

  • 名称只能包含数字、英文字母、下划线和中划线。不能为空。
  • 输入长度不能超过64个字符。

service

是

String

服务名称，目前为CloudTable.OpenTSDB/CloudTable，MRS.OPENTSDB，DWS，RDS，CSS。

说明：

不区分大小写。

security_group_id

是

String

用户指定安全组ID，即为需要建立连接的服务所在的安全组。

network_id

是

String

对应服务的子网网络ID，即为需要建立连接的服务所在的子网。

url

是

String

对应服务对外提供的访问url。长度不能超过512个字符。获取方式请参考表4。

tags

否

Array of Objects

队列的标签。具体请参考表3。
表3 tags参数

参数名称

是否必选

参数类型

说明

key

是

String

标签的键。

说明：

标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格，不能以_sys_开头。

value

是

String

标签的值。

说明：

标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : =+-@ ,但首尾不能含有空格。
表4 各服务URL获取方式

服务名称

URL获取方式

Cloud Table
  • HBase

  • OpenTSDB

DWS

RDS

CSS

MRS

响应消息

表5 响应参数

参数名称

是否必选

参数类型

说明

is_success

否

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

否

String

系统提示信息，执行成功时，信息可能为空。

connection_id

否

String

连接ID，用于标识跨源连接的UUID。

请求示例

{
    "name": "test1",
    "security_group_id": "a07ab107-a4ad-4835-ad09-08a2f2efccdb",
    "network_id": "e83ba67d-e812-42d3-908d-6ea0b2cc5ecb",
    "url": "cloudtable-8636-zk2-ldQklrNa.mycloudtable.com:2181,cloudtable-8636-zk3-N9EEH4mI.mycloudtable.com:2181,cloudtable-8636-zk1-78Lt0l8L.mycloudtable.com:2181",
    "service": "ct"
}

响应示例

{
    "is_success": true,
    "message": "",
    "connection_id": "68233202-63bf-4f27-a99b-fa5f5a2dbae1"
}

状态码

状态码如表6所示。

表6 状态码

状态码

描述

201

创建成功。

400

请求错误。

500

内部服务器错误。

错误码

调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见错误码。

相关文档