Skip to content

SelfManagedKafkaEventSourceConfig

Structure Class

SelfManagedKafkaEventSourceConfig dataclass

Bases: _SerdeShape

Specific configuration settings for a self-managed Apache Kafka event source.

Attributes

consumer_group_id class-attribute instance-attribute
consumer_group_id: str | None = ...

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. For more information, see Customizable consumer group ID.

consumption_mode class-attribute instance-attribute
consumption_mode: str | None = ...

The mode that Lambda uses to consume records from your self-managed Apache Kafka topic. Valid values are the following:

  • Stream (default) -- Lambda consumes records using a Kafka consumer group and preserves the order of records within each partition.

  • Queue -- Lambda consumes records using a Kafka share group. Multiple consumers can process records from the same partition concurrently, so Lambda doesn't preserve per-partition order. To use Queue mode, your cluster must run Apache Kafka version 4.2 or later with share groups enabled.

If you omit this parameter, Lambda uses Stream.

You cannot change ConsumptionMode after you create the event source mapping. To use a different consumption mode, create a new event source mapping.

When ConsumptionMode is Queue, the StartingPosition, StartingPositionTimestamp, and MaximumBatchingWindowInSeconds parameters are not supported.

schema_registry_config class-attribute instance-attribute
schema_registry_config: KafkaSchemaRegistryConfig | None = ...

Specific configuration settings for a Kafka schema registry.