Creating a Queue
The first task in using DMS is to create one or more queues.
- Log in to the management console.
- Click in the upper left corner of the management console and select a region.
Select the same region as your application service.
- Click Service List, and choose Application > Distributed Message Service to open the DMS console.
- In the navigation pane, choose Queue Manager.
- Click Create Queue.
By default, 30 queues can be created under a project. To create more than 30 queues, contact customer service to increase your quota.
- Specify parameters listed in Table 1.
Table 1 Parameter description
Unique name of a queue.
When creating a queue, a default queue name is generated, which you can change if required. A queue name is 1 to 64 characters long. Only letters, digits, underscores (_), and hyphens (-) are allowed.
The queue name cannot be modified after creation of the queue.
Standard or Advanced
ModeWhen the queue type is standard, the queue mode can be:
- Partition-level FIFO: Messages may be retrieved out of sequence, but the concurrency is higher.
- Global FIFO: All messages are retrieved in the order they were sent.
When the queue type is Advanced, the queue mode can be:
- High throughput: All message replicas are flushed to a disk asynchronously. Select this mode when high message delivery performance is required.
- High reliability: All message replicas are flushed to disk synchronously. Select this mode when high message delivery reliability is required.
Dead Letter Queue
This parameter is displayed only if the Queue Type is set to Standard.
An indicator of whether to enable dead letter queue, which accommodates messages that cannot be correctly retrieved.
If a message fails to be retrieved for a preset number of times, it will be sent to the dead letter queue and retained for 72 hours. You can then retrieve the message from the dead letter queue.
Messages in the dead letter queue are specific to individual consumer groups, and consumer groups cannot retrieve each other's dead letter messages.
Dead letter messages from global FIFO queues are sent to the dead letter queue in the FIFO order.
By default, Dead Letter Queue is disabled.
Message Retention Period (h)
This parameter is available only for advanced queues.
The number of hours for which messages will be preserved in an advanced queue. Messages older than that period will be deleted. Deleted messages are not retrievable to consumer groups.
Value range: integers from 1 to 72
Default value: 72
This parameter is displayed only if Dead Letter Queue is enabled.
The maximum number of times a message can be retrieved before it is sent to the dead letter queue.
Value range: 1 to 100
Default value: 3
The description is 0 to 160 characters long and cannot contain angle brackets (< and >).
- Click OK.
After the queue is created, you can click the name of a queue to view queue details.