DeliverySpec.RetryAfterMax field

Stage: Alpha, disabled by default

Tracking issue: #5811

When using the delivery spec to configure event delivery parameters, you can use the retryAfterMax field to specify how HTTP headers are handled when calculating backoff times for retrying 429 and 503 responses. You can specify a spec for Channels, Subscriptions, Brokers, Triggers, and any other resource spec that accepts the delivery field.

The retryAfterMax field only takes effect if you configure the spec to perform retries, and only pertains to retry attempts on 429 and 503 response codes. The field provides an override to prevent large Retry-After durations from impacting throughput, and must be specified using the ISO 8601 format. The largest of the normal backoff duration and the Retry-After header value will be used for the subsequent retry attempt. Specifying a “zero” value of PT0S effectively disables Retry-After support.

The following example shows a Subscription that retries sending an event three times, and respects Retry-After headers while imposing a maximum backoff of 120 seconds:

Note