Package software.amazon.awscdk.services.lambda

Class EventSourceMappingProps.Builder

java.lang.Object

software.amazon.awscdk.services.lambda.EventSourceMappingProps.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<EventSourceMappingProps>

Enclosing interface:

EventSourceMappingProps

@Stability(Stable)
public static final class EventSourceMappingProps.Builder
extends Object
implements software.amazon.jsii.Builder<EventSourceMappingProps>

A builder for EventSourceMappingProps

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
EventSourceMappingProps.Builder	batchSize(Number batchSize)	Sets the value of EventSourceMappingOptions.getBatchSize()
EventSourceMappingProps.Builder	bisectBatchOnError(Boolean bisectBatchOnError)	Sets the value of EventSourceMappingOptions.getBisectBatchOnError()
EventSourceMappingProps	build()	Builds the configured instance.
EventSourceMappingProps.Builder	enabled(Boolean enabled)	Sets the value of EventSourceMappingOptions.getEnabled()
EventSourceMappingProps.Builder	eventSourceArn(String eventSourceArn)	Sets the value of EventSourceMappingOptions.getEventSourceArn()
EventSourceMappingProps.Builder	filters(List<? extends Map<String,? extends Object>> filters)	Sets the value of EventSourceMappingOptions.getFilters()
EventSourceMappingProps.Builder	kafkaBootstrapServers(List<String> kafkaBootstrapServers)	Sets the value of EventSourceMappingOptions.getKafkaBootstrapServers()
EventSourceMappingProps.Builder	kafkaConsumerGroupId(String kafkaConsumerGroupId)	Sets the value of EventSourceMappingOptions.getKafkaConsumerGroupId()
EventSourceMappingProps.Builder	kafkaTopic(String kafkaTopic)	Sets the value of EventSourceMappingOptions.getKafkaTopic()
EventSourceMappingProps.Builder	maxBatchingWindow(Duration maxBatchingWindow)	Sets the value of EventSourceMappingOptions.getMaxBatchingWindow()
EventSourceMappingProps.Builder	maxConcurrency(Number maxConcurrency)	Sets the value of EventSourceMappingOptions.getMaxConcurrency()
EventSourceMappingProps.Builder	maxRecordAge(Duration maxRecordAge)	Sets the value of EventSourceMappingOptions.getMaxRecordAge()
EventSourceMappingProps.Builder	onFailure(IEventSourceDlq onFailure)	Sets the value of EventSourceMappingOptions.getOnFailure()
EventSourceMappingProps.Builder	parallelizationFactor(Number parallelizationFactor)	Sets the value of EventSourceMappingOptions.getParallelizationFactor()
EventSourceMappingProps.Builder	reportBatchItemFailures(Boolean reportBatchItemFailures)	Sets the value of EventSourceMappingOptions.getReportBatchItemFailures()
EventSourceMappingProps.Builder	retryAttempts(Number retryAttempts)	Sets the value of EventSourceMappingOptions.getRetryAttempts()
EventSourceMappingProps.Builder	sourceAccessConfigurations(List<? extends SourceAccessConfiguration> sourceAccessConfigurations)	Sets the value of EventSourceMappingOptions.getSourceAccessConfigurations()
EventSourceMappingProps.Builder	startingPosition(StartingPosition startingPosition)	Sets the value of EventSourceMappingOptions.getStartingPosition()
EventSourceMappingProps.Builder	startingPositionTimestamp(Number startingPositionTimestamp)	Sets the value of EventSourceMappingOptions.getStartingPositionTimestamp()
EventSourceMappingProps.Builder	supportS3OnFailureDestination(Boolean supportS3OnFailureDestination)	Sets the value of EventSourceMappingOptions.getSupportS3OnFailureDestination()
EventSourceMappingProps.Builder	target(IFunction target)	Sets the value of EventSourceMappingProps.getTarget()
EventSourceMappingProps.Builder	tumblingWindow(Duration tumblingWindow)	Sets the value of EventSourceMappingOptions.getTumblingWindow()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Builder

public Builder()

Method Details

target

@Stability(Stable)
public EventSourceMappingProps.Builder target(IFunction target)

Sets the value of EventSourceMappingProps.getTarget()

Parameters:

target - The target AWS Lambda function. This parameter is required.

Returns:

this

batchSize

@Stability(Stable)
public EventSourceMappingProps.Builder batchSize(Number batchSize)

Sets the value of EventSourceMappingOptions.getBatchSize()

Parameters:

batchSize - The largest number of records that AWS Lambda will retrieve from your event source at the time of invoking your function. Your function receives an event with all the retrieved records.

Valid Range: Minimum value of 1. Maximum value of 10000.

Returns:

this

bisectBatchOnError

@Stability(Stable)
public EventSourceMappingProps.Builder bisectBatchOnError(Boolean bisectBatchOnError)

Sets the value of EventSourceMappingOptions.getBisectBatchOnError()

Parameters:

bisectBatchOnError - If the function returns an error, split the batch in two and retry.

Returns:

this

enabled

@Stability(Stable)
public EventSourceMappingProps.Builder enabled(Boolean enabled)

Sets the value of EventSourceMappingOptions.getEnabled()

Parameters:

enabled - Set to false to disable the event source upon creation.

Returns:

this

eventSourceArn

@Stability(Stable)
public EventSourceMappingProps.Builder eventSourceArn(String eventSourceArn)

Sets the value of EventSourceMappingOptions.getEventSourceArn()

Parameters:

eventSourceArn - The Amazon Resource Name (ARN) of the event source. Any record added to this stream can invoke the Lambda function.

Returns:

this

filters

@Stability(Stable)
public EventSourceMappingProps.Builder filters(List<? extends Map<String,? extends Object>> filters)

Sets the value of EventSourceMappingOptions.getFilters()

Parameters:

filters - Add filter criteria to Event Source.

Returns:

this

kafkaBootstrapServers

@Stability(Stable)
public EventSourceMappingProps.Builder kafkaBootstrapServers(List<String> kafkaBootstrapServers)

Sets the value of EventSourceMappingOptions.getKafkaBootstrapServers()

Parameters:

kafkaBootstrapServers - A list of host and port pairs that are the addresses of the Kafka brokers in a self managed "bootstrap" Kafka cluster that a Kafka client connects to initially to bootstrap itself. They are in the format abc.example.com:9096.

Returns:

this

kafkaConsumerGroupId

@Stability(Stable)
public EventSourceMappingProps.Builder kafkaConsumerGroupId(String kafkaConsumerGroupId)

Sets the value of EventSourceMappingOptions.getKafkaConsumerGroupId()

Parameters:

kafkaConsumerGroupId - The identifier for the Kafka consumer group to join. The consumer group ID must be unique among all your Kafka event sources. After creating a Kafka event source mapping with the consumer group ID specified, you cannot update this value. The value must have a lenght between 1 and 200 and full the pattern '[a-zA-Z0-9-/:_+=.@-]'. For more information, see Customizable consumer group ID.

Returns:

this

kafkaTopic

@Stability(Stable)
public EventSourceMappingProps.Builder kafkaTopic(String kafkaTopic)

Sets the value of EventSourceMappingOptions.getKafkaTopic()

Parameters:

kafkaTopic - The name of the Kafka topic.

Returns:

this

maxBatchingWindow

@Stability(Stable)
public EventSourceMappingProps.Builder maxBatchingWindow(Duration maxBatchingWindow)

Sets the value of EventSourceMappingOptions.getMaxBatchingWindow()

Parameters:

maxBatchingWindow - The maximum amount of time to gather records before invoking the function. Maximum of Duration.minutes(5)

Returns:

this

maxConcurrency

@Stability(Stable)
public EventSourceMappingProps.Builder maxConcurrency(Number maxConcurrency)

Sets the value of EventSourceMappingOptions.getMaxConcurrency()

Parameters:

maxConcurrency - The maximum concurrency setting limits the number of concurrent instances of the function that an Amazon SQS event source can invoke.

Returns:

this

maxRecordAge

@Stability(Stable)
public EventSourceMappingProps.Builder maxRecordAge(Duration maxRecordAge)

Sets the value of EventSourceMappingOptions.getMaxRecordAge()

Parameters:

maxRecordAge - The maximum age of a record that Lambda sends to a function for processing. Valid Range:

• Minimum value of 60 seconds
• Maximum value of 7 days

Returns:

this

onFailure

@Stability(Stable)
public EventSourceMappingProps.Builder onFailure(IEventSourceDlq onFailure)

Sets the value of EventSourceMappingOptions.getOnFailure()

Parameters:

onFailure - An Amazon SQS queue or Amazon SNS topic destination for discarded records.

Returns:

this

parallelizationFactor

@Stability(Stable)
public EventSourceMappingProps.Builder parallelizationFactor(Number parallelizationFactor)

Sets the value of EventSourceMappingOptions.getParallelizationFactor()

Parameters:

parallelizationFactor - The number of batches to process from each shard concurrently. Valid Range:

• Minimum value of 1
• Maximum value of 10

Returns:

this

reportBatchItemFailures

@Stability(Stable)
public EventSourceMappingProps.Builder reportBatchItemFailures(Boolean reportBatchItemFailures)

Sets the value of EventSourceMappingOptions.getReportBatchItemFailures()

Parameters:

reportBatchItemFailures - Allow functions to return partially successful responses for a batch of records.

Returns:

this

retryAttempts

@Stability(Stable)
public EventSourceMappingProps.Builder retryAttempts(Number retryAttempts)

Sets the value of EventSourceMappingOptions.getRetryAttempts()

Parameters:

retryAttempts - The maximum number of times to retry when the function returns an error. Set to undefined if you want lambda to keep retrying infinitely or until the record expires.

Valid Range:

• Minimum value of 0
• Maximum value of 10000

Returns:

this

sourceAccessConfigurations

@Stability(Stable)
public EventSourceMappingProps.Builder sourceAccessConfigurations(List<? extends SourceAccessConfiguration> sourceAccessConfigurations)

Sets the value of EventSourceMappingOptions.getSourceAccessConfigurations()

Parameters:

sourceAccessConfigurations - Specific settings like the authentication protocol or the VPC components to secure access to your event source.

Returns:

this

startingPosition

@Stability(Stable)
public EventSourceMappingProps.Builder startingPosition(StartingPosition startingPosition)

Sets the value of EventSourceMappingOptions.getStartingPosition()

Parameters:

startingPosition - The position in the DynamoDB, Kinesis or MSK stream where AWS Lambda should start reading.

Returns:

this

startingPositionTimestamp

@Stability(Stable)
public EventSourceMappingProps.Builder startingPositionTimestamp(Number startingPositionTimestamp)

Sets the value of EventSourceMappingOptions.getStartingPositionTimestamp()

Parameters:

startingPositionTimestamp - The time from which to start reading, in Unix time seconds.

Returns:

this

supportS3OnFailureDestination

@Stability(Stable)
public EventSourceMappingProps.Builder supportS3OnFailureDestination(Boolean supportS3OnFailureDestination)

Sets the value of EventSourceMappingOptions.getSupportS3OnFailureDestination()

Parameters:

supportS3OnFailureDestination - Check if support S3 onfailure destination(ODF). Currently only MSK and self managed kafka event support S3 ODF

Returns:

this

tumblingWindow

@Stability(Stable)
public EventSourceMappingProps.Builder tumblingWindow(Duration tumblingWindow)

Sets the value of EventSourceMappingOptions.getTumblingWindow()

Parameters:

tumblingWindow - The size of the tumbling windows to group records sent to DynamoDB or Kinesis.

Returns:

this

build

@Stability(Stable)
public EventSourceMappingProps build()

Builds the configured instance.

Specified by:

build in interface software.amazon.jsii.Builder<EventSourceMappingProps>

Returns:

a new instance of EventSourceMappingProps

Throws:

NullPointerException - if any required attribute was not provided