aws_sdk_internetmonitor/client/
list_health_events.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2impl super::Client {
3    /// Constructs a fluent builder for the [`ListHealthEvents`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder) operation.
4    /// This operation supports pagination; See [`into_paginator()`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::into_paginator).
5    ///
6    /// - The fluent builder is configurable:
7    ///   - [`monitor_name(impl Into<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::monitor_name) / [`set_monitor_name(Option<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_monitor_name):<br>required: **true**<br><p>The name of the monitor.</p><br>
8    ///   - [`start_time(DateTime)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::start_time) / [`set_start_time(Option<DateTime>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_start_time):<br>required: **false**<br><p>The time when a health event started.</p><br>
9    ///   - [`end_time(DateTime)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::end_time) / [`set_end_time(Option<DateTime>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_end_time):<br>required: **false**<br><p>The time when a health event ended. If the health event is still ongoing, then the end time is not set.</p><br>
10    ///   - [`next_token(impl Into<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::next_token) / [`set_next_token(Option<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_next_token):<br>required: **false**<br><p>The token for the next set of results. You receive this token from a previous call.</p><br>
11    ///   - [`max_results(i32)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::max_results) / [`set_max_results(Option<i32>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_max_results):<br>required: **false**<br><p>The number of health event objects that you want to return with this call.</p><br>
12    ///   - [`event_status(HealthEventStatus)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::event_status) / [`set_event_status(Option<HealthEventStatus>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_event_status):<br>required: **false**<br><p>The status of a health event.</p><br>
13    ///   - [`linked_account_id(impl Into<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::linked_account_id) / [`set_linked_account_id(Option<String>)`](crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::set_linked_account_id):<br>required: **false**<br><p>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.</p><br>
14    /// - On success, responds with [`ListHealthEventsOutput`](crate::operation::list_health_events::ListHealthEventsOutput) with field(s):
15    ///   - [`health_events(Vec::<HealthEvent>)`](crate::operation::list_health_events::ListHealthEventsOutput::health_events): <p>A list of health events.</p>
16    ///   - [`next_token(Option<String>)`](crate::operation::list_health_events::ListHealthEventsOutput::next_token): <p>The token for the next set of results. You receive this token from a previous call.</p>
17    /// - On failure, responds with [`SdkError<ListHealthEventsError>`](crate::operation::list_health_events::ListHealthEventsError)
18    pub fn list_health_events(&self) -> crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder {
19        crate::operation::list_health_events::builders::ListHealthEventsFluentBuilder::new(self.handle.clone())
20    }
21}