创建并使用跨源链接

场景描述

本章节指导用户通过API创建增强型跨源连接。API的调用方法请参见如何调用API。

约束限制

• 新队列第一次运行作业时，需要一定的时间，通常为6~10分钟。
• 创建增强型跨源连接之前需要获取需要建立连接的服务对应VPC的ID和其所在子网的网络ID。

涉及接口

• 创建队列：创建专属队列。
• 创建增强型跨源连接：创建增强型跨源连接。
• 绑定队列：绑定队列。
• 查询增强型跨源连接：确认增强型跨源连接创建成功。

操作步骤

1. 创建队列。具体请参考创建队列。其中，需要将请求参数"resource_mode"设置为“1”，创建专属队列。
2. 创建增强型跨源连接。
   • 接口相关信息

     URI格式：POST /v2.0/{project_id}/datasource/enhanced-connections

     • {project_id}信息请从获取项目ID获取。
     • 请求参数说明详情，请参见创建增强型跨源连接。
   • 请求示例
     • 描述：在项目ID为48cc2c48765f481480c7db940d6409d1下创建名称为test1的增强型跨源连接。
     • 示例URL：POST https://{endpoint}/v2.0/48cc2c48765f481480c7db940d6409d1/datasource/enhanced-connections
     • Body：

       {
         "name": "test1",
         "dest_vpc_id": "22094d8f-c310-4621-913d-4c4d655d8495",
         "dest_network_id": "78f2562a-36e4-4b39-95b9-f5aab22e1281",
         "queues": ["q1","q2"],
         "hosts": [
           {
             "ip":"192.168.0.1",
             "name":"ecs-97f8-0001"
           },
           {
             "ip":"192.168.0.2", 
             "name":"ecs-97f8-0002"
           }
         ]
       }

   • 响应示例

     {
       "is_success": true,
       "message": "",
       "connection_id": "2a620c33-5609-40c9-affd-2b6453071b0f"
     }

3. （可选）如果创建增强型跨源连接时，没有绑定队列，可使用绑定队列接口进行绑定。
4. 确认增强型跨源连接创建成功。
   • 接口相关信息

     URI格式：GET /v2.0/{project_id}/datasource/enhanced-connections/{connection_id}

     • {project_id}信息请从获取项目ID获取。
     • 查询参数说明详情，请参见创建数据库。
   • 请求示例
     • 描述：查询项目ID为48cc2c48765f481480c7db940d6409d1下连接ID为2a620c33-5609-40c9-affd-2b6453071b0f的增强型跨源连接。
     • 示例URL：GET https://{endpoint}/v2.0/48cc2c48765f481480c7db940d6409d1/datasource/enhanced-connections/2a620c33-5609-40c9-affd-2b6453071b0f
     • Body：

       {}

   • 响应示例

     {
       "is_success": true,
       "message": "",
       "name": "test1",
       "id": "2a620c33-5609-40c9-affd-2b6453071b0f",
       "available_queue_info": [
         {
           "status": "ACTIVE",
           "name": "queue1",
           "peer_id": "2a620c33-5609-40c9-affd-2b6453071b0f",
           "err_msg": "",
           "update_time": 1566889577861
         }
       ],
       "dest_vpc_id": "22094d8f-c310-4621-913d-4c4d655d8495",
       "dest_network_id": "78f2562a-36e4-4b39-95b9-f5aab22e1281",
       "isPrivis": true,
       "create_time": 1566888011125,
       "status": "ACTIVE",
       "hosts": [
         {
           "ip":"192.168.0.1",
           "name":"ecs-97f8-0001"
         },
         {
           "ip":"192.168.0.2", 
           "name":"ecs-97f8-0002"
         }
       ]
     }