sqs-dg-2009-02-01

Amazon Simple Queue Service Developer Guide
Queue and Message Identifiers
Queue and Message Identifiers
SQS uses the following three identifiers that you need to be familiar with:
• Queue URL
• Message ID
• Receipt handle
Queue URLs
When creating a new queue, you must provide a queue name that is unique within the scope of all your
queues. If you create queues using both the 2008-01-01 WSDL and a previous version, you still have a
single namespace for all your queues. SQS assigns each queue you create an identifier called a queue
URL, which includes the queue name and other components that SQS determines. Whenever you want
to perform an action on a queue, you provide its queue URL.
The following is the queue URL for a queue named "queue2" owned by a person with the AWS account
number "123456789012".
http://sqs.us-east-1.amazonaws.com/123456789012/queue2
Important
In your system, always store the entire queue URL as Amazon SQS returned it to you when you
created the queue (for example,
http://sqs.us-east-1.amazonaws.com/123456789012/queue2). Don't build the queue
URL from its separate components each time you need to specify the queue URL in a request
because Amazon SQS could change the components that make up the queue URL.
You can also get the queue URL for a queue by listing your queues. Even though you have a single
namespace for all your queues, the list of queues returned depends on the WSDL you use for the request.
For more information, see ListQueues.
API Version 2009-02-01
6