AWS cli documentation change
Summary
Updated documentation for stream session statuses with more detailed explanations of timeout behaviors and session termination conditions. Added new status states (ERROR, RECONNECTING) and clarified automatic termination rules.
Security assessment
The changes add documentation about session timeout mechanisms (ConnectionTimeoutSeconds) and automatic termination conditions, which relate to session management security practices. However, there's no evidence this addresses a specific vulnerability or security incident.
Diff
diff --git a/cli/latest/reference/gameliftstreams/list-stream-sessions.md b/cli/latest/reference/gameliftstreams/list-stream-sessions.md index 6f113ec56..6079d3bc9 100644 --- a//cli/latest/reference/gameliftstreams/list-stream-sessions.md +++ b//cli/latest/reference/gameliftstreams/list-stream-sessions.md @@ -15 +15 @@ - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) » @@ -126,3 +126,3 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli -> * **SUCCEEDED** : The exported files are successfully stored in S3 bucket. -> * **FAILED** : The session ended but Amazon GameLift Streams couldn’t collect and upload the to S3. -> * **PENDING** : Either the stream session is still in progress, or uploading the exported files to the S3 bucket is in progress. +> * `SUCCEEDED` : The exported files are successfully stored in an S3 bucket. +> * `FAILED` : The session ended but Amazon GameLift Streams couldn’t collect and upload the files to S3. +> * `PENDING` : Either the stream session is still in progress, or uploading the exported files to the S3 bucket is in progress. @@ -267 +267 @@ Items -> (list) ->> Describes a Amazon GameLift Streams stream session. To retrieve additional details for the stream session, call [GetStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamSession.html) . +>> Describes an Amazon GameLift Streams stream session. To retrieve additional details for the stream session, call [GetStreamSession](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_GetStreamSession.html) . @@ -279 +279 @@ Items -> (list) ->>> The current status of the stream session resource. Possible statuses include the following: +>>> The current status of the stream session resource. @@ -282,3 +282,5 @@ Items -> (list) ->>> * `ACTIVE` : The stream session is ready to accept client connections. ->>> * `CONNECTED` : The stream session has a connected client. ->>> * `PENDING_CLIENT_RECONNECTION` : A client has recently disconnected, and the stream session is waiting for the client to reconnect. After a short time, if the client doesn’t reconnect, the stream session status transitions to `TERMINATED` . +>>> * `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. @@ -287 +288,0 @@ Items -> (list) ->>> * `ERROR` : The stream session failed to activate. @@ -329,3 +330 @@ Items -> (list) ->>> 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_ . @@ -347 +346 @@ NextToken -> (string) - * [AWS CLI 2.28.12 Command Reference](../../index.html) » + * [AWS CLI 2.28.15 Command Reference](../../index.html) »