Skip to main content

ISQSCreateQueueRequest

Interface in AWS.SQS

Interface for CreateQueue requests.

Ancestors

Properties

Attributes

property Attributes: TDictionary<string, string>

A collection of queue attributes with their corresponding values.

If you don't provide a value for an attribute, the queue is created with the default value. Attributes can be modified after queue creation using SetQueueAttributes. Standard queue attributes include:

  • DelaySeconds – Delivery delay for all messages (0-900 seconds)
  • MaximumMessageSize – Maximum message size in bytes (1024-1048576)
  • MessageRetentionPeriod – Message retention time (60-1209600 seconds)
  • ReceiveMessageWaitTimeSeconds – Long polling wait time (0-20 seconds)
  • VisibilityTimeout – Message visibility timeout (0-43200 seconds)
  • Policy – Queue access policy as JSON FIFO queue specific attributes:
  • FifoQueue – Set to true to create a FIFO queue
  • ContentBasedDeduplication – Enable automatic deduplication
  • DeduplicationScopemessageGroup or queue
  • FifoThroughputLimitperQueue or perMessageGroupId Dead letter queue attributes:
  • RedrivePolicy – Dead letter queue configuration as JSON
  • RedriveAllowPolicy – Controls which queues can use this as a dead letter queue Encryption attributes:
  • KmsMasterKeyId – AWS KMS key for server-side encryption
  • KmsDataKeyReusePeriodSeconds – Data key reuse period (60-86400 seconds)
  • SqsManagedSseEnabled – Enable SQS-managed server-side encryption

QueueName

property QueueName: string

The name of the new queue to be created.

Queue name must be unique within the scope of your queues and can have up to 80 characters. Valid characters include alphanumeric characters, hyphens (-), and underscores (_). A FIFO queue name must end with the .fifo suffix. Queue URLs and names are case-sensitive. If you specify the name of an existing queue with identical attributes, the action returns the URL of the existing queue instead of creating a new one. If attributes differ, an error will be returned.

tags

property tags: TDictionary<string, string>

Cost allocation tags to apply to the specified Amazon SQS queue.

Tags are key-value pairs that help you manage, identify, search, and filter resources. Amazon SQS interprets tags as character strings and they have no semantic meaning. Tag guidelines:

  • Maximum 50 tags per queue (recommended limit)
  • Tags are case-sensitive
  • Keys and values can be up to 128 and 256 characters respectively
  • A new tag with identical key overwrites existing tag To tag a queue on creation, you must have both sqs:CreateQueue and sqs:TagQueue permissions.

Methods

AddAttribute

procedure AddAttribute(const AName, AValue: string);

Add a name/value pair to Attributes.

Parameters

NameDescription
ANameSpecify the name of the attribute to add to Attributes.
AValueSpecify the value of that attribute to add to Attributes.

AddTag

procedure AddTag(const AKey, AValue: string);

Add a key/value pair to tags.

Parameters

NameDescription
AKeySpecify the key of the tag to add to tags.
AValueSpecify the value for the tag to add to tags.