Table of Contents

Class AwsSqsProvisioningOptions

Namespace
Excalibur.Dispatch.Transport.Aws
Assembly
Excalibur.Dispatch.Transport.AwsSqs.dll

Controls optional, opt-in provisioning of AWS SQS and SNS infrastructure at startup.

public sealed class AwsSqsProvisioningOptions
Inheritance
AwsSqsProvisioningOptions
Inherited Members
Extension Methods

Remarks

By default the transport assumes queues, dead-letter redrive policies, and SNS subscriptions are pre-provisioned (for example by infrastructure-as-code). When provisioning is enabled the transport applies the configured dead-letter redrive policy to the source queue and creates the configured SNS-to-SQS subscriptions with their filter policies when the host starts.

Provisioning is opt-in (Enabled defaults to false) because a messaging framework must not mutate cloud infrastructure unless the operator explicitly asks it to. Provisioning is fail-open when FailOpen is true: a missing permission or transient error is logged and start-up continues, rather than crashing the host.

Properties

ApplyDeadLetterRedrivePolicy

Gets or sets a value indicating whether to apply the dead-letter redrive policy to the source queue.

public bool ApplyDeadLetterRedrivePolicy { get; set; }

Property Value

bool

true to set the redrive policy when a dead-letter queue is configured; otherwise, false. Default is true.

CreateSnsSubscriptions

Gets or sets a value indicating whether to create the configured SNS-to-SQS subscriptions and filter policies.

public bool CreateSnsSubscriptions { get; set; }

Property Value

bool

true to create subscriptions and apply filter policies; otherwise, false. Default is true.

Enabled

Gets or sets a value indicating whether startup provisioning is enabled.

public bool Enabled { get; set; }

Property Value

bool

true to apply redrive policies and create SNS subscriptions at startup; otherwise, false. Default is false.

FailOpen

Gets or sets a value indicating whether provisioning failures are non-fatal.

public bool FailOpen { get; set; }

Property Value

bool

true to log and continue when provisioning fails (for example due to missing IAM permissions); false to surface the failure. Default is true.