All Products
Search
Document Center

Simple Message Queue (formerly MNS):Get started with the queue-based messaging model

Last Updated:Sep 26, 2025

This topic describes how to get started with the queue-based messaging model in the Simple Message Queue (formerly MNS) console.

Prerequisites

Activate Simple Message Queue (formerly MNS) and grant permissions

Create a queue

  1. Log on to the SMQ console.

  2. In the left-side navigation pane, choose Queue Model > Queues.

  3. In the top navigation bar, select a region.

  4. On the Queues page, click Create Queue.

  5. In the Create Queue panel, configure the following parameters and click OK.

    • Name: the name of the queue.

    • Maximum Message Length: the maximum length of the message that is sent to the queue.

    • Long Polling Period: the maximum duration for which long polling requests are held after the ReceiveMessage operation is called. The value 0 indicates that long polling is disabled.

    • Visibility Timeout Period: the duration for which a message stays in the Inactive state after the message is received from the queue. For more information, see Message visibility.

    • Message Retention Period: the maximum duration for which a message exists in the queue. After the specified retention period, the message is deleted regardless of whether the message is received.

    • Message Delay Period: the period after which all messages sent to the queue are consumed.

    • Enable Logging Feature: specifies whether to enable the logging feature. If this feature is enabled, SMQ automatically pushes the operation logs of this queue to the specified Logstore. You can then view the message trace, delay, and other information from the logs. For more information, see Log management.

    The created queue appears on the Queues page.

Send a message

  1. On the Queues page, find the target queue, and in the Action column, choose More > Send Messages.

  2. On the Quick Experience For Sending And Receiving Messages page, go to the Send Message section. Enter the Message Content and Message Delay Period, and then click Send Message.

    A "Message sent successfully" message appears.

Receive a message

  1. On the Queues page, find the target queue, and in the Action column, choose More > Send Messages.

  2. Optional: On the Quick Experience For Sending And Receiving Messages page, go to the Receive Message section and click Edit Parameters of Receiving Messages. In the Edit Parameters of Receiving Messages panel, configure the Receive Times and Polling Period parameters, and then click OK.

  3. In the Receive Message section of the Quick Experience For Sending And Receiving Messages page, click Receive Message.

    The list of messages in the queue is displayed in the Receive Message section.

  4. Optional: In the message list, find the target message and click Details in the Actions column. In the Message Details dialog box, you can view information such as the message body.

Delete a queue

  1. On the Queues page, find the target queue, and in the Actions column, choose More > Delete.

  2. In the Notice dialog box, read the notice and then click Confirm.

    The queue is deleted and no longer appears on the Queues page.

    Warning
    • After a queue is deleted, its data cannot be recovered.

    • Before you delete a queue, stop sending API requests to it. Otherwise, you will still be charged for the API requests.