Integrating AWS Health with other systems using the AWS Health API
AWS Health is a RESTful web service that uses HTTPS as a transport and JSON as a message serialization format. Your application code can make requests directly to the AWS Health API. When you use the REST API directly, you must write the necessary code to sign and authenticate your requests. For more information about the AWS Health operations and parameters, see the AWS Health API Reference.
Note
You must have an AWS Business Support+, AWS Enterprise Support, or AWS Unified Operations plan from AWS SupportSubscriptionRequiredException error.
You can use the AWS SDKs to wrap the AWS Health REST API calls, which can simplify your application development. You specify your AWS credentials, and these libraries take care of authentication and request signing for you.
AWS Health also provides a AWS Health Dashboard in the AWS Management Console that you can use to view and search for events and affected entities. See Getting started with your AWS Health Dashboard.
Topics
Signing AWS Health API requests
When you use the AWS SDKs or the AWS Command Line Interface (AWS CLI) to make requests to AWS, these tools automatically sign the requests for you with the access key that you specify when you configure the tools. For example, if you use the AWS SDK for Java for the previous high availability endpoint demo, you don't need to sign requests yourself.
Java code examples
For more examples on how to use the AWS Health API with the AWS SDK for Java, see this example code.
When you make requests, we strongly recommend that you don't use your AWS root account credentials for regular access to AWS Health. You can use the credentials for an IAM user. For more information, see Lock Away Your AWS Account Root User Access Keys in the IAM User Guide.
If you don’t use the AWS SDKs or the AWS CLI, then you must sign your requests yourself. We recommend that you use AWS Signature Version 4. For more information, see Signing AWS API Requests in the AWS General Reference.
Choosing endpoints for AWS Health API requests
The AWS Health API has a single regional endpoint. Use the endpoint shown in the following table for all AWS Health API requests.
The following table represents the default configuration.
| Description | Signing Region | Endpoint | Protocol |
|---|---|---|---|
| Active |
eusc-de-east-1 |
health.eusc-de-east-1.api.amazonwebservices.eu (IPv4 and IPv6 supported) |
HTTPS |
Tip
Both the active and passive endpoints return AWS Health data. However, the latest AWS Health data is only available from the active endpoint. Data from the passive endpoint will be eventually consistent with the active endpoint. We recommend that you restart any workflows when the active endpoint changes.