aws-events

List all rules in the default event bus

$ aws events list-rules

$ aws events describe-rule --name [rule_name]

$ aws events list-targets-by-rule --rule [rule_name]

$ aws events put-rule --name [rule_name] --schedule-expression "rate(1 hour)"

$ aws events put-rule --name [rule_name] --event-pattern '{"source":["aws.ec2"],"detail-type":["EC2 Instance State-change Notification"]}'

$ aws events put-targets --rule [rule_name] --targets Id=1,Arn=[arn:aws:lambda:region:account:function:name]

$ aws events disable-rule --name [rule_name]

$ aws events delete-rule --name [rule_name]

aws events subcommand [options]

aws events is a subcommand of the AWS CLI that manages Amazon EventBridge (formerly CloudWatch Events), a serverless event bus service. It routes events between AWS services, SaaS applications, and your own applications.
Rules match incoming events based on patterns and route them to targets like Lambda functions, Step Functions, SNS topics, SQS queues, and more. Rules can also trigger on schedules using cron or rate expressions.
Event buses act as routers: the default bus receives AWS service events, while custom buses can receive events from your applications. Partner event sources connect to SaaS providers.

list-rules

List rules on an event bus.

Get details about a specific rule.

Create or update a rule.

Remove a rule.

Activate a disabled rule.

Deactivate a rule without deleting it.

List targets attached to a rule.

Add targets to a rule.

Remove targets from a rule.

List event buses in the account.

Send custom events to an event bus.

Name of the rule.

Cron or rate expression for scheduled rules.

JSON pattern to match events.

Target specifications (Id, Arn, Input, etc.).

Event bus name (default if not specified).

Must remove all targets before deleting a rule. Schedule expressions use UTC timezone. Event patterns match on exact values by default; use prefix or anything-but for flexibility. Maximum 5 targets per rule (can be increased via quota request). Rules can take up to one minute to become active.

CloudWatch Events launched in January 2016 as AWS's first event-driven integration service. It was rebranded as Amazon EventBridge at AWS re:Invent 2019 with expanded capabilities including custom event buses and third-party SaaS integrations. Schema registry and discovery were added to help developers understand event structures. The service continues to be central to serverless and event-driven architectures on AWS.

aws(1), aws-lambda(1), aws-sns(1), aws-sqs(1)