aws-cdk-lib.aws_pipes.CfnPipe.PipeSourceDynamoDBStreamParametersProperty

interface PipeSourceDynamoDBStreamParametersProperty

LanguageType name
.NETAmazon.CDK.AWS.Pipes.CfnPipe.PipeSourceDynamoDBStreamParametersProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awspipes#CfnPipe_PipeSourceDynamoDBStreamParametersProperty
Javasoftware.amazon.awscdk.services.pipes.CfnPipe.PipeSourceDynamoDBStreamParametersProperty
Pythonaws_cdk.aws_pipes.CfnPipe.PipeSourceDynamoDBStreamParametersProperty
TypeScript aws-cdk-lib » aws_pipes » CfnPipe » PipeSourceDynamoDBStreamParametersProperty

The parameters for using a DynamoDB stream as a source.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_pipes as pipes } from 'aws-cdk-lib';
const pipeSourceDynamoDBStreamParametersProperty: pipes.CfnPipe.PipeSourceDynamoDBStreamParametersProperty = {
  startingPosition: 'startingPosition',

  // the properties below are optional
  batchSize: 123,
  deadLetterConfig: {
    arn: 'arn',
  },
  maximumBatchingWindowInSeconds: 123,
  maximumRecordAgeInSeconds: 123,
  maximumRetryAttempts: 123,
  onPartialBatchItemFailure: 'onPartialBatchItemFailure',
  parallelizationFactor: 123,
};

Properties

NameTypeDescription
startingPositionstring(Streams only) The position in a stream from which to start reading.
batchSize?numberThe maximum number of records to include in each batch.
deadLetterConfig?IResolvable | DeadLetterConfigPropertyDefine the target queue to send dead-letter queue events to.
maximumBatchingWindowInSeconds?numberThe maximum length of a time to wait for events.
maximumRecordAgeInSeconds?number(Streams only) Discard records older than the specified age.
maximumRetryAttempts?number(Streams only) Discard records after the specified number of retries.
onPartialBatchItemFailure?string(Streams only) Define how to handle item process failures.
parallelizationFactor?number(Streams only) The number of batches to process concurrently from each shard.

startingPosition

Type: string

(Streams only) The position in a stream from which to start reading.

Valid values : TRIM_HORIZON | LATEST


batchSize?

Type: number (optional)

The maximum number of records to include in each batch.


deadLetterConfig?

Type: IResolvable | DeadLetterConfigProperty (optional)

Define the target queue to send dead-letter queue events to.


maximumBatchingWindowInSeconds?

Type: number (optional)

The maximum length of a time to wait for events.


maximumRecordAgeInSeconds?

Type: number (optional)

(Streams only) Discard records older than the specified age.

The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, EventBridge never discards old records.


maximumRetryAttempts?

Type: number (optional)

(Streams only) Discard records after the specified number of retries.

The default value is -1, which sets the maximum number of retries to infinite. When MaximumRetryAttempts is infinite, EventBridge retries failed records until the record expires in the event source.


onPartialBatchItemFailure?

Type: string (optional)

(Streams only) Define how to handle item process failures.

AUTOMATIC_BISECT halves each batch and retry each half until all the records are processed or there is one failed message left in the batch.


parallelizationFactor?

Type: number (optional)

(Streams only) The number of batches to process concurrently from each shard.

The default value is 1.