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.
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:DeleteMessageandqueue: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.
- Open Queues, then choose Create queue.
- For Name, enter my-queue.
- Leave Dead-letter queue selected, with 5 receives.
- Choose Create.
The console creates my-queue-dlq and then my-queue, and opens the queue's page.
dcloud queue queues create --name my-queue-dlq
dcloud queue queues create --name my-queue --dead-letter-queue '{"name":"my-queue-dlq","maxReceiveCount":5}'POST /queue/api/queues
{ "name": "my-queue-dlq" }POST /queue/api/queues
{ "name": "my-queue", "deadLetterQueue": { "name": "my-queue-dlq", "maxReceiveCount": 5 } }Step 2: Send a message
- On the queue's page, choose Send and receive.
- Under Send a message, for Body, enter
{"orderId": 42}. - Choose Send.
The section shows Sent and the new message's id.
dcloud queue messages send my-queue --body '{"orderId": 42}'POST /queue/api/queues/my-queue/messages
{ "body": "{\"orderId\": 42}" }The answer is 201 with the message's messageId.
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.
- Under Receive messages, choose Poll for messages.
- On the message, choose Delete.
The message disappears from the list.
dcloud queue messages receive my-queue --wait-seconds 20
dcloud queue messages delete my-queue receipt-handleReplace receipt-handle with the receiptHandle the receive printed.
POST /queue/api/queues/my-queue/receive
{ "waitSeconds": 20 }Then delete the message with the receiptHandle from the answer:
DELETE /queue/api/queues/my-queue/messages/{receiptHandle}Clean up
Delete my-queue first: a queue that another queue uses as its dead-letter queue cannot be deleted.
- On my-queue's page, choose Danger zone.
- Under Delete queue, choose Delete queue, enter the queue's name, and choose Delete queue. The console returns to the queue list.
- Open my-queue-dlq and delete it the same way.
dcloud queue queues delete my-queue
dcloud queue queues delete my-queue-dlqDELETE /queue/api/queues/my-queueDELETE /queue/api/queues/my-queue-dlq