CloudWatchEvent - Amazon Serverless Application Model
SyntaxPropertiesExamples
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

CloudWatchEvent

The object describing a CloudWatchEvent event source type.

Amazon Serverless Application Model (Amazon SAM) generates an AWS::Events::Rule resource when this event type is set.

Important Note: EventBridgeRule is the preferred event source type to use, instead of CloudWatchEvent. EventBridgeRule and CloudWatchEvent use the same underlying service, API, and Amazon CloudFormation resources. However, Amazon SAM will add support for new features only to EventBridgeRule.

Syntax

To declare this entity in your Amazon Serverless Application Model (Amazon SAM) template, use the following syntax.

YAML

  Enabled: Boolean
  EventBusName: String
  Input: String
  InputPath: String
  Pattern: EventPattern
  State: String

Properties

Enabled

Indicates whether the rule is enabled.

To disable the rule, set this property to false.

Note

Specify either the Enabled or State property, but not both.

Type: Boolean

Required: No

Amazon CloudFormation compatibility: This property is similar to the State property of an AWS::Events::Rule resource. If this property is set to true then Amazon SAM passes ENABLED, otherwise it passes DISABLED.

EventBusName

The event bus to associate with this rule. If you omit this property, Amazon SAM uses the default event bus.

Type: String

Required: No

Default: Default event bus

Amazon CloudFormation compatibility: This property is passed directly to the EventBusName property of an AWS::Events::Rule resource.

Input

Valid JSON text passed to the target. If you use this property, nothing from the event text itself is passed to the target.

Type: String

Required: No

Amazon CloudFormation compatibility: This property is passed directly to the Input property of an AWS::Events::Rule Target resource.

InputPath

When you don't want to pass the entire matched event to the target, use the InputPath property to describe which part of the event to pass.

Type: String

Required: No

Amazon CloudFormation compatibility: This property is passed directly to the InputPath property of an AWS::Events::Rule Target resource.

Pattern

Describes which events are routed to the specified target. For more information, see Events and Event Patterns in EventBridge in the Amazon EventBridge User Guide.

Type: EventPattern

Required: Yes

Amazon CloudFormation compatibility: This property is passed directly to the EventPattern property of an AWS::Events::Rule resource.

State

The state of the rule.

Accepted values: DISABLED | ENABLED

Note

Specify either the Enabled or State property, but not both.

Type: String

Required: No

Amazon CloudFormation compatibility: This property is passed directly to the State property of an AWS::Events::Rule resource.

Examples

CloudWatchEvent

The following is an example of a CloudWatchEvent event source type.

YAML

CWEvent:
  Type: CloudWatchEvent
  Properties:
    Enabled: false
    Input: '{"Key": "Value"}'
    Pattern:
      detail:
        state:
          - running