Reference: Amazon EventBridge event patterns and types for Systems Manager - AWS Systems Manager

Reference: Amazon EventBridge event patterns and types for Systems Manager

Note

Amazon EventBridge is the preferred way to manage your events. CloudWatch Events and EventBridge are the same underlying service and API, but EventBridge provides more features. Changes you make in either CloudWatch or EventBridge are reflected in each console. For more information, see the Amazon EventBridge User Guide.

Using Amazon EventBridge, you can create rules that match incoming events and route them to targets for processing.

An event indicates a change in an environment in your own applications, software as a service (SaaS) applications, or an AWS service. Events are produced on a best effort basis. After an event type that is specified in a rule is detected, EventBridge routes it to a specified target for processing. Targets can include Amazon Elastic Compute Cloud (Amazon EC2) instances, AWS Lambda functions, Amazon Kinesis streams, Amazon Elastic Container Service (Amazon ECS) tasks, AWS Step Functions state machines, Amazon Simple Notification Service (Amazon SNS) topics, Amazon Simple Queue Service (Amazon SQS) queues, built-in targets and many more.

For information about creating EventBridge rules, see the following topics:

The remainder of this topic describes the types of Systems Manager events that you can include in your EventBridge rules.

Event type: Automation

Event type name Description of events you can add to a rule
EC2 Automation Execution Status-change Notification The overall status of an Automation workflow changes. You can add one or more of the following status changes to an event rule:
  • Approved

  • Canceled

  • Failed

  • PendingApproval

  • PendingChangeCalendarOverride

  • Rejected

  • Scheduled

  • Success

  • TimedOut

EC2 Automation Step Status-change Notification The status of a specific step in an Automation workflow changes. You can add one or more of the following status changes to an event rule:
  • Canceled

  • Failed

  • Success

  • TimedOut

Event type: Change Calendar

Event type name Description of events you can add to a rule
Calendar State Change The state of a Change Calendar changes. You can add one or both of the following state changes to an event rule:
  • OPEN

  • CLOSED

State changes for calendars shared from other AWS accounts aren't supported.

Event type: Change Manager

Event type name Description of events you can add to a rule
Change Request Status Update The state of a Change Manager change request. You can use the following states in an event rule:
  • Approved

  • Rejected

  • InProgress

Event type: Configuration Compliance

Event type name Description of events you can add to a rule
Configuration Compliance State Change The state of a managed node changes, for either association compliance or patch compliance. You can add one or more of the following state changes to an event rule:
  • compliant

  • non_compliant

Event type: Inventory

Event type name Description of events you can add to a rule
Inventory Resource State Change The deletion of custom inventory and a PutInventory call that uses an old schema version. You can add one or more of the following state changes to an event rule:
  • Custom inventory type deleted event on a specific node. EventBridge sends one event per node per custom InventoryType.

  • Custom inventory type deleted event for all nodes.

  • PutInventory call with old schema version event. EventBridge sends this event when the schema version is less than the current schema. This event applies to all inventory types.

For more information, see Using EventBridge to monitor Inventory events.

Event type: Maintenance Window

Event type name Description of events you can add to a rule
Maintenance Window Status-change Notification The overall status of one or more maintenance windows changes. You can add one or more of the following state changes to an event rule:
  • DISABLED

  • ENABLED

Maintenance Window Target Registration Notification The status of one or more maintenance window targets changes. You can add one or more of the following state changes to an event rule:
  • DEREGISTERED

  • REGISTERED

  • UPDATED

Maintenance Window Execution State-change Notification The overall status of a maintenance window changes while it's running. You can add one or more of the following state changes to an event rule:
  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • PENDING

  • SKIPPED_OVERLAPPING

  • SUCCESS

  • TIMED_OUT

Maintenance Window Task Execution State-change Notification The state of a task in a maintenance window changes while it's running. You can add one or more of the following state changes to an event rule:
  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • SUCCESS

  • TIMED_OUT

Maintenance Window Task Target Invocation State-change Notification

The state of a maintenance window task on a specific target changes.

This notification is fully supported only for Run Command tasks. For this type of task, you can add one or more of the following state changes to an event rule:

  • CANCELLED

  • CANCELLING

  • FAILED

  • IN_PROGRESS

  • SUCCESS

  • TIMED_OUT

For Automation, AWS Lambda, and AWS Step Functions tasks, EventBridge reports only the states IN_PROGRESS and COMPLETE. COMPLETE is reported whether the task is successful or not.

Maintenance Window Task Registration Notification The state of one or more maintenance window tasks changes. You can add one or more of the following state changes to an event rule:
  • DEREGISTERED

  • REGISTERED

  • UPDATED

Event type: OpsCenter

Event type name Description of events you can add to a rule
OpsItem Create Occurs when an OpsItem is created. You can add rules for one of the following OpsItem types:
  • /aws/issue

  • /aws/task

  • /aws/insight

  • /aws/actionitem

OpsItem Update Occurs when an OpsItem is updated. You can add rules for one of the following OpsItem types:
  • /aws/issue

  • /aws/task

  • /aws/insight

  • /aws/actionitem

Event type: Parameter Store

Event type name Description of events you can add to a rule
Parameter Store Change The state of a parameter changes. You can add one or more of the following state changes to an event rule:
  • Create

  • Update

  • Delete

  • LabelParameterVersion

For more information, see Configuring EventBridge rules for parameters and parameter policies.

Parameter Store Policy Action A condition of an advanced parameter policy change is met. You can add one or more of the following status changes to an event rule:
  • Expiration

  • ExpirationNotification

  • NoChangeNotification

For more information, see Configuring EventBridge rules for parameters and parameter policies.

Event type: Run Command

Event type name Description of events you can add to a rule
EC2 Command Invocation Status-change Notification The status of a command sent to an individual managed instance changes. You can add one or more of the following status changes to an event rule:
  • Success

  • InProgress

  • TimedOut

  • Canceled

  • Failed

EC2 Command Status-change Notification The overall status of a command changes. You can add one or more of the following status changes to an event rule:
  • Success

  • InProgress

  • TimedOut

  • Canceled

  • Failed

Event type: State Manager

Event type name Description of events you can add to a rule
EC2 State Manager Association State Change The overall state of an Association changes as it's being applied. You can add one or more of the following state changes to an event rule:
  • Failed

  • Pending

  • Success

EC2 State Manager Instance Association State Change The state of a single managed instance that is targeted by an Association changes. You can add one or more of the following state changes to an event rule:
  • Failed

  • Pending

  • Success