No way to set the EventBridge event version

[togakangaroo]

Describe the bug

In the AWS EventBridge spec on events you have the version field.

The put_events function understandably mirrors this but does not support that as an argument and indeed trying to pass the event version results in an error.

Expected Behavior

I expect to be able to set the event version so that rules can be applied based on event versioning as seems to be intended by the AWS documentation.

Current Behavior

An error occurs that an unknown field was passed in.

   events = boto3.client("events")
    event = {
        "Version": "2",
        "Source": "test",
        "DetailType": "test",
        "Detail": "foo",
    }
    response = events.put_events(Entries=[event])

Reproduction Steps

Not really applicable since this seems to be a missing feature, where it is impossible to work with eventbridge event versions as intended. Boto3 doesn't make the claim that it can set that field, it simply doesn't mention it.

Possible Solution

Something like what I described in the expected is what I would hope to be able to do.

An alternative is to give guidance on how else this value could be set.

Additional Information/Context

I'm not sure what layer the issue lies it. It is possible that the AWS Eventbridge team itself introduced this field but then didn't provide ways to affect it, but that would be really bizarre and probably be worth a callout in the boto3 docs.

SDK version used

boto3==1.26.153

Environment details (OS name and version, etc.)

OsXApple M2 Pro

[togakangaroo]

I have discovered that version is meant to be an AWS-controlled field, not - as implied - for versioning your events.

The issue is therefore in the AWS documentation. I've reported it there and I'm going to close this