amazonka-gamelift-2.0: Amazon GameLift SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.GameLift.SuspendGameServerGroup

Description

__This operation is used with the GameLift FleetIQ solution and game server groups.__

Temporarily stops activity on a game server group without terminating instances or the game server group. You can restart activity by calling ResumeGameServerGroup. You can suspend the following activity:

  • Instance type replacement - This activity evaluates the current game hosting viability of all Spot instance types that are defined for the game server group. It updates the Auto Scaling group to remove nonviable Spot Instance types, which have a higher chance of game server interruptions. It then balances capacity across the remaining viable Spot Instance types. When this activity is suspended, the Auto Scaling group continues with its current balance, regardless of viability. Instance protection, utilization metrics, and capacity scaling activities continue to be active.

To suspend activity, specify a game server group ARN and the type of activity to be suspended. If successful, a GameServerGroup object is returned showing that the activity is listed in SuspendedActions.

Learn more

GameLift FleetIQ Guide

Synopsis

Creating a Request

data SuspendGameServerGroup Source #

See: newSuspendGameServerGroup smart constructor.

Constructors

SuspendGameServerGroup' 

Fields

Instances

Instances details
ToJSON SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

ToHeaders SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

ToPath SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

ToQuery SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

AWSRequest SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Associated Types

type AWSResponse SuspendGameServerGroup #

Generic SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Associated Types

type Rep SuspendGameServerGroup :: Type -> Type #

Read SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Show SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

NFData SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Methods

rnf :: SuspendGameServerGroup -> () #

Eq SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Hashable SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

type AWSResponse SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

type Rep SuspendGameServerGroup Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

type Rep SuspendGameServerGroup = D1 ('MetaData "SuspendGameServerGroup" "Amazonka.GameLift.SuspendGameServerGroup" "amazonka-gamelift-2.0-IjhNQby9jLV6gj30IrgsyK" 'False) (C1 ('MetaCons "SuspendGameServerGroup'" 'PrefixI 'True) (S1 ('MetaSel ('Just "gameServerGroupName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "suspendActions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (NonEmpty GameServerGroupAction))))

newSuspendGameServerGroup Source #

Create a value of SuspendGameServerGroup with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

SuspendGameServerGroup, suspendGameServerGroup_gameServerGroupName - A unique identifier for the game server group. Use either the name or ARN value.

$sel:suspendActions:SuspendGameServerGroup', suspendGameServerGroup_suspendActions - The activity to suspend for this game server group.

Request Lenses

suspendGameServerGroup_gameServerGroupName :: Lens' SuspendGameServerGroup Text Source #

A unique identifier for the game server group. Use either the name or ARN value.

Destructuring the Response

data SuspendGameServerGroupResponse Source #

See: newSuspendGameServerGroupResponse smart constructor.

Constructors

SuspendGameServerGroupResponse' 

Fields

Instances

Instances details
Generic SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Associated Types

type Rep SuspendGameServerGroupResponse :: Type -> Type #

Read SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Show SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

NFData SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

Eq SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

type Rep SuspendGameServerGroupResponse Source # 
Instance details

Defined in Amazonka.GameLift.SuspendGameServerGroup

type Rep SuspendGameServerGroupResponse = D1 ('MetaData "SuspendGameServerGroupResponse" "Amazonka.GameLift.SuspendGameServerGroup" "amazonka-gamelift-2.0-IjhNQby9jLV6gj30IrgsyK" 'False) (C1 ('MetaCons "SuspendGameServerGroupResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "gameServerGroup") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe GameServerGroup)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newSuspendGameServerGroupResponse Source #

Create a value of SuspendGameServerGroupResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:gameServerGroup:SuspendGameServerGroupResponse', suspendGameServerGroupResponse_gameServerGroup - An object that describes the game server group resource, with the SuspendedActions property updated to reflect the suspended activity.

$sel:httpStatus:SuspendGameServerGroupResponse', suspendGameServerGroupResponse_httpStatus - The response's http status code.

Response Lenses

suspendGameServerGroupResponse_gameServerGroup :: Lens' SuspendGameServerGroupResponse (Maybe GameServerGroup) Source #

An object that describes the game server group resource, with the SuspendedActions property updated to reflect the suspended activity.