v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141381,185842.7 KB

Reconnects a session to a managed node after it has been disconnected. Connections can be resumed for disconnected sessions, but not terminated sessions.

This command is primarily for use by client machines to automatically reconnect during intermittent network issues. It isn't intended for any other use.

post/#X-Amz-Target=AmazonSSM.ResumeSession

Headers

X-Amz-Target'AmazonSSM.ResumeSession' required

Request body

SessionIdstring required

The ID of the disconnected session to resume.

Response

Success

SessionIdstring

The ID of the session.

TokenValuestring

An encrypted token value containing session and caller information. Used to authenticate the connection to the managed node.

StreamUrlstring
<p>A URL back to SSM Agent on the managed node that the Session Manager client uses to send commands and receive output from the managed node. Format: <code>wss://ssmmessages.<b>region</b>.amazonaws.com/v1/data-channel/<b>session-id</b>?stream=(input|output)</code>.</p> <p> <b>region</b> represents the Region identifier for an Amazon Web Services Region supported by Amazon Web Services Systems Manager, such as <code>us-east-2</code> for the US East (Ohio) Region. For a list of supported <b>region</b> values, see the <b>Region</b> column in <a href="https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region">Systems Manager service endpoints</a> in the <i>Amazon Web Services General Reference</i>.</p> <p> <b>session-id</b> represents the ID of a Session Manager session, such as <code>1a2b3c4dEXAMPLE</code>.</p>