# 创建增强型跨源连接 - CreateEnhancedConnection #### 功能介绍 该API用于创建与其他服务的增强型跨源连接。 ![](https://support.huaweicloud.com/api-dli/public_sys-resources/note_3.0-zh-cn.png) - 如果需要了解Console界面的使用方法，可参考《数据湖探索用户指南》中的"[增强型跨源连接](https://support.huaweicloud.com/usermanual-dli/dli_01_0426.html)"。 - 系统default队列不支持创建跨源连接。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DLI&api=CreateEnhancedConnection)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dli/dli_02_0375.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | 条件键 Condition Key | 别名 Alias | 依赖的授权项 Dependencies | |:---|:---|:---|:---|:---|:---| | dli:edsconnection:create | Write | edsconnection \* | - | - | - | | dli:edsconnection:create | Write | - | - [g:RequestTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | #### URI - URI格式 POST /v2.0/{project_id}/datasource/enhanced-connections - 参数说明 表1URI参数 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | project_id | 是 | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 | #### 请求消息 表2请求参数 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | name | 是 | String | 连接名称。 - 名称只能包含数字、英文字母、下划线。不能为空。 - 输入长度不能超过64个字符。 | | dest_vpc_id | 是 | String | 对应服务的vpc的ID。具体请参考《[虚拟私有云API参考](https://support.huaweicloud.com/api-vpc/vpc_api01_0001.html)》。 | | dest_network_id | 是 | String | 对应服务的子网网络ID，即为需要建立连接的服务所在的子网。具体请参考《[虚拟私有云API参考](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0001.html)》。 | | elastic_resource_pools | 否 | Array of Strings | 需要使用跨源的弹性资源池列表。 | | queues | 否 | Array of Strings | DLI非弹性资源池队列即将下线，相关参数queues计划下线，请使用elastic_resource_pools。 需要使用跨源的队列列表。 说明： 只有包年包月队列和专属队列可以使用增强型跨源连接。 | | routetable_id | 否 | String | 对应服务的子网关联的路由表。 | | hosts | 否 | Array of Objects | 用户自定义主机信息，最大支持2万条记录，详细信息参见[表 hosts请求参数]。 | | tags | 否 | Array of Objects | 跨源连接的标签。具体请参考[表4]。 | 表3hosts请求参数 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | name | 否 | String | 自定义主机名称。长度128，数字字母下划线("_")横杠("-")句点(".")组成，字母开头。 | | ip | 否 | String | 主机对应的IPv4地址。 | 表4tags参数 | 参数名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | key | 是 | String | 标签的键。 说明： 标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : +-@ ,但首尾不能含有空格，不能以_sys_开头。 | | value | 是 | String | 标签的值。 说明： 标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : +-@但首尾不能含有空格。 | #### 响应消息 表5响应参数 | 参数名称 | 参数类型 | 说明 | |:---|:---|:---| | is_success | Boolean | 执行请求是否成功。"true"表示请求执行成功。 | | message | String | 系统提示信息，执行成功时，信息可能为空。 | | connection_id | String | 连接ID，用于标识跨源连接的UUID。 | #### 请求示例 为队列创建增强型跨源连接，并配置主机信息。 ``` { "name": "test", "dest_vpc_id": "22094d8f-c310-4621-913d-4c4d655d8495", "dest_network_id": "78f2562a-36e4-4b39-95b9-f5aab22e1281", "elastic_resource_pools": [ "e1" ], "hosts": [ { "ip":"192.168.0.1", "name":"ecs-97f8-0001" }, { "ip":"192.168.0.2", "name":"ecs-97f8-0002" } ] } ``` #### 响应示例 ``` { "is_success": true, "message": "Create peer connection for elastic resource pools:e1", "connection_id": "2a620c33-5609-40c9-affd-2b6453071b0f" } ``` #### 状态码 状态码如[表6]所示。 表6状态码 | 状态码 | 描述 | |:---|:---| | 201 | 创建成功。 | | 400 | 请求错误。 | | 500 | 内部服务器错误。 | #### 错误码 调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。