Reference: Amazon Health events Amazon EventBridge schema - Amazon Health
Amazon Health event schema Public Health Event - Amazon EC2 operational issue Account-specific Amazon Health Event - Elastic Load Balancing API Issue Account-specific Amazon Health Event - Amazon EC2 Instance Store Drive Performance Degraded
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).

Reference: Amazon Health events Amazon EventBridge schema

The following is the schema for Amazon Health events. The contents of the details parameter follows in a second table. Sample payloads ares provided after the schema tables.

Amazon Health event schema

Amazon Health event schema
Parameter Description Required
version EventBridge version, currently "0". Yes
id The unique identifier for the EventBridge event. Yes
detail-type The type of detail. For Amazon Health events, supported values are &Amazon Health Event and Amazon Health Abuse Event Yes
source

The event bus source. For Amazon Health events, the supported value is aws.health

 Yes
account The account ID to which the Amazon Health event was sent .
Note

For organizational views this is a different account than the affected account if it's received in the management account or delegated administrator account.

 Yes
time The time at which the notification was sent to EventBridge. Format: yyyy-mm-ddThh:mm:ssZ. Yes
region The Amazon Web Services Region that the notification was delivered to.
Note

This field doesn't indicate the impacted Region for this Amazon Health event. That information is reported in detail.eventRegion.

 Yes
resources

Describes the list of affected resources, if any, within an account.

This field is empty if there are no resources referenced.

 No
detail

The section containing details of the Amazon Health event, as described in the table immediately following this one.

 Yes

Schema content of the 'details' parameter

The following table documents the content of the detail parameter in the Amazon Health event schema.

Amazon Health event schema: detail parameter content
'detail' parameter content Description Required
eventArn The unique identifier for the Amazon Health event for the specific Region, including the Region and event ID.
Note

An event ARN isn't unique to a specific Amazon Web Services account or Region.

 Yes
service The Amazon Web Services service affected by the Amazon Health event. For example, Amazon EC2, Amazon Simple Storage Service, Amazon Redshift, or Amazon Relational Database Service. Yes
eventTypeCode The unique identifier for the event type. For example: AWS_EC2_INSTANCE_NETWORK_MAINTENANCE_SCHEDULED and AWS_EC2_INSTANCE_REBOOT_MAINTENANCE_SCHEDULED. Events that include MAINTENANCE_SCHEDULED are generally pushed out approximately two weeks before the start time.
Note

All new planned lifecycle events have the event type AWS_{SERVICE}_PLANNED_LIFECYCLE_EVENT.

 Yes
eventTypeCategory The category code of the event. The supported values include issue, accountNotification, investigation, and scheduledChange. Yes
eventScopeCode Indicates whether the Amazon Health event is account-specific or public. Supported values are ACCOUNT_SPECIFIC or PUBLIC. Yes
communicationId

A unique identifier for this communication for the Amazon Health event.

Messages with the same communication ID might be backup messages or pages of a single Amazon Health event. This identifier can be used with the account ID to help de-duplicate messages.

With the Amazon Health event pagination support, the communication ID includes the page number to keep the communication ID unique across pages, for example, 12345678910-1. For more information, see Viewing paginated lists of Amazon Health events on EventBridge.

 Yes
startTime The start time of the Amazon Health event, in the format DoW, DD, MMM, YYYY, HH:MM:SS TZ.

The start time can be in the future for scheduled events.

 Yes
endTime The end time of the Amazon Health event, in the format:DoW, DD MMM YYYY HH:MM:SS TZ.

The end time can't be provided for events scheduled for a future time.

 No
lastUpdatedTime The last update time for the Amazon Health event, in the format DoW, DD MMM YYYY HH:MM:SS TZ. Yes
statusCode

The status of the Amazon Health event.

Supported values include open, closed, and upcoming.

 Yes
eventRegion The impacted Region described by this Amazon Health event. Yes
eventDescription

A section that describes the Amazon Health event. This includes fields for language and text to describe the event.

  • language – The code for the language used in the Amazon Health event. This is typically determined by the Region that the event is published to. For example, in the us-east-1 Region, this is typically en_US.

  • latestDescription – Describes the Amazon Health event as it is rendered from the Amazon Health API and typically appears on the the Amazon Health dashboard.

    Note

    For public events, this contains only the latest update and not the entire history of the event.

 Yes
eventMetadata

Additional event metadata that can be provided for the Amazon Health event.

  • <metadata key 1> – Metadata key-value pair strings: "keystring1": "keyvalue1"

    The key-value pairs for event metadata are determined by the service that sent the Amazon Health event.

 No
affectedEntities

An array that describes the resource value and status of affected resources within the Amazon Health event.

  • entityValue – The resource/entity ID.

  • lastUpdatedtime – The time when this resource/entity status was last updated, in the format DoW, DD MMM YYYY HH:MM:SS TZ.

  • status – The status of the affected resource/entity. Supported values include IMPAIRED, UNIMPAIRED, PENDING, RESOLVED, and UNKNOWN.

 No
page

The page this message represents. For more information, see Viewing paginated lists of Amazon Health events on EventBridge.

Note

Pagination occurs only on resources. If the 256KB size limit is exceeded for another reason, the communication to fail.

 Yes
totalPages

The total number of pages for this health event. For more information, see Viewing paginated lists of Amazon Health events on EventBridge.

You can use this value to determine whether you received all of the pages of a multi-page communication for an account.

 Yes
affectedAccount

The account ID of the impacted account.

This may be different from the value in the account field if this health event is sent to an account that is part of an Amazon Organizations and is received in the management account or delegated administrator account.

 Yes

Public Health Event - Amazon EC2 operational issue 

{
    "version": "0",
    "id": "7bf73129-1428-4cd3-a780-95db273d1602",
    "detail-type": "AWS Health Event",
    "source": "aws.health",
    "account": "123456789012",
    "time": "2023-01-27T09:01:22Z",
    "region": "af-south-1",
    "resources": [],
    "detail": {
        "eventArn": "arn:aws:health:af-south-1::event/EC2/AWS_EC2_OPERATIONAL_ISSUE/AWS_EC2_OPERATIONAL_ISSUE_7f35c8ae-af1f-54e6-a526-d0179ed6d68f",
        "service": "EC2",
        "eventTypeCode": "AWS_EC2_OPERATIONAL_ISSUE",
        "eventTypeCategory": "issue",
        "eventScopeCode": "PUBLIC",
        "communicationId": "01b0993207d81a09dcd552ebd1e633e36cf1f09a-1",
        "startTime": "Fri, 27 Jan 2023 06:02:51 GMT",
        "endTime": "Fri, 27 Jan 2023 09:01:22 GMT",
        "lastUpdatedTime": "Fri, 27 Jan 2023 09:01:22 GMT",
        "statusCode": "open",
        "eventRegion": "af-south-1",
        "eventDescription": [{
            "language": "en_US",
            "latestDescription": "Current severity level: Operating normally\n\n[RESOLVED] \n\n [03:15 PM PST] We continue see recovery \n\nThe following AWS services were previously impacted but are now operating normally: APPSYNC, BACKUP, EVENTS."
        }],
        "affectedEntities": [],
        "page": "1",
        "totalPages": "1",
        "affectedAccount": "123456789012"
    }
}

Account-specific Amazon Health Event - Elastic Load Balancing API Issue 

{
    "version": "0",
    "id": "121345678-1234-1234-1234-123456789012",
    "detail-type": "AWS Health Event",
    "source": "aws.health",
    "account": "123456789012",
    "time": "2022-06-10T06:27:57Z",
    "region": "ap-southeast-2",
    "resources": [],
    "detail": {
        "eventArn": "arn:aws:health:ap-southeast-2::event/AWS_ELASTICLOADBALANCING_API_ISSUE_90353408594353980",
        "service": "ELASTICLOADBALANCING",
        "eventTypeCode": "AWS_ELASTICLOADBALANCING_API_ISSUE",
        "eventTypeCategory": "issue",
        "eventScopeCode": "ACCOUNT_SPECIFIC",
        "communicationId": "01b0993207d81a09dcd552ebd1e633e36cf1f09a-1",
        "startTime": "Fri, 10 Jun 2022 05:01:10 GMT",
        "endTime": "Fri, 10 Jun 2022 05:30:57 GMT",
        "statusCode": "open",
        "eventRegion": "ap-southeast-2",
        "eventDescription": [{
            "language": "en_US",
            "latestDescription": "A description of the event will be provided here"
        }],
        "page": "1",
        "totalPages": "1",
        "affectedAccount": "123456789012"
    }
}

Account-specific Amazon Health Event - Amazon EC2 Instance Store Drive Performance Degraded 

{
    "version": "0",
    "id": "121345678-1234-1234-1234-123456789012",
    "detail-type": "AWS Health Event",
    "source": "aws.health",
    "account": "123456789012",
    "time": "2022-06-03T06:27:57Z",
    "region": "us-west-2",
    "resources": [
        "i-abcd1111"
    ],
    "detail": {
        "eventArn": "arn:aws:health:us-west-2::event/AWS_EC2_INSTANCE_STORE_DRIVE_PERFORMANCE_DEGRADED_90353408594353980",
        "service": "EC2",
        "eventTypeCode": "AWS_EC2_INSTANCE_STORE_DRIVE_PERFORMANCE_DEGRADED",
        "eventTypeCategory": "issue",
        "eventScopeCode": "ACCOUNT_SPECIFIC",
        "communicationId": "01b0993207d81a09dcd552ebd1e633e36cf1f09a-1",
        "startTime": "Fri, 3 Jun 2022 05:01:10 GMT",
        "endTime": "Fri, 3 Jun 2022 05:30:57 GMT",
        "statusCode": "open",
        "eventRegion": "us-west-2",
        "eventDescription": [{
            "language": "en_US",
            "latestDescription": "A description of the event will be provided here"
        }],
        "affectedEntities": [{
            "entityValue": "i-abcd1111"
        }],
        "page": "1",
        "totalPages": "1",
        "affectedAccount": "123456789012"
    }
}