在调用HTTP协议的SDK收发消息前，您需在消息队列RocketMQ版控制台创建相关资源。

背景信息

针对TCP和HTTP两种通信协议，消息队列RocketMQ版分别提供了多语言客户端SDK来收发消息。您需创建消息队列RocketMQ版实例、Topic和Group ID。由于TCP协议和HTTP协议的客户端各不相同，您需为两种协议分别创建不同的Group ID，换言之，Group ID不可跨协议使用。

创建实例

实例是用于消息队列RocketMQ版服务的虚拟机资源，会存储消息主题（Topic）和客户端ID（Group ID）信息。

  1. 登录消息队列RocketMQ版控制台。
  2. 在左侧导航栏，单击实例列表。
  3. 在顶部菜单栏，选择地域，如华东1（杭州）。
  4. 在实例列表页面，单击创建实例。
  5. 在创建 RocketMQ 实例面板，选择实例类型，并输入名称和描述，然后单击确定。
    create_instance

    标准版和铂金版实例计费的更多信息，请参见计费概述。

    您可以在实例列表查看到您刚创建的实例。

创建Topic

Topic是消息队列RocketMQ版里对消息的一级归类，例如创建Topic_Trade这一Topic来识别交易类消息，消息生产者将消息发送到Topic_Trade，而消息消费者则通过订阅该Topic来获取和消费消息。Topic的使用说明如下：
  • Topic不能跨实例使用，例如在实例A中创建的Topic A不能在实例B中使用。
  • 在同一实例中Topic名称必须唯一。
  • 您可创建不同的Topic来发送不同类型的消息，例如用Topic A发送普通消息，Topic B发送事务消息，Topic C发送定时和延时消息。
  1. 在实例所在页面的左侧导航栏，单击Topic 管理。
  2. 在Topic 管理页面，单击创建 Topic
  3. 在创建 Topic面板，输入名称和描述，选择该Topic的消息类型为普通消息，然后单击确定。
    create_topic
    说明 本文以收发普通消息为例进行说明，因此，您按照本文提供的步骤创建的普通消息的Topic，不能用于收发其他类型的消息。换言之，不同消息类型的Topic不能混用。消息类型的更多信息，请参见消息类型。
    您创建的Topic将出现在Topic列表中。

创建Group ID

创建完实例和Topic后，您需要为消息的消费者（或生产者）创建客户端ID，即Group ID作为标识。Group ID的使用说明如下：
  • 在同一实例中Group ID必须唯一。
  • Group ID和Topic的关系是N:N，即一个消费者可以订阅多个Topic，同一个Topic也可以被多个消费者订阅；一个生产者可以向多个Topic发送消息，同一个Topic也可以接收来自多个生产者的消息。
说明 消费者必须有对应的Group ID，生产者不做强制要求。
  1. 在实例所在页面的左侧导航栏，单击Group 管理。
  2. 在Group 管理页面，选择TCP 协议 > 创建 Group ID。
  3. 在创建可用于 HTTP 协议的 Group面板，输入Group ID和描述，然后单击确定。
    create_http_group_id
    您创建的Group ID将出现在Group ID列表中。

获取接入点

在控制台创建好资源后，您需通过消息队列RocketMQ版控制台获取实例的接入点。在收发消息时，您需要为生产端和消费端配置该接入点，以此接入某个具体实例或地域的服务。

  1. 在实例所在页面的左侧导航栏，单击实例详情。
  2. 在实例详情页面的HTTP 接入点区域，将鼠标移动至所需的HTTP协议客户端接入点并单击该接入点即可完成复制。
    obtain_http_endpoint

    您在控制台看到的HTTP协议接入点是某个地域的接入点，跟具体实例无关。您在收发消息时还需另外设置实例ID。

    说明 HTTP协议和TCP协议的接入点不可混用。

后续步骤

调用HTTP协议的SDK收发普通消息