GameLiftStreams / Paginator / ListStreamSessionsByAccount

ListStreamSessionsByAccount#

class GameLiftStreams.Paginator.ListStreamSessionsByAccount#

paginator = client.get_paginator('list_stream_sessions_by_account')

paginate(**kwargs)#

Creates an iterator that will paginate through responses from GameLiftStreams.Client.list_stream_sessions_by_account().

Request Syntax

response_iterator = paginator.paginate(
    ExportFilesStatus='SUCCEEDED'|'FAILED'|'PENDING',
    Status='ACTIVATING'|'ACTIVE'|'CONNECTED'|'PENDING_CLIENT_RECONNECTION'|'RECONNECTING'|'TERMINATING'|'TERMINATED'|'ERROR',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

ExportFilesStatus (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.
Status (string) – Filter by the stream session status. You can specify one status in each request to retrieve only sessions that are currently in that status.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Items': [
        {
            'ApplicationArn': 'string',
            'Arn': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'ExportFilesMetadata': {
                'OutputUri': 'string',
                'Status': 'SUCCEEDED'|'FAILED'|'PENDING',
                'StatusReason': 'string'
            },
            'LastUpdatedAt': datetime(2015, 1, 1),
            'Location': 'string',
            'Protocol': 'WebRTC',
            'Status': 'ACTIVATING'|'ACTIVE'|'CONNECTED'|'PENDING_CLIENT_RECONNECTION'|'RECONNECTING'|'TERMINATING'|'TERMINATED'|'ERROR',
            'UserId': 'string'
        },
    ],

}

Response Structure

(dict) –
- Items (list) –
  
  A collection of Amazon GameLift Streams stream sessions that are associated with a stream group and returned in response to a list request. Each item includes stream session metadata and status.
  - (dict) –
    
    Describes a Amazon GameLift Streams stream session. To retrieve additional details for the stream session, call GetStreamSession.
    - ApplicationArn (string) –
      
      An Amazon Resource Name (ARN) or ID that uniquely identifies the application resource. Format example: ARN- arn:aws:gameliftstreams:us-west-2:123456789012:application/9ZY8X7Wv6 or ID- 9ZY8X7Wv6.
    - Arn (string) –
      
      An Amazon Resource Name (ARN) that uniquely identifies the stream session resource. Format example: 1AB2C3De4. .
    - CreatedAt (datetime) –
      
      A timestamp that indicates when this resource was created. Timestamps are expressed using in ISO8601 format, such as: 2022-12-27T22:29:40+00:00 (UTC).
    - ExportFilesMetadata (dict) –
      
      Provides details about the stream session’s exported files.
      - 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://MyBucket/MyGame_Session1.zip, then Amazon GameLift Streams will save the files at that location.
        
        Example 2: If you provide an S3 URI called s3://MyBucket/MyGameSessions_ExportedFiles/, then Amazon GameLift Streams will save the files at s3://MyBucket/MyGameSessions_ExportedFiles/YYYYMMDD-HHMMSS-appId-sg-Id-sessionId.zip or another similar name.
      - Status (string) –
        
        The result of the ExportStreamSessionFiles operation.
      - StatusReason (string) –
        
        A short description of the reason the export is in FAILED status.
    - LastUpdatedAt (datetime) –
      
      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).
    - 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, see the Regions and quotas section in the Amazon GameLift Streams Developer Guide .
    - 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.