RoleArn for AWS::Serverless::StateMachine -> Events -> CWSchedule for Type: Schedule

[roypronoy]

Description:

In the Resource AWS::Serverless::StateMachine, the User should be able to use their own Role under Events -> CWSchedule for Type: Schedule

Currently, by default, a new Role is created under the Logical Resource id StateMachineCWScheduleRole and on expansion, this Role is associated with the dynamically created AWS::Events::Rule Resource.

Sample:

Resources:
  ServerlessStateMachine:
    Type: AWS::Serverless::StateMachine
    Properties:
      Type: STANDARD
      Name: SampleStateMachine
      DefinitionUri:
        Bucket: mybucket
        Key: StateMachineDefinition.json
      Role: arn:aws:iam::XXXXXXXXXXXX:role/StateMachineRole
      Events:
        CWSchedule:
          Type: Schedule
          Properties:
            Schedule: rate(1 minute)
            Name: ScheduleOne
            Description: Uno
            Enabled: false

This behavior is limiting where a Role is required to be re-used or places where there are constraints on Role naming conventions / path.

Proposal

The Resource should have a property for accepting the CloudWatch Schedule Role. If the field is left blank, a default one would be created.

Things to consider:
[1] The SAM documentation - Schedule will need to be updated

[jfuss]

Seems like a good addition. Updating labels.

[sidhujus]

feature added in #3363 and will be rolling out soon