AWS cli documentation change

Service: cli · 2026-05-31 · Documentation medium

File: cli/latest/reference/iot/get-thing-connectivity-data.md

Summary

Added socket information options and new response fields for IoT connectivity data

Security assessment

Added --include-socket-information flag and new network security fields (sourceIp, sourcePort, targetIp, targetPort, vpcEndpointId) that enhance security visibility. This provides network-level security information for IoT connections but doesn't address a specific vulnerability.

Diff

diff --git a/cli/latest/reference/iot/get-thing-connectivity-data.md b/cli/latest/reference/iot/get-thing-connectivity-data.md
index 21a6d7c2c..14188ae4a 100644
--- a//cli/latest/reference/iot/get-thing-connectivity-data.md
+++ b//cli/latest/reference/iot/get-thing-connectivity-data.md
@@ -15 +15 @@
-  * [AWS CLI 2.34.55 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.57 Command Reference](../../index.html) »
@@ -67,0 +68 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-20
+    [--include-socket-information | --no-include-socket-information]
@@ -104,0 +106,4 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/iot-20
+`--include-socket-information` | `--no-include-socket-information` (boolean)
+
+> Specifies if socket information (sourcePort, targetPort, sourceIp, targetIp, vpcEndpointId) should be included in the GetThingConnectivityData response. Set to `true` to include socket information. Set to `false` to omit socket information. By default, this is set to `false` .
+
@@ -236 +241 @@ timestamp -> (timestamp)
-> The timestamp of when the event occurred.
+> The timestamp of when the event occurred. When you enable or update the indexing configuration, this value might be the Unix epoch time (0) for devices that have never connected or have been disconnected for more than an hour.
@@ -240 +245 @@ disconnectReason -> (string)
-> The reason why the client is disconnecting.
+> The reason why the client is disconnecting. When you enable or update the indexing configuration, this value might be `UNKNOWN` for devices that have never connected or have been disconnected for more than an hour.
@@ -252,0 +258 @@ disconnectReason -> (string)
+>   * `API_INITIATED_DISCONNECT`
@@ -260,0 +267,36 @@ disconnectReason -> (string)
+sourceIp -> (string)
+
+> The IP address of the client that initiated the connection.
+
+sourcePort -> (integer)
+
+> The client’s source port.
+
+targetIp -> (string)
+
+> The IP address of the Amazon Web Services IoT Core endpoint that the client connected to.
+
+targetPort -> (integer)
+
+> The port number of the Amazon Web Services IoT Core endpoint that the client connected to.
+
+vpcEndpointId -> (string)
+
+> The ID of the VPC endpoint. Present for clients connected to Amazon Web Services IoT Core via a VPC endpoint.
+
+keepAliveDuration -> (integer)
+
+> The keep-alive interval in seconds that the client specified when establishing the connection.
+
+cleanSession -> (boolean)
+
+> Indicates whether the client is using a clean session. Returns `true` for clean sessions.
+
+sessionExpiry -> (long)
+
+> 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.
+
+clientId -> (string)
+
+> The unique identifier of the MQTT client.
+
@@ -271 +313 @@ disconnectReason -> (string)
-  * [AWS CLI 2.34.55 Command Reference](../../index.html) »
+  * [AWS CLI 2.34.57 Command Reference](../../index.html) »