Expand description
The AWS Health API provides programmatic access to the AWS Health information that is presented in the AWS Personal Health Dashboard. You can get information about events that affect your AWS resources:
-
DescribeEvents: Summary information about events.
-
DescribeEventDetails: Detailed information about one or more events.
-
DescribeAffectedEntities: Information about AWS resources that are affected by one or more events.
In addition, these operations provide information about event types and summary counts of events or affected entities:
-
DescribeEventTypes: Information about the kinds of events that AWS Health tracks.
-
DescribeEventAggregates: A count of the number of events that meet specified criteria.
-
DescribeEntityAggregates: A count of the number of affected entities that meet specified criteria.
AWS Health integrates with AWS Organizations to provide a centralized view of AWS Health events across all accounts in your organization.
-
DescribeEventsForOrganization: Summary information about events across the organization.
-
DescribeAffectedAccountsForOrganization: List of accounts in your organization impacted by an event.
-
DescribeEventDetailsForOrganization: Detailed information about events in your organization.
-
DescribeAffectedEntitiesForOrganization: Information about AWS resources in your organization that are affected by events.
You can use the following operations to enable or disable AWS Health from working with AWS Organizations.
-
EnableHealthServiceAccessForOrganization: Enables AWS Health to work with AWS Organizations.
-
DisableHealthServiceAccessForOrganization: Disables AWS Health from working with AWS Organizations.
-
DescribeHealthServiceStatusForOrganization: Status information about enabling or disabling AWS Health from working with 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 authentication of requests, AWS Health uses the Signature Version 4 Signing Process.
See the AWS Health User Guide for information about how to use the API.
Service Endpoint
The HTTP endpoint for the AWS Health API is:
-
https://health.us-east-1.amazonaws.com
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 DescribeAffectedEntities operation.
- Event
Summary information about an AWS Health event.
- 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 cannot 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 cannot 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 cannot 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.