# ProvisionedPollerConfigProperty

The [provisioned mode](https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#invocation-eventsourcemapping-provisioned-mode) configuration for the event source. Use Provisioned Mode to customize the minimum and maximum number of event pollers for your event source.

- Source: Generated at build time
- Type last changed: v2.227.0 · 21 Nov 2025

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_lambda as lambda } from 'aws-cdk-lib';
const provisionedPollerConfigProperty: lambda.CfnEventSourceMapping.ProvisionedPollerConfigProperty = {
  maximumPollers: 123,
  minimumPollers: 123,
  pollerGroupName: 'pollerGroupName',
};
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_lambda as lambda_

provisioned_poller_config_property = lambda.CfnEventSourceMapping.ProvisionedPollerConfigProperty(
    maximum_pollers=123,
    minimum_pollers=123,
    poller_group_name="pollerGroupName"
)
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.lambda.*;

ProvisionedPollerConfigProperty provisionedPollerConfigProperty = ProvisionedPollerConfigProperty.builder()
        .maximumPollers(123)
        .minimumPollers(123)
        .pollerGroupName("pollerGroupName")
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Lambda;

var provisionedPollerConfigProperty = new ProvisionedPollerConfigProperty {
    MaximumPollers = 123,
    MinimumPollers = 123,
    PollerGroupName = "pollerGroupName"
};
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"

provisionedPollerConfigProperty := &ProvisionedPollerConfigProperty{
	MaximumPollers: jsii.Number(123),
	MinimumPollers: jsii.Number(123),
	PollerGroupName: jsii.String("pollerGroupName"),
}
```

## Properties

- `maximumPollers`: number — The maximum number of event pollers this event source can scale up to.

  For Amazon SQS events source mappings, default is 200, and minimum value allowed is 2. For Amazon MSK and self-managed Apache Kafka event source mappings, default is 200, and minimum value allowed is 1.

- `minimumPollers`: number — The minimum number of event pollers this event source can scale down to.

  For Amazon SQS events source mappings, default is 2, and minimum 2 required. For Amazon MSK and self-managed Apache Kafka event source mappings, default is 1.

- `pollerGroupName`: string — (Amazon MSK and self-managed Apache Kafka) The name of the provisioned poller group.

  Use this option to group multiple ESMs within the event source's VPC to share Event Poller Unit (EPU) capacity. You can use this option to optimize Provisioned mode costs for your ESMs. You can group up to 100 ESMs per poller group and aggregate maximum pollers across all ESMs in a group cannot exceed 2000.
