创建增强型跨源连接
功能介绍
该API用于创建与其他服务的增强型跨源连接。
- 如果需要了解Console界面的使用方法，可参考《数据湖探索用户指南》中的“增强型跨源连接”。
- 系统default队列不支持创建跨源连接。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限及授权项说明。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
Action
访问级别
Access Level
资源类型（*为必须）
Resource Type (*: required)
条件键
Condition Key
别名
Alias
依赖的授权项
Dependencies
dli:edsconnection:create
Write
edsconnection *
-
-
-
-
-
-
URI
- URI格式
- 参数说明
表1 URI参数 参数名称
是否必选
参数类型
说明
project_id
是
String
项目编号，用于资源隔离。获取方式请参考获取项目ID。
请求消息
参数名称 | 是否必选 | 参数类型 | 说明 |
|---|---|---|---|
name | 是 | String | 连接名称。
|
dest_vpc_id | 是 | String | 对应服务的vpc的ID。 |
dest_network_id | 是 | String | 对应服务的子网网络ID，即为需要建立连接的服务所在的子网。 |
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。 |
响应消息
参数名称 | 参数类型 | 说明 |
|---|---|---|
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 queues:{请求参数中的弹性资源池列表}",
"connection_id": "2a620c33-5609-40c9-affd-2b6453071b0f"
} 错误码
调用接口出错后，将不会返回上述结果，而是返回错误码和错误信息，更多介绍请参见错误码。
