tencent cloud

TDMQ for RocketMQ

Release Notes and Announcements
Release Notes
Announcements
Product Introduction
Introduction and Selection of the TDMQ Product Series
What Is TDMQ for RocketMQ
Strengths
Scenarios
Product Series
Comparison with Open-Source RocketMQ
High Availability
Quotas and Limits
Supported Regions
Basic Concepts
Billing
Billing Overview
Pricing
Billing Examples
Pay-as-you-go Switch to Monthly Subscription (5.x)
Renewal
Viewing Consumption Details
Refund
Overdue Payments
Getting Started
Getting Started Guide
Preparations
Step 1: Creating TDMQ for RocketMQ Resources
Step 2: Using the SDK to Send and Receive Messages (Recommended)
Step 2: Running the TDMQ for RocketMQ Client (Optional)
Step 3: Querying Messages
Step 4: Deleting Resources
User Guide
Usage Process Guide
Configuring Account Permissions
Creating the Cluster
Configuring the Namespace
Configuring the Topic
Configuring the Group
Connecting to the Cluster
Managing Messages
Managing the Cluster
Viewing Monitoring Data and Configuring Alarms
Cross-Cluster Message Replication
Use Cases
Naming Conventions for Common Concepts of TDMQ for RocketMQ
RocketMQ Client Use Cases
RocketMQ Performance Load Testing and Capacity Assessment
Access over HTTP
Client Risk Descriptions and Update Guide
Migration Guide for TencentCloud API Operations Related to RocketMQ 4.x Cluster Roles
Migration Guide
Disruptive Migration
Seamless Migration
Developer Guide
Message Types
Message Filtering
Message Retries
POP Consumption Mode (5.x)
Clustering Consumption and Broadcasting Consumption
Subscription Relationship Consistency
Traffic Throttling
​​API Reference(5.x)
History
API Category
Making API Requests
Topic APIs
Consumer Group APIs
Message APIs
Role Authentication APIs
Hitless Migration APIs
Cloud Migration APIs
Cluster APIs
Data Types
Error Codes
​​API Reference(4.x)
SDK Reference
SDK Overview
5.x SDK
4.x SDK
Security and Compliance
Permission Management
CloudAudit
Deletion Protection
FAQs
4.x Instance FAQs
Agreements
TDMQ for RocketMQ Service Level Agreement
Contact Us

Creating the Topic

PDF
Focus Mode
Font Size
Last updated: 2026-01-23 17:34:03

Scenarios

Topic is a core concept in TDMQ for RocketMQ. Typically, topics are used for centralized classification and management of various types of messages produced by the system. For example, messages related to transactions can be stored in a topic named trade for other consumers to subscribe to. In actual application scenarios, a topic often represents a business aggregation, and developers determine how to design different topics based on their system design and data architecture design.

Constraints and Limitations

When the total number of topics (including manually and automatically created topics) under a cluster reaches the upper limit, you cannot create topics. You can purchase an additional topic quantity to increase the topic quota. For specific steps, see Adjusting Cluster Specifications.

Operation Steps

1. Log in to the TDMQ for RocketMQ console.
2. In the left sidebar, select Topic. Select the region and cluster and click Create to go to the Create Topic page.
3. In the Create Topic dialog box, specify the following information.
Parameter
Required
Description
Topic Name
Yes
Enter the topic name, which cannot be modified after creation. The name must be 3 to 100 characters in length and can contain only letters, digits, percent signs (%), hyphens (-), and underscores (_).
Type
Yes
Select a message type. Messages are classified into normal messages, ordered messages, delayed messages, and transactional messages. (For details about message types, see Message Types). Topics of different types of messages cannot be used interchangeably. For example, a topic created for normal messages cannot be used to send or receive other types of messages.
Tag
No
Tags are used to categorize and manage topic resources. You can also grant sub-accounts read/write permissions for specific resource types through authorization by tag. For details, see Configuring Resource Tags and Granting Tag-Level Permissions to Sub-accounts.
Queue Quantity
Yes
Select the number of queues. Up to 16 queues are supported. Multiple queues can improve the production and consumption performance of a single topic. However, message sequentiality cannot be guaranteed in non-ordered message scenarios.
Message Retention Period
Yes
Retention time for persisted messages, after which messages are deleted regardless of whether they are consumed. Only 5.x clusters of the Pro and Platinum editions support adjusting the message retention time at the topic level, and 5.x clusters of the Trial and Basic editions and 4.x clusters support adjustment at the cluster level.
Topic Description
No
Enter the topic description, with a string of up to 128 characters.
4. Click Submit to complete the creation.


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback