Configuring an EventBridge rule to send notifications about events in Amazon Health

You can create an Amazon EventBridge rule to programmatically integrate Amazon Health events with other services, applications, and workloads. EventBridge provides a drag and drop console interface and an API to set up rules that trigger when a matching Amazon Health event is created for your account or organization. To learn how to set up a rule in EventBridge to capture Amazon Health events, see Creating rules in Amazon EventBridge and Creating rules that react to events in Amazon EventBridge in the Amazon EventBridge User Guide.

Depending on your integration, EventBridge allows you to add parameters to the EventBridge rule to filter only the Amazon Health events that you want to integrate with your use case. For incident response use cases, you might want to focus on the issue event category and certain critical services. For change management use cases such as planned lifecycle events, you might want to focus on Amazon Health events with ACTION_REQUIRED in the Actionability field. For integrating with security use cases, you might want to focus on all Amazon Health Abuse events and Amazon Health events with the SECURITY persona field.

You can use sample use cases to verify that your rule captures the events you need. Sample use cases are available in Reference: Amazon Health events Amazon EventBridge schema. You can also find them in the EventBridge console under the Use Sample events provided option in the Test event pattern - optional panel

Using the API or Amazon Command Line Interface

For a new or existing rule, use the PutRule API operation or the aws events put-rule command to update the event pattern. To view an example Amazon CLI command, see put-rule in the Amazon CLI Command Reference.

{
  "detail": {
    "eventTypeCategory": [
      "issue"
    ],
    "service": [
      "EC2"
    ]
  },
  "detail-type": [
    "AWS Health Event"
  ],
  "source": [
    "aws.health"
  ]
}

{
  "detail": {
    "eventTypeCategory": [
      "accountNotification",
      "scheduledChange"
    ],
    "actionability": [
      "ACTION_REQUIRED"
    ]
  },
  "detail-type": [
    "AWS Health Event"
  ],
  "source": [
    "aws.health"
  ]
}

{
  "detail": {
    "eventTypeCategory": [
      "issue",
      "accountNotification",
      "scheduledChange"
    ],
    "service": [
      "AUTOSCALING",
      "VPC",
      "EC2"
    ]
  },
  "detail-type": [
    "AWS Health Event"
  ],
  "source": [
    "aws.health"
  ]
}