接入点设置说明

本文提供对应地域的 TCP 内网接入点的详细说明和配置步骤。

背景信息

如需使用 SOFAStack 消息队列来收发消息，则需在使用 TCP 协议下的 SDK 时，将相应参数配置为您实际使用的资源信息。需特别注意的是，以下参数所对应的资源应处于同一地域：

• GROUP_ID：您在消息队列控制台上创建的 Group ID。
• TOPIC：您在消息队列控制台上创建的 Topic。
• ENDPOINT：您从消息队列控制台的 概览 > 接入配置 获取的接入点。
• INSTANCE_ID：您从消息队列控制台的 概览 > 接入配置 获取的实例 ID。

例如您在华东1（杭州）地域创建了一个消息队列工作空间 A，并在此地域下创建了 Topic A 和 Group ID A，供部署在该地域的应用客户端 A 使用；同时，您也在另一个地域，如华南1（深圳）创建了另一个消息队列工作空间 B，并在此地域下创建了 Topic B 和 Group ID B，供部署在该地域的应用客户端 B 使用。需特别注意的以下几点：

• 针对 Topic A，您只能通过在华东1（杭州）地域的、归属于 Group ID A 的客户端 A 向其发送或接收消息；
• 针对 Topic B，您只能通过在华南1（深圳）地域的、归属于 Group ID B 的客户端 B 向其发送或接收消息。

注意：切忌将 Topic A 通过跨地域的方式，与在华南1（深圳）地域的、归属于 Group ID B 的客户端 B 通信，或将 Topic B 通过跨地域的方式，与在华东1（杭州）地域的、归属于 Group ID A 的客户端 A 通信。

具体对应关系如下图所示。

操作步骤

1. 进入消息队列控制台，选择地域和工作空间。
2. 在概览页的接入配置可以找到 TCP 协议接入点和实例 ID 信息。
3. 将该 TCP 协议内网接入点 配置到客户端 SDK 代码的 ENDPOINT 参数。
4. 将该 实例 ID 配置到客户端 SDK 代码的 INSTANCE_ID 参数。