AWS cli documentation change
Summary
Updated CLI version references from 2.28.4 to 2.28.6, reordered parameters, restructured response documentation, and added new field descriptions for stream session metadata including UserId, Status transitions, Protocol, LastUpdatedAt, and OutputUri examples.
Security assessment
The changes primarily reorganize documentation structure and add operational metadata fields. No security vulnerabilities or mitigations are mentioned. The added UserId field description refers to developer-defined identifiers without discussing authentication/authorization. Status field additions describe workflow states rather than security controls.
Diff
diff --git a/cli/latest/reference/gameliftstreams/list-stream-sessions-by-account.md b/cli/latest/reference/gameliftstreams/list-stream-sessions-by-account.md index 4487f1956..92687d4ea 100644 --- a//cli/latest/reference/gameliftstreams/list-stream-sessions-by-account.md +++ b//cli/latest/reference/gameliftstreams/list-stream-sessions-by-account.md @@ -15 +15 @@ - * [AWS CLI 2.28.4 Command Reference](../../index.html) » + * [AWS CLI 2.28.6 Command Reference](../../index.html) » @@ -73 +72,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli - [--export-files-status <value>] @@ -74,0 +74 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli + [--export-files-status <value>] @@ -102,12 +101,0 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli -`--export-files-status` (string) - -> Filter by the exported files status. You can specify one status in each request to retrieve only sessions that currently have that exported files status. -> -> Possible values: -> -> * `SUCCEEDED` -> * `FAILED` -> * `PENDING` -> - - @@ -130,0 +119,12 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/gameli +`--export-files-status` (string) + +> Filter by the exported files status. You can specify one status in each request to retrieve only sessions that currently have that exported files status. +> +> Possible values: +> +> * `SUCCEEDED` +> * `FAILED` +> * `PENDING` +> + + @@ -256,4 +255,0 @@ Items -> (list) ->> ApplicationArn -> (string) ->> ->>> An [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) that uniquely identifies the application resource. Example ARN: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` . ->> @@ -263,0 +260,26 @@ Items -> (list) +>> UserId -> (string) +>> +>>> An opaque, unique identifier for an end-user, defined by the developer. +>> +>> Status -> (string) +>> +>>> The current status of the stream session resource. Possible statuses include the following: +>>> +>>> * `ACTIVATING` : The stream session is starting and preparing to stream. +>>> * `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` . +>>> * `TERMINATING` : The stream session is ending. +>>> * `TERMINATED` : The stream session has ended. +>>> * `ERROR` : The stream session failed to activate. +>>> + +>> +>> Protocol -> (string) +>> +>>> The data transfer protocol in use with the stream session. +>> +>> LastUpdatedAt -> (timestamp) +>> +>>> A timestamp that indicates when this resource was last updated. Timestamps are expressed using in ISO8601 format, such as: `2022-12-27T22:29:40+00:00` (UTC). +>> @@ -267,0 +290,4 @@ Items -> (list) +>> ApplicationArn -> (string) +>> +>>> An [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) that uniquely identifies the application resource. Example ARN: `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6` . +>> @@ -272,8 +297,0 @@ Items -> (list) ->>> OutputUri -> (string) ->>> ->>>> The S3 bucket URI where Amazon GameLift Streams uploaded the set of compressed exported files for a stream session. Amazon GameLift Streams generates a ZIP file name based on the stream session metadata. Alternatively, you can provide a custom file name with a `.zip` file extension. ->>>> ->>>> Example 1: If you provide an S3 URI called `s3://amzn-s3-demo-destination-bucket/MyGame_Session1.zip` , then Amazon GameLift Streams will save the files at that location. ->>>> ->>>> Example 2: If you provide an S3 URI called `s3://amzn-s3-demo-destination-bucket/MyGameSessions_ExportedFiles/` , then Amazon GameLift Streams will save the files at `s3://amzn-s3-demo-destination-bucket/MyGameSessions_ExportedFiles/YYYYMMDD-HHMMSS-appId-sg-Id-sessionId.zip` or another similar name. ->>> @@ -287,4 +305,8 @@ Items -> (list) ->> ->> LastUpdatedAt -> (timestamp) ->> ->>> A timestamp that indicates when this resource was last updated. Timestamps are expressed using in ISO8601 format, such as: `2022-12-27T22:29:40+00:00` (UTC). +>>> +>>> OutputUri -> (string) +>>> +>>>> The S3 bucket URI where Amazon GameLift Streams uploaded the set of compressed exported files for a stream session. Amazon GameLift Streams generates a ZIP file name based on the stream session metadata. Alternatively, you can provide a custom file name with a `.zip` file extension. +>>>> +>>>> Example 1: If you provide an S3 URI called `s3://amzn-s3-demo-destination-bucket/MyGame_Session1.zip` , then Amazon GameLift Streams will save the files at that location. +>>>> +>>>> Example 2: If you provide an S3 URI called `s3://amzn-s3-demo-destination-bucket/MyGameSessions_ExportedFiles/` , then Amazon GameLift Streams will save the files at `s3://amzn-s3-demo-destination-bucket/MyGameSessions_ExportedFiles/YYYYMMDD-HHMMSS-appId-sg-Id-sessionId.zip` or another similar name. @@ -297,22 +318,0 @@ Items -> (list) ->> ->> Protocol -> (string) ->> ->>> The data transfer protocol in use with the stream session. ->> ->> Status -> (string) ->> ->>> The current status of the stream session resource. Possible statuses include the following: ->>> ->>> * `ACTIVATING` : The stream session is starting and preparing to stream. ->>> * `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` . ->>> * `TERMINATING` : The stream session is ending. ->>> * `TERMINATED` : The stream session has ended. ->>> * `ERROR` : The stream session failed to activate. ->>> - ->> ->> UserId -> (string) ->> ->>> An opaque, unique identifier for an end-user, defined by the developer. @@ -334 +334 @@ NextToken -> (string) - * [AWS CLI 2.28.4 Command Reference](../../index.html) » + * [AWS CLI 2.28.6 Command Reference](../../index.html) »