aws_sdk_iot/client/get_thing_connectivity_data.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 [`GetThingConnectivityData`](crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder) operation.
4 ///
5 /// - The fluent builder is configurable:
6 /// - [`thing_name(impl Into<String>)`](crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder::thing_name) / [`set_thing_name(Option<String>)`](crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder::set_thing_name):<br>required: **true**<br><p>The name of your IoT thing.</p><br>
7 /// - [`include_socket_information(bool)`](crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder::include_socket_information) / [`set_include_socket_information(Option<bool>)`](crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder::set_include_socket_information):<br>required: **false**<br><p>Specifies if socket information (sourcePort, targetPort, sourceIp, targetIp, vpcEndpointId) should be included in the GetThingConnectivityData response. Set to <code>true</code> to include socket information. Set to <code>false</code> to omit socket information. By default, this is set to <code>false</code>.</p><br>
8 /// - On success, responds with [`GetThingConnectivityDataOutput`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput) with field(s):
9 /// - [`thing_name(Option<String>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::thing_name): <p>The name of your IoT thing.</p>
10 /// - [`connected(Option<bool>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::connected): <p>A Boolean that indicates the connectivity status.</p>
11 /// - [`timestamp(Option<DateTime>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::timestamp): <p>The timestamp of when the device connected or disconnected.</p>
12 /// - [`disconnect_reason(Option<DisconnectReasonValue>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::disconnect_reason): <p>The reason that the client is disconnected.</p>
13 /// - [`source_ip(Option<String>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::source_ip): <p>The IP address of the client that initiated the connection.</p>
14 /// - [`source_port(Option<i32>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::source_port): <p>The client's source port.</p>
15 /// - [`target_ip(Option<String>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::target_ip): <p>The IP address of the Amazon Web Services IoT Core endpoint that the client connected to.</p>
16 /// - [`target_port(Option<i32>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::target_port): <p>The port number of the Amazon Web Services IoT Core endpoint that the client connected to.</p>
17 /// - [`vpc_endpoint_id(Option<String>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::vpc_endpoint_id): <p>The ID of the VPC endpoint. Present for clients connected to Amazon Web Services IoT Core via a VPC endpoint.</p>
18 /// - [`keep_alive_duration(Option<i32>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::keep_alive_duration): <p>The keep-alive interval in seconds that the client specified when establishing the connection.</p>
19 /// - [`clean_session(Option<bool>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::clean_session): <p>Indicates whether the client is using a clean session. Returns <code>true</code> for clean sessions.</p>
20 /// - [`session_expiry(Option<i64>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::session_expiry): <p>The session expiry interval in seconds for the MQTT client connection. This value indicates how long the session will remain active after the client disconnects.</p>
21 /// - [`client_id(Option<String>)`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataOutput::client_id): <p>The unique identifier of the MQTT client.</p>
22 /// - On failure, responds with [`SdkError<GetThingConnectivityDataError>`](crate::operation::get_thing_connectivity_data::GetThingConnectivityDataError)
23 pub fn get_thing_connectivity_data(&self) -> crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder {
24 crate::operation::get_thing_connectivity_data::builders::GetThingConnectivityDataFluentBuilder::new(self.handle.clone())
25 }
26}