Package software.amazon.awscdk.services.sns

Interface DeliveryPolicy

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

DeliveryPolicy.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-17T14:41:01.151Z")
@Stability(Stable)
public interface DeliveryPolicy
extends software.amazon.jsii.JsiiSerializable

Options for customising the delivery of SNS messages to HTTP/S endpoints.

Example:

 Topic myTopic = new Topic(this, "MyTopic");
 myTopic.addSubscription(
 UrlSubscription.Builder.create("https://foobar.com/")
         .deliveryPolicy(DeliveryPolicy.builder()
                 .healthyRetryPolicy(HealthyRetryPolicy.builder()
                         .minDelayTarget(Duration.seconds(5))
                         .maxDelayTarget(Duration.seconds(10))
                         .numRetries(6)
                         .backoffFunction(BackoffFunction.EXPONENTIAL)
                         .build())
                 .throttlePolicy(ThrottlePolicy.builder()
                         .maxReceivesPerSecond(10)
                         .build())
                 .requestPolicy(RequestPolicy.builder()
                         .headerContentType("application/json")
                         .build())
                 .build())
         .build());
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	DeliveryPolicy.Builder	A builder for DeliveryPolicy
static final class	DeliveryPolicy.Jsii$Proxy	An implementation for DeliveryPolicy

Method Summary

Modifier and Type	Method	Description
static DeliveryPolicy.Builder	builder()
default HealthyRetryPolicy	getHealthyRetryPolicy()	The retry policy of the delivery of SNS messages to HTTP/S endpoints.
default RequestPolicy	getRequestPolicy()	The request of the content sent in AWS SNS HTTP/S requests.
default ThrottlePolicy	getThrottlePolicy()	The throttling policy of the delivery of SNS messages to HTTP/S endpoints.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getHealthyRetryPolicy

@Stability(Stable)
@Nullable
default HealthyRetryPolicy getHealthyRetryPolicy()

The retry policy of the delivery of SNS messages to HTTP/S endpoints.

Default: - Amazon SNS attempts up to three retries with a delay between failed attempts set at 20 seconds

getRequestPolicy

@Stability(Stable)
@Nullable
default RequestPolicy getRequestPolicy()

The request of the content sent in AWS SNS HTTP/S requests.

Default: - The content type is set to 'text/plain; charset=UTF-8'

getThrottlePolicy

@Stability(Stable)
@Nullable
default ThrottlePolicy getThrottlePolicy()

The throttling policy of the delivery of SNS messages to HTTP/S endpoints.

Default: - No throttling

builder

@Stability(Stable)
static DeliveryPolicy.Builder builder()

Returns:

a DeliveryPolicy.Builder of DeliveryPolicy