Allow State property to be set for EventBridgeRule event source

[sliedig]

Describe your idea/feature/enhancement

Today, when you create a EventBridge rule that has a function target, there is no way to disable the rule through the template.

I wish the SAM Translator would allow me to explicitly ENABLE and DISABLE the rule in my SAM template

Proposal

Add State to event source definition.

      Events:
        StatusChangedEvent:
          Type: EventBridgeRule
          Properties:
            EventBusName: UnicornEventBus
            State: DISABLED
            Pattern:
              source:
                - unicorn.contracts
              detail-type:
                - ContractStatusChanged

Things to consider:
[x] The SAM documentation will need to be updated

Additional Details

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-rule.html#cfn-events-rule-state

[sebastiankasprzak]

@sriram-mv @sliedig PR raised for this feature

[sliedig]

Thanks @sebastiankasprzak ! Can you add this issue number to the PR description. At the moment it only has #2508

[aahung]

pending: doc release

[aahung]

update: doc updating soon

[aahung]

https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/sam-property-function-eventbridgerule.html#sam-function-eventbridgerule-state