Network.AWS.GameLift.DescribeMatchmaking

Retrieves one or more matchmaking tickets. Use this operation to retrieve ticket information, including status and--once a successful match is made--acquire connection information for the resulting new game session.

You can use this operation to track the progress of matchmaking requests (through polling) as an alternative to using event notifications. See more details on tracking matchmaking requests through polling or notifications in StartMatchmaking .

To request matchmaking tickets, provide a list of up to 10 ticket IDs. If the request is successful, a ticket object is returned for each requested ID that currently exists.

Matchmaking-related operations include:

• StartMatchmaking
• DescribeMatchmaking
• StopMatchmaking
• AcceptMatch
• StartMatchBackfill

Creating a Request

describeMatchmaking :: DescribeMatchmaking

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

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

• dmTicketIds - Unique identifier for a matchmaking ticket. You can include up to 10 ID values.

data DescribeMatchmaking

Represents the input for a request action.

See: describeMatchmaking smart constructor.

Instances

Eq DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

(==) :: DescribeMatchmaking -> DescribeMatchmaking -> Bool

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

Data DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

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

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

toConstr :: DescribeMatchmaking -> Constr

dataTypeOf :: DescribeMatchmaking -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

readsPrec :: Int -> ReadS DescribeMatchmaking

readList :: ReadS [DescribeMatchmaking]

readPrec :: ReadPrec DescribeMatchmaking

readListPrec :: ReadPrec [DescribeMatchmaking]

Show DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

showsPrec :: Int -> DescribeMatchmaking -> ShowS

show :: DescribeMatchmaking -> String

showList :: [DescribeMatchmaking] -> ShowS

Generic DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Associated Types

type Rep DescribeMatchmaking :: Type -> Type

Methods

from :: DescribeMatchmaking -> Rep DescribeMatchmaking x

to :: Rep DescribeMatchmaking x -> DescribeMatchmaking

Hashable DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

hashWithSalt :: Int -> DescribeMatchmaking -> Int

hash :: DescribeMatchmaking -> Int

ToJSON DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

toJSON :: DescribeMatchmaking -> Value

toEncoding :: DescribeMatchmaking -> Encoding

toJSONList :: [DescribeMatchmaking] -> Value

toEncodingList :: [DescribeMatchmaking] -> Encoding

AWSRequest DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Associated Types

type Rs DescribeMatchmaking :: Type

Methods

request :: DescribeMatchmaking -> Request DescribeMatchmaking

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy DescribeMatchmaking -> ClientResponse -> m (Response DescribeMatchmaking)

ToHeaders DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

toHeaders :: DescribeMatchmaking -> [Header]

ToPath DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

toPath :: DescribeMatchmaking -> ByteString

ToQuery DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

toQuery :: DescribeMatchmaking -> QueryString

NFData DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

rnf :: DescribeMatchmaking -> ()

type Rep DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

type Rep DescribeMatchmaking = D1 (MetaData "DescribeMatchmaking" "Network.AWS.GameLift.DescribeMatchmaking" "amazonka-gamelift-1.6.1-GajLKSxsevT2faX837q2Xl" True) (C1 (MetaCons "DescribeMatchmaking'" PrefixI True) (S1 (MetaSel (Just "_dmTicketIds") NoSourceUnpackedness NoSourceStrictness DecidedLazy) (Rec0 [Text])))

type Rs DescribeMatchmaking

Defined in Network.AWS.GameLift.DescribeMatchmaking

type Rs DescribeMatchmaking = DescribeMatchmakingResponse

Request Lenses

dmTicketIds :: Lens' DescribeMatchmaking [Text]

Unique identifier for a matchmaking ticket. You can include up to 10 ID values.

Destructuring the Response

describeMatchmakingResponse

Arguments

:: Int

dmrsResponseStatus

-> DescribeMatchmakingResponse

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

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

• dmrsTicketList - Collection of existing matchmaking ticket objects matching the request.
• dmrsResponseStatus - -- | The response status code.

data DescribeMatchmakingResponse

Represents the returned data in response to a request action.

See: describeMatchmakingResponse smart constructor.

Instances

Eq DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

(==) :: DescribeMatchmakingResponse -> DescribeMatchmakingResponse -> Bool

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

Data DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

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

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

toConstr :: DescribeMatchmakingResponse -> Constr

dataTypeOf :: DescribeMatchmakingResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

readsPrec :: Int -> ReadS DescribeMatchmakingResponse

readList :: ReadS [DescribeMatchmakingResponse]

readPrec :: ReadPrec DescribeMatchmakingResponse

readListPrec :: ReadPrec [DescribeMatchmakingResponse]

Show DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

showsPrec :: Int -> DescribeMatchmakingResponse -> ShowS

show :: DescribeMatchmakingResponse -> String

showList :: [DescribeMatchmakingResponse] -> ShowS

Generic DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Associated Types

type Rep DescribeMatchmakingResponse :: Type -> Type

Methods

from :: DescribeMatchmakingResponse -> Rep DescribeMatchmakingResponse x

to :: Rep DescribeMatchmakingResponse x -> DescribeMatchmakingResponse

NFData DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

Methods

rnf :: DescribeMatchmakingResponse -> ()

type Rep DescribeMatchmakingResponse

Defined in Network.AWS.GameLift.DescribeMatchmaking

type Rep DescribeMatchmakingResponse = D1 (MetaData "DescribeMatchmakingResponse" "Network.AWS.GameLift.DescribeMatchmaking" "amazonka-gamelift-1.6.1-GajLKSxsevT2faX837q2Xl" False) (C1 (MetaCons "DescribeMatchmakingResponse'" PrefixI True) (S1 (MetaSel (Just "_dmrsTicketList") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [MatchmakingTicket])) :*: S1 (MetaSel (Just "_dmrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

dmrsTicketList :: Lens' DescribeMatchmakingResponse [MatchmakingTicket]

Collection of existing matchmaking ticket objects matching the request.

dmrsResponseStatus :: Lens' DescribeMatchmakingResponse Int

• - | The response status code.