文档首页/ 数据湖探索 DLI/ API参考/ 增强型跨源连接相关API/ 绑定队列
更新时间：2023-07-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

绑定队列

功能介绍

该API用于在已创建的增强型跨源中绑定队列。

URI

  • URI格式

    POST /v2.0/{project_id}/datasource/enhanced-connections/{connection_id}/associate-queue

  • 参数说明
    表1 URI参数

    参数名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

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

    connection_id

    是

    String

    连接ID，用于标识跨源连接的UUID。具体为创建增强型跨源连接返回的连接ID。

请求消息

表2 请求参数

参数名称

是否必选

参数类型

说明

queues

否

Array of Strings

需要使用跨源的队列名列表。

elastic_resource_pools

否

Array of Strings

需要使用跨源的弹性资源池列表，将这些弹性资源池绑定到该增强跨源。

响应消息

表3 响应参数

参数名称

参数类型

说明

is_success

Boolean

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

message

String

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

请求示例

在已创建的增强型跨源中绑定队列q1和q2。

{
  "queues": [
    "q1",
    "q2"
  ]
}

响应示例

{
  "is_success": true,
  "message": "associated peer connection for queues: {q1,q2}."
}

状态码

状态码如表4所示。

表4 状态码

状态码

描述

200

绑定成功。

400

请求错误。

500

内部服务器错误。

错误码

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