import kms = require('@aws-cdk/aws-kms'); import cdk = require('@aws-cdk/cdk'); import { QueueRef, QueueUrl } from './queue-ref'; import { QueueArn, QueueName } from './sqs.generated'; /** * Properties for creating a new Queue */ export interface QueueProps { /** * A name for the queue. * * If specified and this is a FIFO queue, must end in the string '.fifo'. * * @default CloudFormation-generated name */ queueName?: string; /** * The number of seconds that Amazon SQS retains a message. * * You can specify an integer value from 60 seconds (1 minute) to 1209600 * seconds (14 days). The default value is 345600 seconds (4 days). * * @default 345600 seconds (4 days) */ retentionPeriodSec?: number; /** * The time in seconds that the delivery of all messages in the queue is delayed. * * You can specify an integer value of 0 to 900 (15 minutes). The default * value is 0. * * @default 0 */ deliveryDelaySec?: number; /** * The limit of how many bytes that a message can contain before Amazon SQS rejects it. * * You can specify an integer value from 1024 bytes (1 KiB) to 262144 bytes * (256 KiB). The default value is 262144 (256 KiB). * * @default 256KiB */ maxMessageSizeBytes?: number; /** * Default wait time for ReceiveMessage calls. * * Does not wait if set to 0, otherwise waits this amount of seconds * by default for messages to arrive. * * For more information, see Amazon SQS Long Poll. * * @default 0 */ receiveMessageWaitTimeSec?: number; /** * Timeout of processing a single message. * * After dequeuing, the processor has this much time to handle the message * and delete it from the queue before it becomes visible again for dequeueing * by another processor. * * Values must be from 0 to 43200 seconds (12 hours). If you don't specify * a value, AWS CloudFormation uses the default value of 30 seconds. * * @default 30 */ visibilityTimeoutSec?: number; /** * Send messages to this queue if they were unsuccessfully dequeued a number of times. * * @default no dead-letter queue */ deadLetterQueue?: DeadLetterQueue; /** * Whether the contents of the queue are encrypted, and by what type of key. * * Be aware that encryption is not available in all regions, please see the docs * for current availability details. * * @default Unencrypted */ encryption?: QueueEncryption; /** * External KMS master key to use for queue encryption. * * Individual messages will be encrypted using data keys. The data keys in * turn will be encrypted using this key, and reused for a maximum of * `dataKeyReuseSecs` seconds. * * The 'encryption' property must be either not specified or set to "Kms". * An error will be emitted if encryption is set to "Unencrypted" or * "KmsManaged". * * @default If encryption is set to KMS and not specified, a key will be created. */ encryptionMasterKey?: kms.EncryptionKeyRef; /** * The length of time that Amazon SQS reuses a data key before calling KMS again. * * The value must be an integer between 60 (1 minute) and 86,400 (24 * hours). The default is 300 (5 minutes). * * @default 300 (5 minutes) */ dataKeyReuseSec?: number; /** * Whether this a first-in-first-out (FIFO) queue. * * @default false, unless queueName ends in '.fifo' or 'contentBasedDeduplication' is true. */ fifo?: boolean; /** * Specifies whether to enable content-based deduplication. * * During the deduplication interval (5 minutes), Amazon SQS treats * messages that are sent with identical content (excluding attributes) as * duplicates and delivers only one copy of the message. * * If you don't enable content-based deduplication and you want to deduplicate * messages, provide an explicit deduplication ID in your SendMessage() call. * * (Only applies to FIFO queues.) * * @default false */ contentBasedDeduplication?: boolean; } /** * Dead letter queue settings */ export interface DeadLetterQueue { /** * The dead-letter queue to which Amazon SQS moves messages after the value of maxReceiveCount is exceeded. */ queue: QueueRef; /** * The number of times a message can be unsuccesfully dequeued before being moved to the dead-letter queue. */ maxReceiveCount: number; } /** * What kind of encryption to apply to this queue */ export declare enum QueueEncryption { /** * Messages in the queue are not encrypted */ Unencrypted = "NONE", /** * Server-side KMS encryption with a master key managed by SQS. */ KmsManaged = "MANAGED", /** * Server-side encryption with a KMS key managed by the user. * * If `encryptionKey` is specified, this key will be used, otherwise, one will be defined. */ Kms = "KMS" } /** * A new Amazon SQS queue */ export declare class Queue extends QueueRef { /** * The ARN of this queue */ readonly queueArn: QueueArn; /** * The name of this queue */ readonly queueName: QueueName; /** * The URL of this queue */ readonly queueUrl: QueueUrl; /** * If this queue is encrypted, this is the KMS key. */ encryptionMasterKey?: kms.EncryptionKeyRef; protected readonly autoCreatePolicy: boolean; constructor(parent: cdk.Construct, name: string, props?: QueueProps); /** * Look at the props, see if the FIFO props agree, and return the correct subset of props */ private determineFifoProps; private determineEncryptionProps; }