Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Retrieves properties for one or more game sessions. This action can be used in several ways: (1) provide a GameSessionId to request properties for a specific game session; (2) provide a FleetId or an AliasId to request properties for all game sessions running on a fleet.
To get game session record(s), specify just one of the following: game session ID, fleet ID, or alias ID. You can filter this request by game session status. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a GameSession object is returned for each session matching the request.
- describeGameSessions :: DescribeGameSessions
- data DescribeGameSessions
- dgsGameSessionId :: Lens' DescribeGameSessions (Maybe Text)
- dgsAliasId :: Lens' DescribeGameSessions (Maybe Text)
- dgsNextToken :: Lens' DescribeGameSessions (Maybe Text)
- dgsStatusFilter :: Lens' DescribeGameSessions (Maybe Text)
- dgsLimit :: Lens' DescribeGameSessions (Maybe Natural)
- dgsFleetId :: Lens' DescribeGameSessions (Maybe Text)
- describeGameSessionsResponse :: Int -> DescribeGameSessionsResponse
- data DescribeGameSessionsResponse
- dgsrsGameSessions :: Lens' DescribeGameSessionsResponse [GameSession]
- dgsrsNextToken :: Lens' DescribeGameSessionsResponse (Maybe Text)
- dgsrsResponseStatus :: Lens' DescribeGameSessionsResponse Int
Creating a Request
describeGameSessions :: DescribeGameSessions Source #
Creates a value of DescribeGameSessions
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data DescribeGameSessions Source #
Represents the input for a request action.
See: describeGameSessions
smart constructor.
Request Lenses
dgsGameSessionId :: Lens' DescribeGameSessions (Maybe Text) Source #
Unique identifier for a game session. Specify the game session to retrieve information on.
dgsAliasId :: Lens' DescribeGameSessions (Maybe Text) Source #
Unique identifier for a fleet alias. Specify an alias to retrieve information on all game sessions active on the fleet.
dgsNextToken :: Lens' DescribeGameSessions (Maybe Text) Source #
Token indicating the start of the next sequential page of results. Use the token that is returned with a previous call to this action. To specify the start of the result set, do not specify a value.
dgsStatusFilter :: Lens' DescribeGameSessions (Maybe Text) Source #
Game session status to filter results on. Possible game session states include ACTIVE, TERMINATED, ACTIVATING and TERMINATING (the last two are transitory).
dgsLimit :: Lens' DescribeGameSessions (Maybe Natural) Source #
Maximum number of results to return. You can use this parameter with NextToken to get results as a set of sequential pages.
dgsFleetId :: Lens' DescribeGameSessions (Maybe Text) Source #
Unique identifier for a fleet. Specify a fleet to retrieve information on all game sessions active on the fleet.
Destructuring the Response
describeGameSessionsResponse Source #
Creates a value of DescribeGameSessionsResponse
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
data DescribeGameSessionsResponse Source #
Represents the returned data in response to a request action.
See: describeGameSessionsResponse
smart constructor.
Response Lenses
dgsrsGameSessions :: Lens' DescribeGameSessionsResponse [GameSession] Source #
Collection of objects containing game session properties for each session matching the request.
dgsrsNextToken :: Lens' DescribeGameSessionsResponse (Maybe Text) Source #
Token indicating where to resume retrieving results on the next call to this action. If no token is returned, these results represent the end of the list.
If a request has a limit that exactly matches the number of remaining results, a token is returned even though there are no more results to retrieve.
dgsrsResponseStatus :: Lens' DescribeGameSessionsResponse Int Source #
The response status code.