Get started with Queues

Create a queue with a dead-letter queue, send a message, receive and delete it, and delete both queues again, in about ten minutes.

Last updated 18 November 2026View as Markdown

Replace my-queue with a name of your own, and my-queue-dlq with that name followed by -dlq.

Prerequisites

  • Permission for queue:ListQueues, queue:GetQueueAttributes, queue:CreateQueue, queue:SendMessage, queue:ReceiveMessage, queue:DeleteMessage and queue:DeleteQueue.
  • For the CLI steps, the dcloud CLI, signed in. For the API steps, an access key (see Security).

Step 1: Create a queue

You create two queues: my-queue, and my-queue-dlq as its dead-letter queue, which takes a message after five receives without a delete. Requests and stored messages are billed from now on.

  1. Open Queues, then choose Create queue.
  2. For Name, enter my-queue.
  3. Leave Dead-letter queue selected, with 5 receives.
  4. Choose Create.

The console creates my-queue-dlq and then my-queue, and opens the queue's page.

Step 2: Send a message

  1. On the queue's page, choose Send and receive.
  2. Under Send a message, for Body, enter {"orderId": 42}.
  3. Choose Send.

The section shows Sent and the new message's id.

Step 3: Receive and delete the message

A receive hides the message from other consumers for the visibility timeout (30 seconds on a new queue). Delete it within that time, or it is delivered again.

  1. Under Receive messages, choose Poll for messages.
  2. On the message, choose Delete.

The message disappears from the list.

Clean up

Delete my-queue first: a queue that another queue uses as its dead-letter queue cannot be deleted.

  1. On my-queue's page, choose Danger zone.
  2. Under Delete queue, choose Delete queue, enter the queue's name, and choose Delete queue. The console returns to the queue list.
  3. Open my-queue-dlq and delete it the same way.

Next steps

Did this page help you?