Getting Started with the AWS Health API - AWS Health

Getting Started with the AWS Health API

The AWS Health API provides programmatic access to the AWS Health information that is presented in the Personal Health Dashboard. You can use these API operations to get information about events that affect your AWS resources:

In addition, these operations provide information about event types and summary counts of events or affected entities:

Organizational View

When you enable Organizational View in AWS Health, you can use these API operations to get information about events that affect AWS resources in every account across your organization in AWS Organizations.

The Health API requires a Business or Enterprise support plan from AWS Support. Calling the Health API from an account that does not have a Business or Enterprise support plan causes a SubscriptionRequiredException.

For detailed descriptions of the AWS Health API, see the AWS Health API Reference.

Service Endpoint

The endpoint for the AWS Health API is:

  • https://health.us-east-1.amazonaws.com

The AWS Health service has one endpoint, in the US East (N. Virginia) Region, that provides event data for all regions. You can filter query results to get information about events that affect one or more regions, but the query should always be addressed to the health.us-east-1 endpoint.

Java Code Examples

The following section demonstrates using the AWS Health API with the AWS SDK for Java.