Network.AWS.GameLift.DescribePlayerSessions

Retrieves properties for one or more player sessions. This action can be used in several ways: (1) provide a PlayerSessionId parameter to request properties for a specific player session; (2) provide a GameSessionId parameter to request properties for all player sessions in the specified game session; (3) provide a PlayerId parameter to request properties for all player sessions of a specified player.

To get game session record(s), specify only one of the following: a player session ID, a game session ID, or a player ID. You can filter this request by player session status. Use the pagination parameters to retrieve results as a set of sequential pages. If successful, a PlayerSession object is returned for each session matching the request.

Creating a Request

describePlayerSessions :: DescribePlayerSessions

Creates a value of DescribePlayerSessions with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dpsGameSessionId
• dpsNextToken
• dpsLimit
• dpsPlayerSessionId
• dpsPlayerId
• dpsPlayerSessionStatusFilter

data DescribePlayerSessions

Represents the input for a request action.

See: describePlayerSessions smart constructor.

Instances

Eq DescribePlayerSessions

Methods

(==) :: DescribePlayerSessions -> DescribePlayerSessions -> Bool

(/=) :: DescribePlayerSessions -> DescribePlayerSessions -> Bool

Data DescribePlayerSessions

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribePlayerSessions -> c DescribePlayerSessions

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribePlayerSessions

toConstr :: DescribePlayerSessions -> Constr

dataTypeOf :: DescribePlayerSessions -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribePlayerSessions)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribePlayerSessions)

gmapT :: (forall b. Data b => b -> b) -> DescribePlayerSessions -> DescribePlayerSessions

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribePlayerSessions -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribePlayerSessions -> r

gmapQ :: (forall d. Data d => d -> u) -> DescribePlayerSessions -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribePlayerSessions -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribePlayerSessions -> m DescribePlayerSessions

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribePlayerSessions -> m DescribePlayerSessions

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribePlayerSessions -> m DescribePlayerSessions

Read DescribePlayerSessions

Methods

readsPrec :: Int -> ReadS DescribePlayerSessions

readList :: ReadS [DescribePlayerSessions]

readPrec :: ReadPrec DescribePlayerSessions

readListPrec :: ReadPrec [DescribePlayerSessions]

Show DescribePlayerSessions

Methods

showsPrec :: Int -> DescribePlayerSessions -> ShowS

show :: DescribePlayerSessions -> String

showList :: [DescribePlayerSessions] -> ShowS

Generic DescribePlayerSessions

Associated Types

type Rep DescribePlayerSessions :: * -> *

Methods

from :: DescribePlayerSessions -> Rep DescribePlayerSessions x

to :: Rep DescribePlayerSessions x -> DescribePlayerSessions

ToJSON DescribePlayerSessions

Methods

toJSON :: DescribePlayerSessions -> Value

toEncoding :: DescribePlayerSessions -> Encoding

Hashable DescribePlayerSessions

Methods

hashWithSalt :: Int -> DescribePlayerSessions -> Int

hash :: DescribePlayerSessions -> Int

NFData DescribePlayerSessions

Methods

rnf :: DescribePlayerSessions -> ()

AWSRequest DescribePlayerSessions

Associated Types

type Rs DescribePlayerSessions :: *

Methods

request :: DescribePlayerSessions -> Request DescribePlayerSessions

response :: MonadResource m => Logger -> Service -> Proxy * DescribePlayerSessions -> ClientResponse -> m (Response DescribePlayerSessions)

ToPath DescribePlayerSessions

Methods

toPath :: DescribePlayerSessions -> ByteString

ToHeaders DescribePlayerSessions

Methods

toHeaders :: DescribePlayerSessions -> [Header]

ToQuery DescribePlayerSessions

Methods

toQuery :: DescribePlayerSessions -> QueryString

type Rep DescribePlayerSessions

type Rep DescribePlayerSessions = D1 (MetaData "DescribePlayerSessions" "Network.AWS.GameLift.DescribePlayerSessions" "amazonka-gamelift-1.4.2-4OmARPlGcKyHp4L1Ls6M8f" False) (C1 (MetaCons "DescribePlayerSessions'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dpsGameSessionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dpsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dpsLimit") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))))) ((:*:) (S1 (MetaSel (Just Symbol "_dpsPlayerSessionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dpsPlayerId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dpsPlayerSessionStatusFilter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))))))

type Rs DescribePlayerSessions

type Rs DescribePlayerSessions = DescribePlayerSessionsResponse

Request Lenses

dpsGameSessionId :: Lens' DescribePlayerSessions (Maybe Text)

Unique identifier for a game session.

dpsNextToken :: Lens' DescribePlayerSessions (Maybe Text)

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. If a player session ID is specified, this parameter is ignored.

dpsLimit :: Lens' DescribePlayerSessions (Maybe Natural)

Maximum number of results to return. You can use this parameter with NextToken to get results as a set of sequential pages. If a player session ID is specified, this parameter is ignored.

dpsPlayerSessionId :: Lens' DescribePlayerSessions (Maybe Text)

Unique identifier for a player session.

dpsPlayerId :: Lens' DescribePlayerSessions (Maybe Text)

Unique identifier for a player.

dpsPlayerSessionStatusFilter :: Lens' DescribePlayerSessions (Maybe Text)

Player session status to filter results on. Possible player session states include:

• RESERVED: The player session request has been received, but the player has not yet connected to the game server and/or been validated.
• ACTIVE: The player has been validated by the game server and is currently connected.
• COMPLETED: The player connection has been dropped.
• TIMEDOUT: A player session request was received, but the player did not connect and/or was not validated within the time-out limit (60 seconds).

Destructuring the Response

describePlayerSessionsResponse

Arguments

:: Int

dpsrsResponseStatus

-> DescribePlayerSessionsResponse

Creates a value of DescribePlayerSessionsResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• dpsrsNextToken
• dpsrsPlayerSessions
• dpsrsResponseStatus

data DescribePlayerSessionsResponse

Represents the returned data in response to a request action.

See: describePlayerSessionsResponse smart constructor.

Instances

Eq DescribePlayerSessionsResponse

Methods

(==) :: DescribePlayerSessionsResponse -> DescribePlayerSessionsResponse -> Bool

(/=) :: DescribePlayerSessionsResponse -> DescribePlayerSessionsResponse -> Bool

Data DescribePlayerSessionsResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> DescribePlayerSessionsResponse -> c DescribePlayerSessionsResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c DescribePlayerSessionsResponse

toConstr :: DescribePlayerSessionsResponse -> Constr

dataTypeOf :: DescribePlayerSessionsResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c DescribePlayerSessionsResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c DescribePlayerSessionsResponse)

gmapT :: (forall b. Data b => b -> b) -> DescribePlayerSessionsResponse -> DescribePlayerSessionsResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> DescribePlayerSessionsResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> DescribePlayerSessionsResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> DescribePlayerSessionsResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> DescribePlayerSessionsResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> DescribePlayerSessionsResponse -> m DescribePlayerSessionsResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribePlayerSessionsResponse -> m DescribePlayerSessionsResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> DescribePlayerSessionsResponse -> m DescribePlayerSessionsResponse

Read DescribePlayerSessionsResponse

Methods

readsPrec :: Int -> ReadS DescribePlayerSessionsResponse

readList :: ReadS [DescribePlayerSessionsResponse]

readPrec :: ReadPrec DescribePlayerSessionsResponse

readListPrec :: ReadPrec [DescribePlayerSessionsResponse]

Show DescribePlayerSessionsResponse

Methods

showsPrec :: Int -> DescribePlayerSessionsResponse -> ShowS

show :: DescribePlayerSessionsResponse -> String

showList :: [DescribePlayerSessionsResponse] -> ShowS

Generic DescribePlayerSessionsResponse

Associated Types

type Rep DescribePlayerSessionsResponse :: * -> *

Methods

from :: DescribePlayerSessionsResponse -> Rep DescribePlayerSessionsResponse x

to :: Rep DescribePlayerSessionsResponse x -> DescribePlayerSessionsResponse

NFData DescribePlayerSessionsResponse

Methods

rnf :: DescribePlayerSessionsResponse -> ()

type Rep DescribePlayerSessionsResponse

type Rep DescribePlayerSessionsResponse = D1 (MetaData "DescribePlayerSessionsResponse" "Network.AWS.GameLift.DescribePlayerSessions" "amazonka-gamelift-1.4.2-4OmARPlGcKyHp4L1Ls6M8f" False) (C1 (MetaCons "DescribePlayerSessionsResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dpsrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dpsrsPlayerSessions") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [PlayerSession]))) (S1 (MetaSel (Just Symbol "_dpsrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))))

Response Lenses

dpsrsNextToken :: Lens' DescribePlayerSessionsResponse (Maybe Text)

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.

dpsrsPlayerSessions :: Lens' DescribePlayerSessionsResponse [PlayerSession]

Collection of objects containing properties for each player session that matches the request.

dpsrsResponseStatus :: Lens' DescribePlayerSessionsResponse Int

The response status code.