创建增强型跨源连接
功能介绍
该API用于创建与其他服务的增强型跨源连接。
- 如果需要了解Console界面的使用方法,可参考《数据湖探索用户指南》中的“增强型跨源连接”。
- 系统default队列不支持创建跨源连接。
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" }
错误码
调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码。