GetConnectionResponse ¶

class GetConnectionResponse(TypedDict, closed=True):
    connected: "capo_iot_data_plane.types.connected.Connected"
    """<p>The connection state of the client. Returns <code>true</code> if the client is currently connected, or <code>false</code> if the client is not connected.</p>"""
    thing_name: NotRequired["capo_iot_data_plane.types.thing_name.ThingName"]
    """<p>The name of the thing associated with the principal of the MQTT client, if applicable.</p>"""
    clean_session: "capo_iot_data_plane.types.clean_session.CleanSession"
    """<p>Indicates whether the client is using a clean session. Returns <code>true</code> for clean sessions or <code>false</code> for persistent sessions.</p>"""
    source_ip: NotRequired["capo_iot_data_plane.types.source_ip.SourceIp"]
    """<p>The IP address of the client that initiated the connection.</p>"""
    source_port: "capo_iot_data_plane.types.source_port.SourcePort"
    """<p>The client's source port.</p>"""
    target_ip: NotRequired["capo_iot_data_plane.types.target_ip.TargetIp"]
    """<p>The IP address of the Amazon Web Services IoT Core endpoint that the client connected to. For clients connected to VPC endpoints, this is the private IP address of the network interface the client is connected to.</p>"""
    target_port: "capo_iot_data_plane.types.target_port.TargetPort"
    """<p>The port number of the Amazon Web Services IoT Core endpoint that the client connected to.</p>"""
    keep_alive_duration: (
        "capo_iot_data_plane.types.keep_alive_duration.KeepAliveDuration"
    )
    """<p>The keep-alive interval in seconds that the client specified when establishing the connection.</p>"""
    connected_since: "capo_iot_data_plane.types.timestamp.Timestamp"
    """<p>Unix timestamp (in milliseconds) indicating when the client connected. Present only when connected is true.</p>"""
    disconnected_since: "capo_iot_data_plane.types.timestamp.Timestamp"
    """<p>Unix timestamp (in milliseconds) indicating when the client disconnected. Present only when connected is false. This information is available for 30 minutes after the client disconnects.</p>"""
    disconnect_reason: NotRequired[
        "capo_iot_data_plane.types.disconnect_reason.DisconnectReason"
    ]
    """<p>The reason for the last disconnection, if the client is currently disconnected. See the <a href="https://docs.aws.amazon.com/iot/latest/developerguide/life-cycle-events.html#connect-disconnect">developer guide</a> for valid disconnect reasons.</p>"""
    session_expiry: "capo_iot_data_plane.types.session_expiry.SessionExpiry"
    """<p>The session expiry interval in seconds for the MQTT client connection. This is configured by the user. This value indicates how long the session will remain active after the client disconnects.</p>"""
    client_id: NotRequired["capo_iot_data_plane.types.client_id.ClientId"]
    """<p>The unique identifier of the MQTT client. This is the same client ID that was used when the client established the connection.</p>"""
    vpc_endpoint_id: NotRequired[
        "capo_iot_data_plane.types.vpc_endpoint_id.VpcEndpointId"
    ]
    """<p>The ID of the VPC endpoint. Present for clients connected to IoT Core via a <a href="https://docs.aws.amazon.com/iot/latest/developerguide/IoTCore-VPC.html">VPC endpoint</a>. </p>"""