步骤二:创建资源

在调用SDK收发消息前,您需要提前创建云消息队列 RocketMQ 版的相关资源,包括创建云消息队列 RocketMQ 版实例、获取实例的接入点、创建Topic、创建ConsumerGroup。调用SDK时,需要将这些资源信息填写到SDK代码中。

前提条件

背景信息

云消息队列 RocketMQ 版支持通过控制台和OpenAPI创建资源,本文以控制台操作为例,介绍如何在云消息队列 RocketMQ 版控制台创建资源。

使用OpenAPI创建资源,请参见以下文档。

使用限制

  • 地域限制

    请确保您创建的云消息队列 RocketMQ 版实例的所属地域和前提条件中创建的专有网络以及交换机的所属地域一致。

  • 命名规范

    云消息队列 RocketMQ 版实例、Topic和ConsumerGroup的命名规范,请参见配额与限制

  • Topic类型限制

    Topic的消息类型需要和实际发送的消息类型保持一致,例如,您创建了一个普通消息类型的Topic,则该Topic只能用于收发普通消息,不能用于收发顺序消息。更多信息,请参见Topic使用建议

创建实例

  1. 登录云消息队列 RocketMQ 版控制台,在左侧导航栏单击实例列表

  2. 在顶部菜单栏选择地域,如华东1(杭州)

  3. 实例列表页面单击创建实例,在弹出的创建 RocketMQ 实例面板中,实例版本选择为5.0系列,并选择商品类型,然后单击确定

    云消息队列 RocketMQ 版支持的商品类型如下:

    • 包年包月:按照实例计算规格按月预付费。

    • 按量付费:按照实例计算规格按小时后付费。

    • Serverless:按消息累计请求次数按量付费。

      说明

      Serverless实例暂时只支持华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华南1(深圳)、西南1(成都)、新加坡、德国(法兰克福)、美国(弗吉尼亚)地域,其他地域将陆续开放。

    具体计费项差异和适用场景请参见计费概述

  4. 在产品售卖页选择实例规格,然后单击立即购买,并按照提示完成支付。

    您可以参考如下示例值完成创建。具体规格含义和取值,请参见产品选型

    Serverless实例配置参数

    参数

    取值示例

    主系列类型

    标准版

    计费模式

    默认为按请求次数付费

    消息存储规格

    无需选择存储容量,按照实际空间占用大小按量计费。

    VPC ID

    vpc-bp1cg09dua6sgh0******

    该参数为您在前提条件中创建的专有网络的ID。

    重要

    云消息队列 RocketMQ 版实例创建后,选择的VPC不支持变更。若要修改关联的VPC,您需要先释放已购买的云消息队列 RocketMQ 版实例,再重新购买。

    VSwitch ID

    vsw-bp1vqb0p9nz3irz******

    该参数为您在前提条件中创建的交换机的ID。

    Serverless实例需要选择两个VSwitch ID

    重要

    云消息队列 RocketMQ 版实例创建后,选择的交换机不支持变更。若要修改关联的交换机,您需要先释放已购买的云消息队列 RocketMQ 版实例,再重新购买。

    公网访问

    关闭

    说明
    • 本文以使用VPC接入云消息队列 RocketMQ 版服务端场景为例,公网访问默认关闭;若您需要通过公网接入云消息队列 RocketMQ 版,您需要将公网访问类型设置为开启。

    内网访问类型

    默认为按流量计费

    Serverless实例暂时仅支持VPC内网访问,不支持公网访问。

    资源组

    选择默认资源组。

    安全组

    选择您在前提条件中创建的安全组。

    包年包月或按量付费实例配置参数

    参数

    取值示例

    主系列类型

    标准版

    子系列类型

    集群高可用版本(生产环境推荐)

    消息收发计算规格

    rmq.s2.2xlarge

    VPC ID

    vpc-bp1cg09dua6sgh0******

    该参数为您在前提条件中创建的专有网络的ID。

    重要

    云消息队列 RocketMQ 版实例创建后,选择的VPC不支持变更。若要修改关联的VPC,您需要先释放已购买的云消息队列 RocketMQ 版实例,再重新购买。

    VSwitch ID

    vsw-bp1vqb0p9nz3irz******

    该参数为您在前提条件中创建的交换机的ID。

    重要

    云消息队列 RocketMQ 版实例创建后,选择的交换机不支持变更。若要修改关联的交换机,您需要先释放已购买的云消息队列 RocketMQ 版实例,再重新购买。

    公网访问类型

    关闭

    说明

    本文以使用VPC接入云消息队列 RocketMQ 版服务端场景为例,公网访问默认关闭;若您需要通过公网接入云消息队列 RocketMQ 版,您需要将公网访问类型设置为开启。

    资源组

    选择默认资源组。

    云盘加密

    关闭

    说明

    仅铂金版实例支持云盘加密。

    云盘密钥

    key-hzz66c8207****

    说明

    同地域的云盘加密的密钥ID。当云盘加密参数设置为启用时,需配置此参数。

获取实例接入点

  1. 实例列表页面中单击目标实例名称。

  2. 实例详情页面的TCP 协议接入点区域即可查看实例的接入点信息。

    • VPC专有网络接入点:使用VPC专有网络访问云消息队列 RocketMQ 版时使用。云消息队列 RocketMQ 版默认提供的接入点。

    • 公网接入点:使用公网访问云消息队列 RocketMQ 版时使用该接入点。仅当开启公网访问时显示。

获取实例用户名密码

说明

本文以实例默认访问控制方式即智能身份识别为例,获取实例的系统用户名和密码。

若您需要使用ACL访问控制,则需要创建ACL用户和ACL权限,并获取实例的ACL用户名和密码。具体操作,请参见用户身份识别

客户端接入云消息队列 RocketMQ 版服务端时,需要根据接入方式配置实例用户名密码。

  • 使用公网访问云消息队列 RocketMQ 版服务端:需要配置实例的用户名密码。

  • 使用VPC网络访问云消息队列 RocketMQ 版服务端:当实例类型为Serverless时,只有开启内网免身份识别,才可以不用配置实例的用户名和密码。其他类型实例无需配置实例的用户名密码,系统会根据VPC接入点智能识别用户身份。

  1. 实例列表页面中单击目标实例名称。

  2. 在左侧导航栏单击访问控制

  3. 单击智能身份识别页签,查看实例的用户名密码

创建Topic

  1. 实例列表页面中单击目标实例名称。

  2. 在左侧导航栏单击Topic 管理,然后在Topic 管理页面单击创建 Topic

  3. 创建 Topic面板中填写Topic名称和描述,选择消息类型普通消息,然后单击确定

创建ConsumerGroup

  1. 实例列表页面中单击目标实例名称。

  2. 在左侧导航栏单击Group 管理,然后在Group 管理页面单击创建 Group

  3. 创建 Group面板填写Group ID,其他参数可使用默认配置,然后单击确定

后续步骤

步骤三:调用SDK收发消息