DocumentDB 8.0 not supported as a Lambda event source (CreateEventSourceMapping InvalidParameterValueException) - is 8.0.x support planned?
Hi, I'm trying to configure an Amazon DocumentDB cluster as an event source for a Lambda function (a change-stream trigger), but CreateEventSourceMapping fails on engine version 8.0.1.
Error: operation error Lambda: CreateEventSourceMapping, https response error StatusCode: 400, RequestID: 092d2166-1705-48c7-a992-be9c7462855f, InvalidParameterValueException: Engine version 8.0.1 is not supported.
Setup:
- DocumentDB engine version: 8.0.1
- Cluster type: instance-based, regional (not elastic/global)
- Change streams: enabled
- Action: creating a Lambda event source mapping pointing at the cluster
- Regions: eu-central-1, us-east-1
Key observation: if I create the event source mapping while the cluster is on 5.0.0 and then upgrade the cluster to 8.0.1, the existing trigger continues to work fine. So the 8.0 engine appears fully compatible with the change-stream / event-source-mapping mechanism at runtime - the only thing that fails is the CreateEventSourceMapping call itself, which seems to reject 8.0.1 at a version-validation step rather than for any functional reason.
I see from the Lambda docs ("Process Amazon DocumentDB events with Lambda") and the DocumentDB docs ("Using AWS Lambda with change streams") that event source mappings are currently listed as supported only on DocumentDB 4.0 and 5.0, so I assume this error is expected for 8.0 rather than a misconfiguration on my end.
A few questions:
- Given that mappings created on 5.0 keep working after an in-place upgrade to 8.0, is the restriction purely a version allowlist in CreateEventSourceMapping? If so, could 8.0.1 be added to the accepted versions?
- Is Lambda event-source-mapping support for DocumentDB 8.0 on the roadmap, and is there any indicative timeline?
- Is there a recommended way to create a trigger on an 8.0 cluster in the meantime, short of running a 5.0 cluster (or the create-on-5.0-then-upgrade workaround above)?
- Could the supported-versions note in both docs pages (and ideally the error message) be updated to explicitly call out 8.0? Today they list only 4.0/5.0 and don't mention 8.0, which made it ambiguous whether this was a hard limitation or something wrong in my setup.
Thanks!
- Newest
- Most votes
- Most comments
Amazon DocumentDB 8.0 clusters are not yet supported as Lambda event sources.
https://docs.aws.amazon.com/lambda/latest/dg/with-documentdb.html
Based on the current documentation, AWS Lambda event source mapping integration with Amazon DocumentDB change streams is officially supported only on DocumentDB versions 4.0 and 5.0. DocumentDB 8.0 is not currently listed as a supported version for this feature.
Your observation that existing event source mappings created on version 5.0 continue to function after upgrading to 8.0 is interesting and suggests runtime compatibility. However, the CreateEventSourceMapping API enforces version validation at the time of creation, which is why you're encountering the InvalidParameterValueException when attempting to create new mappings directly on an 8.0 cluster.
Regarding your specific questions:
Support status: The documentation explicitly states that Lambda integration is not currently supported on DocumentDB 8.0. The restriction you're experiencing during the CreateEventSourceMapping call is the expected behavior based on current service capabilities.
Workaround: As you've discovered, creating the event source mapping on a 5.0 cluster and then upgrading to 8.0 appears to work, though this is not an officially documented approach. For production workloads, it's generally recommended to use officially supported configurations.
Recommendations: For the most reliable setup, consider remaining on DocumentDB 5.0 if Lambda event source mapping is a critical requirement for your architecture. Alternatively, you could implement a custom solution using change streams with a polling mechanism from your Lambda function, though this would require different architectural considerations.
I cannot provide information about future roadmaps or planned feature releases. For the latest updates on feature availability and to express interest in DocumentDB 8.0 support for Lambda event source mappings, I recommend reaching out through the AWS Support Center at https://console.aws.amazon.com/support/ where you can provide feedback and inquire about feature requests.
Sources
Using AWS Lambda with change streams - Amazon DocumentDB
Relevant content
asked a year ago
- AWS OFFICIALUpdated 10 months ago
