AWS cli documentation change
Summary
Updated stream session status documentation with detailed state transitions, timeout behaviors, and session lifecycle clarifications. Enhanced parameter descriptions for ConnectionTimeoutSeconds and SessionLengthSeconds.
Security assessment
The changes clarify session timeout enforcement and automatic termination mechanisms, which are security-adjacent features for session management. However, there's no evidence this addresses a specific security vulnerability. The documentation improvements help users understand built-in security controls like connection timeouts (ConnectionTimeoutSeconds) and maximum session durations (SessionLengthSeconds) that prevent indefinite session persistence.
Diff
diff --git a/cli/latest/reference/gameliftstreams/get-stream-session.md b/cli/latest/reference/gameliftstreams/get-stream-session.md index 5be71c281..d38494d2b 100644 --- a//cli/latest/reference/gameliftstreams/get-stream-session.md +++ b//cli/latest/reference/gameliftstreams/get-stream-session.md @@ -15 +15 @@ - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) » @@ -220 +220,12 @@ Status -> (string) -> The current status of the stream session. A stream session can host clients when in `ACTIVE` status. +> The current status of the stream session. A stream session is ready for a client to connect when in `ACTIVE` status. +> +> * `ACTIVATING` : The stream session is starting and preparing to stream. +> * `ACTIVE` : The stream session is ready and waiting for a client connection. A client has `ConnectionTimeoutSeconds` (specified in `StartStreamSession` ) from when the session reaches `ACTIVE` state to establish a connection. If no client connects within this timeframe, the session automatically terminates. +> * `CONNECTED` : The stream session has a connected client. A session will automatically terminate if there is no user input for 60 minutes, or if the maximum length of a session specified by `SessionLengthSeconds` in `StartStreamSession` is exceeded. +> * `ERROR` : The stream session failed to activate. +> * `PENDING_CLIENT_RECONNECTION` : A client has recently disconnected and the stream session is waiting for the client to reconnect. A client has `ConnectionTimeoutSeconds` (specified in `StartStreamSession` ) from when the session reaches `PENDING_CLIENT_RECONNECTION` state to re-establish a connection. If no client connects within this timeframe, the session automatically terminates. +> * `RECONNECTING` : A client has initiated a reconnect to a session that was in `PENDING_CLIENT_RECONNECTION` state. +> * `TERMINATING` : The stream session is ending. +> * `TERMINATED` : The stream session has ended. +> + @@ -232,3 +243 @@ Location -> (string) -> The location where Amazon GameLift Streams is hosting the stream session. -> -> A location’s name. For example, `us-east-1` . For a complete list of locations that Amazon GameLift Streams supports, refer to [Regions, quotas, and limitations](https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/regions-quotas.html) in the _Amazon GameLift Streams Developer Guide_ . +> The location where Amazon GameLift Streams hosts and streams your application. For example, `us-east-1` . For a complete list of locations that Amazon GameLift Streams supports, refer to [Regions, quotas, and limitations](https://docs.aws.amazon.com/gameliftstreams/latest/developerguide/regions-quotas.html) in the _Amazon GameLift Streams Developer Guide_ . @@ -246 +255 @@ ConnectionTimeoutSeconds -> (integer) -> The maximum length of time (in seconds) that Amazon GameLift Streams keeps the stream session open. At this point, Amazon GameLift Streams ends the stream session regardless of any existing client connections. +> The length of time that Amazon GameLift Streams should wait for a client to connect or reconnect to the stream session. This time span starts when the stream session reaches `ACTIVE` or `PENDING_CLIENT_RECONNECTION` state. If no client connects (or reconnects) before the timeout, Amazon GameLift Streams terminates the stream session. @@ -250 +259 @@ SessionLengthSeconds -> (integer) -> The length of time that Amazon GameLift Streams keeps the game session open. +> The maximum duration of a session. Amazon GameLift Streams will automatically terminate a session after this amount of time has elapsed, regardless of any existing client connections. @@ -326 +335 @@ ExportFilesMetadata -> (structure) - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) »