SAM模板中使用!If内置函数配置状态机调度的验证失败问题

问题原因 #

SAM对AWS::Serverless::StateMachine的Events.Schedule.Properties.Enabled字段的动态值支持存在验证限制，直接使用!If或!Ref会因类型或结构校验失败。

解决方案1：改用独立的CloudWatch Events Rule #

放弃SAM的Events快捷配置，单独定义事件规则并关联状态机，这种方式支持灵活的动态启用控制：

1. 定义状态机（不含Events配置） #

SM:
  Type: AWS::Serverless::StateMachine
  Properties:
    Name: !Sub "${StageName}-State-Machine"
    DefinitionUri: statemachine/dddd.asl.json

2. 定义CloudWatch Events调度规则 #

StateMachineScheduleRule:
  Type: AWS::Events::Rule
  Properties:
    Description: Schedule to run the twilio number state machine
    ScheduleExpression: "rate(1 hour)"
    # 动态设置规则状态：主区域且ScheduleEnabled为true时启用，否则禁用
    State: !If
      - IsPrimaryRegion
      - !If [ScheduleEnabled, "ENABLED", "DISABLED"]
      - "DISABLED"
    Targets:
      - Arn: !Ref SM
        Id: "StateMachineTarget"

3. 给事件规则添加触发状态机的权限 #

StateMachineScheduleRulePermission:
  Type: AWS::Lambda::Permission
  Properties:
    FunctionName: !GetAtt SM.Arn
    Action: "states:StartExecution"
    Principal: "events.amazonaws.com"
    SourceArn: !GetAtt StateMachineScheduleRule.Arn

4. 配套的参数与条件定义 #

确保参数和条件正确配置：

Parameters:
  StageName:
    Type: String
  IsPrimaryRegion:
    Type: String
    AllowedValues: ["true", "false"]
  ScheduleEnabled:
    Type: Boolean
    Default: true

Conditions:
  IsPrimaryRegion: !Equals [!Ref IsPrimaryRegion, "true"]

解决方案2：修正SAM Events的写法（仅适用于部分场景） #

如果坚持使用SAM的Events字段，需确保Enabled的动态值为严格布尔类型，且参数定义正确：

SM:
  Type: AWS::Serverless::StateMachine
  Properties:
    Name: !Sub "${StageName}-State-Machine"
    DefinitionUri: statemachine/dddd.asl.json
    Events:
      Schedule:
        Type: Schedule
        Properties:
          Description: Schedule to run the twilio number state machine
          # 通过逻辑组合返回布尔值
          Enabled: !And
            - !Condition IsPrimaryRegion
            - !Ref ScheduleEnabled
          Schedule: "rate(1 hour)"

注意：此写法在部分SAM版本中可能仍存在验证问题，优先推荐解决方案1。

内容的提问来源于stack exchange，提问作者elena