AmazonSQSClient.CreateQueue Method (CreateQueueRequest)

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.

To successfully create a new queue, you must provide a queue name that adheres to the limits related to queues and is unique within the scope of your queues.

After you create a queue, you must wait at least one second after the queue is created to be able to use the queue.

To get the queue URL, use the GetQueueUrl action. GetQueueUrl requires only the QueueName parameter. be aware of existing queue names:

If you provide the name of an existing queue along with the exact names and values of all the queue's attributes, CreateQueue returns the queue URL for the existing queue.
If the queue name, attribute names, or attribute values don't match an existing queue, CreateQueue returns an error.

Cross-account permissions don't apply to this action. For more information, see Grant cross-account permissions to a role and a username in the Amazon SQS Developer Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateQueueAsync.

Namespace: Amazon.SQS
Assembly: AWSSDK.SQS.dll
Version: 3.x.y.z

Syntax

public virtual CreateQueueResponse CreateQueue(
         CreateQueueRequest request
)

Parameters

request: Type: Amazon.SQS.Model.CreateQueueRequest

Container for the necessary parameters to execute the CreateQueue service method.

Return Value

Type: CreateQueueResponse

The response from the CreateQueue service method, as returned by SQS.

Exceptions

Exception	Condition
InvalidAddressException	The accountId is invalid.
InvalidAttributeNameException	The specified attribute doesn't exist.
InvalidAttributeValueException	A queue attribute value is invalid.
InvalidSecurityException	When the request to a queue is not HTTPS and SigV4.
QueueDeletedRecentlyException	You must wait 60 seconds after deleting a queue before you can create another queue with the same name.
QueueNameExistsException	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.
RequestThrottledException	The request was denied due to request throttling. The rate of requests per second exceeds the Amazon Web Services KMS request quota for an account and Region. A burst or sustained high rate of requests to change the state of the same KMS key. This condition is often known as a "hot key." Requests for operations on KMS keys in a Amazon Web Services CloudHSM key store might be throttled at a lower-than-expected rate when the Amazon Web Services CloudHSM cluster associated with the Amazon Web Services CloudHSM key store is processing numerous commands, including those unrelated to the Amazon Web Services CloudHSM key store.
UnsupportedOperationException	Error code 400. Unsupported operation.

Examples

This example shows how to create a queue.

Create queue example

var client = new AmazonSQSClient();

var attrs = new Dictionary<string, string>();

// Maximum message size of 256 KiB (1,024 bytes * 256 KiB = 262,144 bytes).
int maxMessage = 256 * 1024;

attrs.Add(QueueAttributeName.DelaySeconds,
  TimeSpan.FromSeconds(5).TotalSeconds.ToString());
attrs.Add(QueueAttributeName.MaximumMessageSize, maxMessage.ToString());
attrs.Add(QueueAttributeName.MessageRetentionPeriod,
  TimeSpan.FromDays(4).TotalSeconds.ToString());
attrs.Add(QueueAttributeName.ReceiveMessageWaitTimeSeconds,
  TimeSpan.FromSeconds(5).TotalSeconds.ToString());
attrs.Add(QueueAttributeName.VisibilityTimeout,
  TimeSpan.FromHours(12).TotalSeconds.ToString());

var request = new CreateQueueRequest
{
  Attributes = attrs,
  QueueName = "MyTestQueue"
};

var response = client.CreateQueue(request);

Console.WriteLine("Queue URL: " + response.QueueUrl);

The following operation creates an SQS queue named MyQueue.

Create an SQS queue


var client = new AmazonSQSClient();
var response = client.CreateQueue(new CreateQueueRequest 
{
    QueueName = "MyQueue", // The Name for the new queue
    Attributes = new Dictionary<string, string> {
        { "foo", "bar" },
        { "ghoti", "fish" }
    }
});

string queueUrl = response.QueueUrl; // The URL of the new queue

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

AmazonSQSClient.CreateQueue (CreateQueueRequest)

Method