AWS cli documentation change
Summary
Updated documentation for CreateStreamSessionConnection with detailed reconnection workflow, session state transitions, and timeout mechanics. Removed redundant explanations and added developer guide reference.
Security assessment
The changes clarify session timeout enforcement (ConnectionTimeoutSeconds) and proper session termination processes, which are security-adjacent reliability controls. However, there is no evidence this addresses a specific vulnerability. The documentation now better explains existing security-related session management features.
Diff
diff --git a/cli/latest/reference/gameliftstreams/create-stream-session-connection.md b/cli/latest/reference/gameliftstreams/create-stream-session-connection.md index e605c70af..e4595411a 100644 --- a//cli/latest/reference/gameliftstreams/create-stream-session-connection.md +++ b//cli/latest/reference/gameliftstreams/create-stream-session-connection.md @@ -15 +15 @@ - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) » @@ -59 +59 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -Allows clients to reconnect to a recently disconnected stream session without losing any data from the last session. +Enables clients to reconnect to a stream session while preserving all session state and data in the disconnected session. This reconnection process can be initiated when a stream session is in either `PENDING_CLIENT_RECONNECTION` or `ACTIVE` status. The process works as follows: @@ -61 +61,11 @@ Allows clients to reconnect to a recently disconnected stream session without lo -A client can reconnect to a stream session that’s in `PENDING_CLIENT_RECONNECTION` or `ACTIVE` status. In the stream session life cycle, when the client disconnects from the stream session, the stream session transitions from `CONNECTED` to `PENDING_CLIENT_RECONNECTION` status. When a client requests to reconnect by calling `CreateStreamSessionConnection` , the stream session transitions to `RECONNECTING` status. When the reconnection is successful, the stream session transitions to `ACTIVE` status. After a stream session is disconnected for longer than `ConnectionTimeoutSeconds` , the stream session transitions to the `TERMINATED` status. + * Initial disconnect: + * When a client disconnects or loses connection, the stream session transitions from `CONNECTED` to `PENDING_CLIENT_RECONNECTION` + * Reconnection time window: + * Clients have `ConnectionTimeoutSeconds` (defined in [StartStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_StartStreamSession.html) ) to reconnect before session termination + * Your backend server must call **CreateStreamSessionConnection** to initiate reconnection + * Session transitions to `RECONNECTING` status + * Reconnection completion: + * On successful **CreateStreamSessionConnection** , session status changes to `ACTIVE` + * Provide the new connection information to the requesting client + * Client must establish connection within `ConnectionTimeoutSeconds` + * Session terminates automatically if client fails to connect in time @@ -63 +72,0 @@ A client can reconnect to a stream session that’s in `PENDING_CLIENT_RECONNECT -To connect to an existing stream session, specify the stream group ID and stream session ID that you want to reconnect to, as well as the signal request settings to use with the stream. @@ -65 +74,4 @@ To connect to an existing stream session, specify the stream group ID and stream -> `ConnectionTimeoutSeconds` defines the amount of time after the stream session disconnects that a reconnection is allowed. If a client is disconnected from the stream for longer than `ConnectionTimeoutSeconds` , the stream session ends. + +For more information about the stream session lifecycle, see [Stream sessions](https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/stream-sessions.html) in the _Amazon GameLift Streams Developer Guide_ . + +To begin re-connecting to an existing stream session, specify the stream group ID and stream session ID that you want to reconnect to, and the signal request to use with the stream. @@ -109 +121 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli -> The stream group that you want to run this stream session with. The stream group must be in `ACTIVE` status and have idle stream capacity. +> The stream group that you want to run this stream session with. The stream group must be in `ACTIVE` status. @@ -234 +246 @@ SignalResponse -> (string) - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) »