amazonka-gamelift-1.6.0: Amazon GameLift SDK.

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

Network.AWS.GameLift.CreateMatchmakingRuleSet

Contents

Description

Creates a new rule set for FlexMatch matchmaking. A rule set describes the type of match to create, such as the number and size of teams, and sets the parameters for acceptable player matches, such as minimum skill level or character type. Rule sets are used in matchmaking configurations, which define how matchmaking requests are handled. Each MatchmakingConfiguration uses one rule set; you can set up multiple rule sets to handle the scenarios that suit your game (such as for different game modes), and create a separate matchmaking configuration for each rule set. See additional information on rule set content in the MatchmakingRuleSet structure. For help creating rule sets, including useful examples, see the topic Adding FlexMatch to Your Game .

Once created, matchmaking rule sets cannot be changed or deleted, so we recommend checking the rule set syntax using ValidateMatchmakingRuleSet before creating the rule set.

To create a matchmaking rule set, provide the set of rules and a unique name. Rule sets must be defined in the same region as the matchmaking configuration they will be used with. Rule sets cannot be edited or deleted. If you need to change a rule set, create a new one with the necessary edits and then update matchmaking configurations to use the new rule set.

Operations related to match configurations and rule sets include:

  • CreateMatchmakingConfiguration
  • DescribeMatchmakingConfigurations
  • UpdateMatchmakingConfiguration
  • DeleteMatchmakingConfiguration
  • CreateMatchmakingRuleSet
  • DescribeMatchmakingRuleSets
  • ValidateMatchmakingRuleSet

Synopsis

Creating a Request

createMatchmakingRuleSet #

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

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

  • cmrsName - Unique identifier for a matchmaking rule set. This name is used to identify the rule set associated with a matchmaking configuration.
  • cmrsRuleSetBody - Collection of matchmaking rules, formatted as a JSON string. (Note that comments are not allowed in JSON, but most elements support a description field.)

data CreateMatchmakingRuleSet #

Represents the input for a request action.

See: createMatchmakingRuleSet smart constructor.

Instances

Eq CreateMatchmakingRuleSet # 
Data CreateMatchmakingRuleSet # 

Methods

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

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

toConstr :: CreateMatchmakingRuleSet -> Constr #

dataTypeOf :: CreateMatchmakingRuleSet -> DataType #

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

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

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

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

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

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

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

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

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

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

Read CreateMatchmakingRuleSet # 
Show CreateMatchmakingRuleSet # 
Generic CreateMatchmakingRuleSet # 
Hashable CreateMatchmakingRuleSet # 
ToJSON CreateMatchmakingRuleSet # 
NFData CreateMatchmakingRuleSet # 
AWSRequest CreateMatchmakingRuleSet # 
ToHeaders CreateMatchmakingRuleSet # 
ToPath CreateMatchmakingRuleSet # 
ToQuery CreateMatchmakingRuleSet # 
type Rep CreateMatchmakingRuleSet # 
type Rep CreateMatchmakingRuleSet = D1 * (MetaData "CreateMatchmakingRuleSet" "Network.AWS.GameLift.CreateMatchmakingRuleSet" "amazonka-gamelift-1.6.0-AFaGsb9wXmY9FImAlEHdkb" False) (C1 * (MetaCons "CreateMatchmakingRuleSet'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_cmrsName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_cmrsRuleSetBody") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text))))
type Rs CreateMatchmakingRuleSet # 

Request Lenses

cmrsName :: Lens' CreateMatchmakingRuleSet Text #

Unique identifier for a matchmaking rule set. This name is used to identify the rule set associated with a matchmaking configuration.

cmrsRuleSetBody :: Lens' CreateMatchmakingRuleSet Text #

Collection of matchmaking rules, formatted as a JSON string. (Note that comments are not allowed in JSON, but most elements support a description field.)

Destructuring the Response

createMatchmakingRuleSetResponse #

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

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

data CreateMatchmakingRuleSetResponse #

Represents the returned data in response to a request action.

See: createMatchmakingRuleSetResponse smart constructor.

Instances

Eq CreateMatchmakingRuleSetResponse # 
Data CreateMatchmakingRuleSetResponse # 

Methods

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

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

toConstr :: CreateMatchmakingRuleSetResponse -> Constr #

dataTypeOf :: CreateMatchmakingRuleSetResponse -> DataType #

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

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

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

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

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

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

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

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

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

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

Read CreateMatchmakingRuleSetResponse # 
Show CreateMatchmakingRuleSetResponse # 
Generic CreateMatchmakingRuleSetResponse # 
NFData CreateMatchmakingRuleSetResponse # 
type Rep CreateMatchmakingRuleSetResponse # 
type Rep CreateMatchmakingRuleSetResponse = D1 * (MetaData "CreateMatchmakingRuleSetResponse" "Network.AWS.GameLift.CreateMatchmakingRuleSet" "amazonka-gamelift-1.6.0-AFaGsb9wXmY9FImAlEHdkb" False) (C1 * (MetaCons "CreateMatchmakingRuleSetResponse'" PrefixI True) ((:*:) * (S1 * (MetaSel (Just Symbol "_cmrsrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int)) (S1 * (MetaSel (Just Symbol "_cmrsrsRuleSet") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * MatchmakingRuleSet))))

Response Lenses

cmrsrsRuleSet :: Lens' CreateMatchmakingRuleSetResponse MatchmakingRuleSet #

Object that describes the newly created matchmaking rule set.