Creates a new standard or FIFO queue. You can pass one or more attributes in
the request. Keep the following in mind:
If you don't specify the FifoQueue attribute, Amazon SQS creates a standard queue.
You can't change the queue type after you create it and you can't convert
an existing standard queue into a FIFO queue. You must either create a new
FIFO queue for your application or delete your existing standard queue and
recreate it as a FIFO queue. For more information, see Moving From a Standard Queue to a FIFO Queue in the
Amazon SQS Developer Guide.
If you don't provide a value for an attribute, the queue is created with the default value for the attribute.
If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.
<p>Tosuccessfullycreateanewqueue, youmustprovideaqueuenamethatadherestothe <ahref="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html">limitsrelatedtoqueues</a> andisuniquewithinthescopeofyourqueues.</p> <note> <p>Afteryoucreateaqueue, youmustwaitatleastonesecondafterthequeueis createdtobeabletousethequeue.</p> </note> <p>TogetthequeueURL, usethe <code> <a>GetQueueUrl</a> </code> action. <code> <a>GetQueueUrl</a> </code> requiresonlythe <code>QueueName</code> parameter. beawareofexistingqueuenames:</p> <ul> <li> <p>Ifyouprovidethenameofanexistingqueuealongwiththeexactnamesandvaluesofallthequeue's attributes, <code>CreateQueue</code> returns the queue URL for the existing queue.</p> </li> <li> <p>Ifthequeuename, attributenames, orattributevaluesdon't match an existing queue, <code>CreateQueue</code> returns an error.</p> </li> </ul> <p>Someactionstakelistsofparameters. Theselistsarespecifiedusingthe <code>param.n</code> notation. Valuesof <code>n</code> areintegersstartingfrom1.Forexample, aparameterlistwithtwoelementslookslikethis:</p> <p> <code>&AttributeName.1=first</code> </p> <p> <code>&AttributeName.2=second</code> </p> <note> <p>Cross-accountpermissionsdon't apply to this action. For more information,
A queue with this name already exists. Amazon SQS returns this error only if the request
includes attributes whose values differ from those of the existing queue.
Creates a new standard or FIFO queue. You can pass one or more attributes in the request. Keep the following in mind:
If you don't specify the
FifoQueue
attribute, Amazon SQS creates a standard queue.You can't change the queue type after you create it and you can't convert an existing standard queue into a FIFO queue. You must either create a new FIFO queue for your application or delete your existing standard queue and recreate it as a FIFO queue. For more information, see Moving From a Standard Queue to a FIFO Queue in the Amazon SQS Developer Guide.
If you don't provide a value for an attribute, the queue is created with the default value for the attribute.
If you delete a queue, you must wait at least 60 seconds before creating a queue with the same name.
see Grant cross-account permissions to a role and a user name in the Amazon SQS Developer Guide.
Example
Use a bare-bones client and the command you need to make an API call.
Param
CreateQueueCommandInput
Returns
CreateQueueCommandOutput
See
input
shape.response
shape.config
shape.Throws
QueueDeletedRecently (client fault)
You must wait 60 seconds after deleting a queue before you can create another queue with the same name.
Throws
QueueNameExists (client fault)
A queue with this name already exists. Amazon SQS returns this error only if the request includes attributes whose values differ from those of the existing queue.