Copyright	(c) 2013-2018 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None
Language	Haskell2010

Network.AWS.GameLift.UpdateRuntimeConfiguration

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Updates the current run-time configuration for the specified fleet, which tells Amazon GameLift how to launch server processes on instances in the fleet. You can update a fleet's run-time configuration at any time after the fleet is created; it does not need to be in an ACTIVE status.

To update run-time configuration, specify the fleet ID and provide a RuntimeConfiguration object with the updated collection of server process configurations.

Each instance in a Amazon GameLift fleet checks regularly for an updated run-time configuration and changes how it launches server processes to comply with the latest version. Existing server processes are not affected by the update; they continue to run until they end, while Amazon GameLift simply adds new server processes to fit the current run-time configuration. As a result, the run-time configuration changes are applied gradually as existing processes shut down and new processes are launched in Amazon GameLift's normal process recycling activity.

Fleet-related operations include:

CreateFleet
ListFleets
DeleteFleet
Describe fleets:
DescribeFleetAttributes
DescribeFleetCapacity
DescribeFleetPortSettings
DescribeFleetUtilization
DescribeRuntimeConfiguration
DescribeEC2InstanceLimits
DescribeFleetEvents
Update fleets:
UpdateFleetAttributes
UpdateFleetCapacity
UpdateFleetPortSettings
UpdateRuntimeConfiguration
Manage fleet actions:
StartFleetActions
StopFleetActions

Creating a Request

updateRuntimeConfiguration #

Arguments

:: Text	`urcFleetId`
-> RuntimeConfiguration	`urcRuntimeConfiguration`
-> UpdateRuntimeConfiguration

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

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

urcFleetId - Unique identifier for a fleet to update run-time configuration for.
urcRuntimeConfiguration - Instructions for launching server processes on each instance in the fleet. The run-time configuration for a fleet has a collection of server process configurations, one for each type of server process to run on an instance. A server process configuration specifies the location of the server executable, launch parameters, and the number of concurrent processes with that configuration to maintain on each instance.

data UpdateRuntimeConfiguration #

Represents the input for a request action.

See: updateRuntimeConfiguration smart constructor.

Instances

Eq UpdateRuntimeConfiguration #
Methods (==) :: UpdateRuntimeConfiguration -> UpdateRuntimeConfiguration -> Bool # (/=) :: UpdateRuntimeConfiguration -> UpdateRuntimeConfiguration -> Bool #
Data UpdateRuntimeConfiguration #
Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UpdateRuntimeConfiguration -> c UpdateRuntimeConfiguration # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UpdateRuntimeConfiguration # toConstr :: UpdateRuntimeConfiguration -> Constr # dataTypeOf :: UpdateRuntimeConfiguration -> DataType # dataCast1 :: Typeable (* -> ) t => (forall d. Data d => c (t d)) -> Maybe (c UpdateRuntimeConfiguration) # dataCast2 :: Typeable ( -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UpdateRuntimeConfiguration) # gmapT :: (forall b. Data b => b -> b) -> UpdateRuntimeConfiguration -> UpdateRuntimeConfiguration # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRuntimeConfiguration -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRuntimeConfiguration -> r # gmapQ :: (forall d. Data d => d -> u) -> UpdateRuntimeConfiguration -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> UpdateRuntimeConfiguration -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfiguration -> m UpdateRuntimeConfiguration # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfiguration -> m UpdateRuntimeConfiguration # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfiguration -> m UpdateRuntimeConfiguration #
Read UpdateRuntimeConfiguration #
Methods readsPrec :: Int -> ReadS UpdateRuntimeConfiguration # readList :: ReadS [UpdateRuntimeConfiguration] # readPrec :: ReadPrec UpdateRuntimeConfiguration # readListPrec :: ReadPrec [UpdateRuntimeConfiguration] #
Show UpdateRuntimeConfiguration #
Methods showsPrec :: Int -> UpdateRuntimeConfiguration -> ShowS # show :: UpdateRuntimeConfiguration -> String # showList :: [UpdateRuntimeConfiguration] -> ShowS #
Generic UpdateRuntimeConfiguration #
Associated Types type Rep UpdateRuntimeConfiguration :: * -> * # Methods from :: UpdateRuntimeConfiguration -> Rep UpdateRuntimeConfiguration x # to :: Rep UpdateRuntimeConfiguration x -> UpdateRuntimeConfiguration #
Hashable UpdateRuntimeConfiguration #
Methods hashWithSalt :: Int -> UpdateRuntimeConfiguration -> Int # hash :: UpdateRuntimeConfiguration -> Int #
ToJSON UpdateRuntimeConfiguration #
Methods toJSON :: UpdateRuntimeConfiguration -> Value # toEncoding :: UpdateRuntimeConfiguration -> Encoding # toJSONList :: [UpdateRuntimeConfiguration] -> Value # toEncodingList :: [UpdateRuntimeConfiguration] -> Encoding #
NFData UpdateRuntimeConfiguration #
Methods rnf :: UpdateRuntimeConfiguration -> () #
AWSRequest UpdateRuntimeConfiguration #
Associated Types type Rs UpdateRuntimeConfiguration :: * # Methods request :: UpdateRuntimeConfiguration -> Request UpdateRuntimeConfiguration # response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * UpdateRuntimeConfiguration -> ClientResponse -> m (Response UpdateRuntimeConfiguration) #
ToHeaders UpdateRuntimeConfiguration #
Methods toHeaders :: UpdateRuntimeConfiguration -> [Header] #
ToPath UpdateRuntimeConfiguration #
Methods toPath :: UpdateRuntimeConfiguration -> ByteString #
ToQuery UpdateRuntimeConfiguration #
Methods toQuery :: UpdateRuntimeConfiguration -> QueryString #
type Rep UpdateRuntimeConfiguration #
type Rep UpdateRuntimeConfiguration = D1 * (MetaData "UpdateRuntimeConfiguration" "Network.AWS.GameLift.UpdateRuntimeConfiguration" "amazonka-gamelift-1.6.0-AFaGsb9wXmY9FImAlEHdkb" False) (C1 * (MetaCons "UpdateRuntimeConfiguration'" PrefixI True) ((::) (S1 * (MetaSel (Just Symbol "_urcFleetId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)) (S1 * (MetaSel (Just Symbol "_urcRuntimeConfiguration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * RuntimeConfiguration))))
type Rs UpdateRuntimeConfiguration #
type Rs UpdateRuntimeConfiguration = UpdateRuntimeConfigurationResponse

Request Lenses

urcFleetId :: Lens' UpdateRuntimeConfiguration Text #

Unique identifier for a fleet to update run-time configuration for.

urcRuntimeConfiguration :: Lens' UpdateRuntimeConfiguration RuntimeConfiguration #

Instructions for launching server processes on each instance in the fleet. The run-time configuration for a fleet has a collection of server process configurations, one for each type of server process to run on an instance. A server process configuration specifies the location of the server executable, launch parameters, and the number of concurrent processes with that configuration to maintain on each instance.

Destructuring the Response

updateRuntimeConfigurationResponse #

Arguments

:: Int	`urcrsResponseStatus`
-> UpdateRuntimeConfigurationResponse

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

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

urcrsRuntimeConfiguration - The run-time configuration currently in force. If the update was successful, this object matches the one in the request.
urcrsResponseStatus - -- | The response status code.

data UpdateRuntimeConfigurationResponse #

Represents the returned data in response to a request action.

See: updateRuntimeConfigurationResponse smart constructor.

Instances

Eq UpdateRuntimeConfigurationResponse #
Methods (==) :: UpdateRuntimeConfigurationResponse -> UpdateRuntimeConfigurationResponse -> Bool # (/=) :: UpdateRuntimeConfigurationResponse -> UpdateRuntimeConfigurationResponse -> Bool #
Data UpdateRuntimeConfigurationResponse #
Methods gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> UpdateRuntimeConfigurationResponse -> c UpdateRuntimeConfigurationResponse # gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c UpdateRuntimeConfigurationResponse # toConstr :: UpdateRuntimeConfigurationResponse -> Constr # dataTypeOf :: UpdateRuntimeConfigurationResponse -> DataType # dataCast1 :: Typeable (* -> ) t => (forall d. Data d => c (t d)) -> Maybe (c UpdateRuntimeConfigurationResponse) # dataCast2 :: Typeable ( -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c UpdateRuntimeConfigurationResponse) # gmapT :: (forall b. Data b => b -> b) -> UpdateRuntimeConfigurationResponse -> UpdateRuntimeConfigurationResponse # gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRuntimeConfigurationResponse -> r # gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> UpdateRuntimeConfigurationResponse -> r # gmapQ :: (forall d. Data d => d -> u) -> UpdateRuntimeConfigurationResponse -> [u] # gmapQi :: Int -> (forall d. Data d => d -> u) -> UpdateRuntimeConfigurationResponse -> u # gmapM :: Monad m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfigurationResponse -> m UpdateRuntimeConfigurationResponse # gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfigurationResponse -> m UpdateRuntimeConfigurationResponse # gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> UpdateRuntimeConfigurationResponse -> m UpdateRuntimeConfigurationResponse #
Read UpdateRuntimeConfigurationResponse #
Methods readsPrec :: Int -> ReadS UpdateRuntimeConfigurationResponse # readList :: ReadS [UpdateRuntimeConfigurationResponse] # readPrec :: ReadPrec UpdateRuntimeConfigurationResponse # readListPrec :: ReadPrec [UpdateRuntimeConfigurationResponse] #
Show UpdateRuntimeConfigurationResponse #
Methods showsPrec :: Int -> UpdateRuntimeConfigurationResponse -> ShowS # show :: UpdateRuntimeConfigurationResponse -> String # showList :: [UpdateRuntimeConfigurationResponse] -> ShowS #
Generic UpdateRuntimeConfigurationResponse #
Associated Types type Rep UpdateRuntimeConfigurationResponse :: * -> * # Methods from :: UpdateRuntimeConfigurationResponse -> Rep UpdateRuntimeConfigurationResponse x # to :: Rep UpdateRuntimeConfigurationResponse x -> UpdateRuntimeConfigurationResponse #
NFData UpdateRuntimeConfigurationResponse #
Methods rnf :: UpdateRuntimeConfigurationResponse -> () #
type Rep UpdateRuntimeConfigurationResponse #
type Rep UpdateRuntimeConfigurationResponse = D1 * (MetaData "UpdateRuntimeConfigurationResponse" "Network.AWS.GameLift.UpdateRuntimeConfiguration" "amazonka-gamelift-1.6.0-AFaGsb9wXmY9FImAlEHdkb" False) (C1 * (MetaCons "UpdateRuntimeConfigurationResponse'" PrefixI True) ((::) (S1 * (MetaSel (Just Symbol "_urcrsRuntimeConfiguration") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe RuntimeConfiguration))) (S1 * (MetaSel (Just Symbol "_urcrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Int))))

Response Lenses

urcrsRuntimeConfiguration :: Lens' UpdateRuntimeConfigurationResponse (Maybe RuntimeConfiguration) #

The run-time configuration currently in force. If the update was successful, this object matches the one in the request.

urcrsResponseStatus :: Lens' UpdateRuntimeConfigurationResponse Int #

- | The response status code.