Expand description
The AWS Health API provides programmatic access to the AWS Health information that appears in the AWS Personal Health Dashboard. You can use the API operations to get information about AWS Health events that affect your AWS services and resources.
-
You must have a Business or Enterprise Support plan from AWS Support to use the AWS Health API. If you call the AWS Health API from an AWS account that doesn't have a Business or Enterprise Support plan, you receive a
SubscriptionRequiredException
error. -
You can use the AWS Health endpoint health.us-east-1.amazonaws.com (HTTPS) to call the AWS Health API operations. AWS Health supports a multi-Region application architecture and has two regional endpoints in an active-passive configuration. You can use the high availability endpoint example to determine which AWS Region is active, so that you can get the latest information from the API. For more information, see Accessing the AWS Health API in the AWS Health User Guide.
For authentication of requests, AWS Health uses the Signature Version 4 Signing Process.
If your AWS account is part of AWS Organizations, you can use the AWS Health organizational view feature. This feature provides a centralized view of AWS Health events across all accounts in your organization. You can aggregate AWS Health events in real time to identify accounts in your organization that are affected by an operational event or get notified of security vulnerabilities. Use the organizational view API operations to enable this feature and return event information. For more information, see Aggregating AWS Health events in the AWS Health User Guide.
When you use the AWS Health API operations to return AWS Health events, see the following recommendations:
-
Use the eventScopeCode parameter to specify whether to return AWS Health events that are public or account-specific.
-
Use pagination to view all events from the response. For example, if you call the
DescribeEventsForOrganization
operation to get all events in your organization, you might receive several page results. Specify thenextToken
in the next request to return more results.
If you’re using the service, you’re probably looking for AWSHealthClient and AWSHealth.
Structs§
- AWSHealth
Client - A client for the AWSHealth API.
- Affected
Entity Information about an entity that is affected by a Health event.
- Date
Time Range A range of dates and times that is used by the EventFilter and EntityFilter objects. If
from
is set andto
is set: match items where the timestamp (startTime
,endTime
, orlastUpdatedTime
) is betweenfrom
andto
inclusive. Iffrom
is set andto
is not set: match items where the timestamp value is equal to or afterfrom
. Iffrom
is not set andto
is set: match items where the timestamp value is equal to or beforeto
.- Describe
Affected Accounts ForOrganization Request - Describe
Affected Accounts ForOrganization Response - Describe
Affected Entities ForOrganization Request - Describe
Affected Entities ForOrganization Response - Describe
Affected Entities Request - Describe
Affected Entities Response - Describe
Entity Aggregates Request - Describe
Entity Aggregates Response - Describe
Event Aggregates Request - Describe
Event Aggregates Response - Describe
Event Details ForOrganization Request - Describe
Event Details ForOrganization Response - Describe
Event Details Request - Describe
Event Details Response - Describe
Event Types Request - Describe
Event Types Response - Describe
Events ForOrganization Request - Describe
Events ForOrganization Response - Describe
Events Request - Describe
Events Response - Describe
Health Service Status ForOrganization Response - Entity
Aggregate The number of entities that are affected by one or more events. Returned by the DescribeEntityAggregates operation.
- Entity
Filter The values to use to filter results from the EntityFilter operation.
- Event
Summary information about an AWS Health event.
AWS Health events can be public or account-specific:
-
Public events might be service events that are not specific to an AWS account. For example, if there is an issue with an AWS Region, AWS Health provides information about the event, even if you don't use services or resources in that Region.
-
Account-specific events are specific to either your AWS account or an account in your organization. For example, if there's an issue with Amazon Elastic Compute Cloud in a Region that you use, AWS Health provides information about the event and the affected resources in the account.
You can determine if an event is public or account-specific by using the
eventScopeCode
parameter. For more information, see eventScopeCode.-
- Event
Account Filter The values used to filter results from the DescribeEventDetailsForOrganization and DescribeAffectedEntitiesForOrganization operations.
- Event
Aggregate The number of events of each issue type. Returned by the DescribeEventAggregates operation.
- Event
Details Detailed information about an event. A combination of an Event object, an EventDescription object, and additional metadata about the event. Returned by the DescribeEventDetails operation.
- Event
Details Error Item Error information returned when a DescribeEventDetails operation can't find a specified event.
- Event
Filter The values to use to filter results from the DescribeEvents and DescribeEventAggregates operations.
- Event
Type Filter The values to use to filter results from the DescribeEventTypes operation.
- Organization
Affected Entities Error Item Error information returned when a DescribeAffectedEntitiesForOrganization operation can't find or process a specific entity.
- Organization
Event Summary information about an event, returned by the DescribeEventsForOrganization operation.
- Organization
Event Details Detailed information about an event. A combination of an Event object, an EventDescription object, and additional metadata about the event. Returned by the DescribeEventDetailsForOrganization operation.
- Organization
Event Details Error Item Error information returned when a DescribeEventDetailsForOrganization operation can't find a specified event.
- Organization
Event Filter The values to filter results from the DescribeEventsForOrganization operation.
Enums§
- Describe
Affected Accounts ForOrganization Error - Errors returned by DescribeAffectedAccountsForOrganization
- Describe
Affected Entities Error - Errors returned by DescribeAffectedEntities
- Describe
Affected Entities ForOrganization Error - Errors returned by DescribeAffectedEntitiesForOrganization
- Describe
Entity Aggregates Error - Errors returned by DescribeEntityAggregates
- Describe
Event Aggregates Error - Errors returned by DescribeEventAggregates
- Describe
Event Details Error - Errors returned by DescribeEventDetails
- Describe
Event Details ForOrganization Error - Errors returned by DescribeEventDetailsForOrganization
- Describe
Event Types Error - Errors returned by DescribeEventTypes
- Describe
Events Error - Errors returned by DescribeEvents
- Describe
Events ForOrganization Error - Errors returned by DescribeEventsForOrganization
- Describe
Health Service Status ForOrganization Error - Errors returned by DescribeHealthServiceStatusForOrganization
- Disable
Health Service Access ForOrganization Error - Errors returned by DisableHealthServiceAccessForOrganization
- Enable
Health Service Access ForOrganization Error - Errors returned by EnableHealthServiceAccessForOrganization
Traits§
- AWSHealth
- Trait representing the capabilities of the AWSHealth API. AWSHealth clients implement this trait.