Queues

New

Provide the following information to create a new SQS Queue.

• Queue Name - A nickname for the SQS queue. Similar to S3 bucket names, SQS queue names must be unique.
• API Generation - The queue's API generation (Gen1 or Gen2). It's possible to create Gen1 queues but unless there are severe constraints, it's best to use only Gen2 queues. (Default = 2)
• Visibility Timeout - Specifies the time in seconds that a job will remain hidden before it becomes available to other worker instances.

Index

A comprehensive list of Amazon SQS queues associated with this account is displayed.

If you see an "Access to SQS queues is currently disabled for this account" message and you want to use Amazon's Simple Queue Service, select the Enable action button. Enabling queues for your account may take 5-10 seconds. Once enabled, you will see the following information in table form:

• Name - A nickname for the SQS queue. Similar to S3 bucket names, SQS queue names must be unique.
• API Gen - The queue's API generation (Gen1 or Gen2). If you are still using Gen1 SQS Queues see the important note on Simple Queue Service
• Approx Length - The approximate length of the queue in terms of the number of items.
• Visibility Timeout - Specifies the time in seconds that a job will remain hidden before it becomes available to other worker instances.
• Actions - Clear (remove all) messages in the queue or delete the queue.

Actions

• Enable - Once you've logged into your AWS account and signed up for the SQS service, you can click the Enable button to have RightScale re-query AWS for your supported cloud services. You will only be able to create an SQS queue once RightScale can validate your subscription for this service.
• New Queue - Create a new SQS queue.

- -

Show

View the top item in the queue. This view is meant purely for informational and debugging purposes. Since items may be consumed any time and since SQS moreover is non-deterministic, you cannot assume that the item you are seeing is indeed the next one to be consumed.

Info tab

View general information about the SQS Queue including its URL, size, and server array. You can also manually add a job to the queue.

• Name - A nickname for the SQS queue. Similar to S3 bucket names, SQS queue names must be unique.
• URL - The URL to your queue.
• Amazon API Generation - The queue's API generation (Gen1 or Gen2). If you are still using Gen1 SQS Queues see the important note on Simple Queue Service
• Approx Length - The approximate length of the queue in terms of the number of items.
• Visibility Timeout - Specifies the time in seconds that a job will remain hidden before it becomes available to other worker instances.
• Created by - The email of the person who created the queue.
• Server array(s) - The server array(s) that's configured to use the queue.

Action Buttons

• Refresh - Refresh the queue.
• Clear Queue - Remove all jobs from the queue.
• Delete Queue - Delete the queue.

Policy tab

Create policies that define the permissions for other users when accessing your queues. The policy is similar to a contract or document where you define the following:

• Principal - AWS ID's. Specify who can access your queues
• Action - What actions can users perform? (Ex: send, receive, delete)
• Effect - Allow or Deny access

As a practical example, you could define a policy that allows a user with a specific source IP address, access to your queue. You could also deny several users access after a certain date.

Messages tab

Under the Messages tab you can manually add a new item to the queue or click the View top item link to view the topmost item/message in the queue. However, since items may be consumed any time and since SQS moreover is non-deterministic, you cannot assume that the item you are seeing is indeed the next one to be consumed. It's main purpose is to give you a quick sample of a message in the queue.

• Message ID - The message's unique SQS identifier that's assigned when a message is sent to the queue. (Ex: 8bf87233-7233-7233-7233-790169a723b)
• Sender ID - The AWS account number (or the IP address, if anonymous access is allowed) of the sender. (Ex: 826693181925)
• Sent Timestamp - The timestamp of when (Ex: 2009-06-05 11:08:59 PDT)
• Message Checksum - The message's checksum. An exception will be thrown when there is a message body checksum mismatch.
• Message Body - The raw contents of the message.