v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1416106112.8 KB

Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns information for health events including the event start and end times, and the status.

Health events that have start times during the time frame that is requested are not included in the list of health events.

get/v20210603/Monitors/{MonitorName}/HealthEvents

Path parameters

MonitorNamestring required

The name of the monitor.

Query parameters

StartTimestring date-time

The time when a health event started.

EndTimestring date-time

The time when a health event ended. If the health event is still ongoing, then the end time is not set.

NextTokenstring

The token for the next set of results. You receive this token from a previous call.

MaxResultsinteger

The number of health event objects that you want to return with this call.

EventStatus'ACTIVE' | 'RESOLVED'

The status of a health event.

LinkedAccountIdstring

The account ID for an account that you've set up cross-account sharing for in Amazon CloudWatch Internet Monitor. You configure cross-account sharing by using Amazon CloudWatch Observability Access Manager. For more information, see <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cwim-cross-account.html">Internet Monitor cross-account observability</a> in the Amazon CloudWatch Internet Monitor User Guide.

Response

Success

NextTokenstring

The token for the next set of results. You receive this token from a previous call.