amazonka-gamelift-1.4.5: Amazon GameLift SDK.

Copyright(c) 2013-2016 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone
LanguageHaskell2010

Network.AWS.GameLift.DescribeGameSessionDetails

Contents

Description

Retrieves properties, including the protection policy in force, for one or more game sessions. This action can be used in several ways: (1) provide a GameSessionId to request details for a specific game session; (2) provide either 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 GameSessionDetail object is returned for each session matching the request.

Synopsis

Creating a Request

describeGameSessionDetails :: DescribeGameSessionDetails #

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

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

  • dgsdGameSessionId - Unique identifier for the game session to retrieve information on. Game session ID format is as follows: "arn:aws:gamelift:region::gamesessionfleet-IDstring". The value of string is either a custom ID string (if one was specified when the game session was created) an autogenerated string.
  • dgsdAliasId - Unique identifier for a fleet alias. Specify an alias to retrieve information on all game sessions active on the fleet.
  • dgsdNextToken - 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.
  • dgsdStatusFilter - Game session status to filter results on. Possible game session statuses include ACTIVE, TERMINATED , ACTIVATING and TERMINATING (the last two are transitory).
  • dgsdLimit - Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.
  • dgsdFleetId - Unique identifier for a fleet. Specify a fleet to retrieve information on all game sessions active on the fleet.

data DescribeGameSessionDetails #

Represents the input for a request action.

See: describeGameSessionDetails smart constructor.

Instances

Eq DescribeGameSessionDetails # 
Data DescribeGameSessionDetails # 

Methods

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

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

toConstr :: DescribeGameSessionDetails -> Constr #

dataTypeOf :: DescribeGameSessionDetails -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> DescribeGameSessionDetails -> DescribeGameSessionDetails #

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

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

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

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

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

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

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

Read DescribeGameSessionDetails # 
Show DescribeGameSessionDetails # 
Generic DescribeGameSessionDetails # 
Hashable DescribeGameSessionDetails # 
ToJSON DescribeGameSessionDetails # 
NFData DescribeGameSessionDetails # 
AWSRequest DescribeGameSessionDetails # 
ToQuery DescribeGameSessionDetails # 
ToPath DescribeGameSessionDetails # 
ToHeaders DescribeGameSessionDetails # 
type Rep DescribeGameSessionDetails # 
type Rep DescribeGameSessionDetails = D1 (MetaData "DescribeGameSessionDetails" "Network.AWS.GameLift.DescribeGameSessionDetails" "amazonka-gamelift-1.4.5-90oxfPbG0dmH3SoKqzJqw8" False) (C1 (MetaCons "DescribeGameSessionDetails'" PrefixI True) ((:*:) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdGameSessionId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdAliasId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dgsdNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))))) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdStatusFilter") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdLimit") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat))) (S1 (MetaSel (Just Symbol "_dgsdFleetId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))))))
type Rs DescribeGameSessionDetails # 

Request Lenses

dgsdGameSessionId :: Lens' DescribeGameSessionDetails (Maybe Text) #

Unique identifier for the game session to retrieve information on. Game session ID format is as follows: "arn:aws:gamelift:region::gamesessionfleet-IDstring". The value of string is either a custom ID string (if one was specified when the game session was created) an autogenerated string.

dgsdAliasId :: Lens' DescribeGameSessionDetails (Maybe Text) #

Unique identifier for a fleet alias. Specify an alias to retrieve information on all game sessions active on the fleet.

dgsdNextToken :: Lens' DescribeGameSessionDetails (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.

dgsdStatusFilter :: Lens' DescribeGameSessionDetails (Maybe Text) #

Game session status to filter results on. Possible game session statuses include ACTIVE, TERMINATED , ACTIVATING and TERMINATING (the last two are transitory).

dgsdLimit :: Lens' DescribeGameSessionDetails (Maybe Natural) #

Maximum number of results to return. Use this parameter with NextToken to get results as a set of sequential pages.

dgsdFleetId :: Lens' DescribeGameSessionDetails (Maybe Text) #

Unique identifier for a fleet. Specify a fleet to retrieve information on all game sessions active on the fleet.

Destructuring the Response

describeGameSessionDetailsResponse #

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

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

  • dgsdrsGameSessionDetails - Collection of objects containing game session properties and the protection policy currently in force for each session matching the request.
  • dgsdrsNextToken - 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.
  • dgsdrsResponseStatus - -- | The response status code.

data DescribeGameSessionDetailsResponse #

Represents the returned data in response to a request action.

See: describeGameSessionDetailsResponse smart constructor.

Instances

Eq DescribeGameSessionDetailsResponse # 
Data DescribeGameSessionDetailsResponse # 

Methods

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

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

toConstr :: DescribeGameSessionDetailsResponse -> Constr #

dataTypeOf :: DescribeGameSessionDetailsResponse -> DataType #

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

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

gmapT :: (forall b. Data b => b -> b) -> DescribeGameSessionDetailsResponse -> DescribeGameSessionDetailsResponse #

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

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

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

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

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

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

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

Read DescribeGameSessionDetailsResponse # 
Show DescribeGameSessionDetailsResponse # 
Generic DescribeGameSessionDetailsResponse # 
NFData DescribeGameSessionDetailsResponse # 
type Rep DescribeGameSessionDetailsResponse # 
type Rep DescribeGameSessionDetailsResponse = D1 (MetaData "DescribeGameSessionDetailsResponse" "Network.AWS.GameLift.DescribeGameSessionDetails" "amazonka-gamelift-1.4.5-90oxfPbG0dmH3SoKqzJqw8" False) (C1 (MetaCons "DescribeGameSessionDetailsResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdrsGameSessionDetails") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [GameSessionDetail]))) ((:*:) (S1 (MetaSel (Just Symbol "_dgsdrsNextToken") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text))) (S1 (MetaSel (Just Symbol "_dgsdrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedUnpack) (Rec0 Int)))))

Response Lenses

dgsdrsGameSessionDetails :: Lens' DescribeGameSessionDetailsResponse [GameSessionDetail] #

Collection of objects containing game session properties and the protection policy currently in force for each session matching the request.

dgsdrsNextToken :: Lens' DescribeGameSessionDetailsResponse (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.