Skip to content

DurableMessagingOptions Properties

Configuration options for durable messaging inboxes, outboxes, and the messaging pump.

DeduplicationWindow

getset
View source
public TimeSpan DeduplicationWindow
Gets or sets how long after a message's send time the receiving inbox retains its processed record and admits deliveries of it. A tracked processed message is answered with DeliveryResult, or, when an inbox sink rejected it on delivery, with the same DeadLettered reason and code.

Property value

The deduplication window. Must be greater than DurableMessagingOptions. Defaults to 7 days.

InboxBatchSize

getset
View source
public int InboxBatchSize
Gets or sets the maximum number of inbox messages processed by one messaging pump pass.

InboxRetryTimeout

getset
View source
public TimeSpan InboxRetryTimeout
Gets or sets how long the inbox retries a message whose handler attempts throw before the message is dead-lettered.

Property value

Must be greater than or equal to System.TimeSpan.Zero, which dead-letters a message at its second failure: recovery can't tell a failed attempt from one which a crash interrupted before it ran. Defaults to 6 hours.

MaxCapacity

getset
View source
public int MaxCapacity
Gets or sets the maximum number of pending inbox messages. When this limit is reached, new deliveries return Backpressured.

Property value

The maximum inbox capacity. Must be greater than zero. Defaults to 1000.

OutboxBatchSize

getset
View source
public int OutboxBatchSize
Gets or sets the maximum number of outbox delivery attempts in flight for one grain.

OutboxRetryTimeout

getset
View source
public TimeSpan OutboxRetryTimeout
Gets or sets how long after a message's send time the outbox attempts delivery before it dead-letters the message, including while the receiver is backpressured or reports no inbox handler.

Property value

Must be greater than zero and less than DurableMessagingOptions, so the retry budget ends within the receiver's retention window. Defaults to 6 hours.

RetryInitialInterval

getset
View source
public TimeSpan RetryInitialInterval
Gets or sets the delay before the first retry of a failed outbox delivery or inbox processing attempt.

Property value

The initial retry interval. Must be greater than zero. Defaults to 1 second.