/

The Amazon SSM multi-region endpoint

http://ssm.{region}.amazonaws.com

POST

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

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http://ssm.{region}.amazonaws.com/' \
--header 'X-Amz-Target;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "SessionId": "string"
}'

Response Example

200 - Example 1

{
    "SessionId": "string",
    "TokenValue": "string",
    "StreamUrl": "string"
}

Request

Header Params

X-Amz-Target

string

required

Body Params application/json

SessionId

string

required

The ID of the disconnected session to resume.

>= 1 characters<= 96 characters

Examples

Responses

🟢200Success

application/json

Body

SessionId

string

optional

The ID of the session.

>= 1 characters<= 96 characters

TokenValue

string

optional

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

>= 0 characters<= 300 characters

StreamUrl

string

optional

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: wss://ssmmessages.region.amazonaws.com/v1/data-channel/session-id?stream=(input|output).

region represents the Region identifier for an Amazon Web Services Region supported by Amazon Web Services Systems Manager, such as us-east-2 for the US East (Ohio) Region. For a list of supported region values, see the Region column in Systems Manager service endpoints in the Amazon Web Services General Reference.

session-id represents the ID of a Session Manager session, such as 1a2b3c4dEXAMPLE.

🟠480DoesNotExistException

🟠481InternalServerError