接入点设置说明
本文提供对应地域的 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 通过跨地域的方式,与客户端 B 通信,或将 Topic B 通过跨地域的方式,与客户端 A 通信。
具体对应关系如下图所示。
操作步骤
登录 SOFAStack 控制台,选择地域和工作空间。
在左侧导航栏,选择 中间件 > 消息队列 > 概览。
在页面底部的 接入配置 找到 内网接入点 及 实例 ID。
将该 TCP 协议内网接入点 配置到客户端 SDK 代码的 ENDPOINT 参数。
将该 实例 ID 配置到客户端 SDK 代码的 INSTANCE_ID 参数。