Copyright | (c) 2013-2016 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
- Service Configuration
- Errors
- BuildStatus
- ComparisonOperatorType
- EC2InstanceType
- EventCode
- FleetStatus
- GameSessionStatus
- IPProtocol
- InstanceStatus
- MetricName
- OperatingSystem
- PlayerSessionCreationPolicy
- PlayerSessionStatus
- ProtectionPolicy
- RoutingStrategyType
- ScalingAdjustmentType
- ScalingStatusType
- AWSCredentials
- Alias
- Build
- EC2InstanceCounts
- EC2InstanceLimit
- Event
- FleetAttributes
- FleetCapacity
- FleetUtilization
- GameProperty
- GameSession
- GameSessionDetail
- IPPermission
- Instance
- InstanceAccess
- InstanceCredentials
- PlayerSession
- ResourceCreationLimitPolicy
- RoutingStrategy
- RuntimeConfiguration
- S3Location
- ScalingPolicy
- ServerProcess
- gameLift :: Service
- _InvalidFleetStatusException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidRequestException :: AsError a => Getting (First ServiceError) a ServiceError
- _ConflictException :: AsError a => Getting (First ServiceError) a ServiceError
- _TerminalRoutingStrategyException :: AsError a => Getting (First ServiceError) a ServiceError
- _NotFoundException :: AsError a => Getting (First ServiceError) a ServiceError
- _GameSessionFullException :: AsError a => Getting (First ServiceError) a ServiceError
- _InvalidGameSessionStatusException :: AsError a => Getting (First ServiceError) a ServiceError
- _InternalServiceException :: AsError a => Getting (First ServiceError) a ServiceError
- _IdempotentParameterMismatchException :: AsError a => Getting (First ServiceError) a ServiceError
- _UnauthorizedException :: AsError a => Getting (First ServiceError) a ServiceError
- _FleetCapacityExceededException :: AsError a => Getting (First ServiceError) a ServiceError
- _LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError
- data BuildStatus
- = Failed
- | Initialized
- | Ready
- data ComparisonOperatorType
- data EC2InstanceType
- = C3_2XLarge
- | C3_4XLarge
- | C3_8XLarge
- | C3_Large
- | C3_XLarge
- | C4_2XLarge
- | C4_4XLarge
- | C4_8XLarge
- | C4_Large
- | C4_XLarge
- | M3_2XLarge
- | M3_Large
- | M3_Medium
- | M3_XLarge
- | M4_10XLarge
- | M4_2XLarge
- | M4_4XLarge
- | M4_Large
- | M4_XLarge
- | R3_2XLarge
- | R3_4XLarge
- | R3_8XLarge
- | R3_Large
- | R3_XLarge
- | T2_Large
- | T2_Medium
- | T2_Micro
- | T2_Small
- data EventCode
- = FleetActivationFailed
- | FleetActivationFailedNoInstances
- | FleetBinaryDownloadFailed
- | FleetCreated
- | FleetDeleted
- | FleetInitializationFailed
- | FleetNewGameSessionProtectionPolicyUpdated
- | FleetScalingEvent
- | FleetStateActivating
- | FleetStateActive
- | FleetStateBuilding
- | FleetStateDownloading
- | FleetStateError
- | FleetStateValidating
- | FleetValidationExecutableRuntimeFailure
- | FleetValidationLaunchPathNotFound
- | FleetValidationTimedOut
- | GenericEvent
- | ServerProcessCrashed
- | ServerProcessForceTerminated
- | ServerProcessInvalidPath
- | ServerProcessProcessExitTimeout
- | ServerProcessProcessReadyTimeout
- | ServerProcessSDKInitializationTimeout
- | ServerProcessTerminatedUnhealthy
- data FleetStatus
- data GameSessionStatus
- data IPProtocol
- data InstanceStatus
- data MetricName
- data OperatingSystem
- data PlayerSessionCreationPolicy
- data PlayerSessionStatus
- data ProtectionPolicy
- data RoutingStrategyType
- data ScalingAdjustmentType
- data ScalingStatusType
- data AWSCredentials
- awsCredentials :: AWSCredentials
- acSecretAccessKey :: Lens' AWSCredentials (Maybe Text)
- acSessionToken :: Lens' AWSCredentials (Maybe Text)
- acAccessKeyId :: Lens' AWSCredentials (Maybe Text)
- data Alias
- alias :: Alias
- aCreationTime :: Lens' Alias (Maybe UTCTime)
- aLastUpdatedTime :: Lens' Alias (Maybe UTCTime)
- aAliasId :: Lens' Alias (Maybe Text)
- aRoutingStrategy :: Lens' Alias (Maybe RoutingStrategy)
- aName :: Lens' Alias (Maybe Text)
- aDescription :: Lens' Alias (Maybe Text)
- data Build
- build :: Build
- bCreationTime :: Lens' Build (Maybe UTCTime)
- bStatus :: Lens' Build (Maybe BuildStatus)
- bOperatingSystem :: Lens' Build (Maybe OperatingSystem)
- bBuildId :: Lens' Build (Maybe Text)
- bName :: Lens' Build (Maybe Text)
- bVersion :: Lens' Build (Maybe Text)
- bSizeOnDisk :: Lens' Build (Maybe Natural)
- data EC2InstanceCounts
- ec2InstanceCounts :: EC2InstanceCounts
- eicIdLE :: Lens' EC2InstanceCounts (Maybe Natural)
- eicTERMINATING :: Lens' EC2InstanceCounts (Maybe Natural)
- eicPENDING :: Lens' EC2InstanceCounts (Maybe Natural)
- eicMAXIMUM :: Lens' EC2InstanceCounts (Maybe Natural)
- eicDESIRED :: Lens' EC2InstanceCounts (Maybe Natural)
- eicMINIMUM :: Lens' EC2InstanceCounts (Maybe Natural)
- eicACTIVE :: Lens' EC2InstanceCounts (Maybe Natural)
- data EC2InstanceLimit
- ec2InstanceLimit :: EC2InstanceLimit
- eilEC2InstanceType :: Lens' EC2InstanceLimit (Maybe EC2InstanceType)
- eilCurrentInstances :: Lens' EC2InstanceLimit (Maybe Natural)
- eilInstanceLimit :: Lens' EC2InstanceLimit (Maybe Natural)
- data Event
- event :: Event
- eResourceId :: Lens' Event (Maybe Text)
- eEventTime :: Lens' Event (Maybe UTCTime)
- eMessage :: Lens' Event (Maybe Text)
- eEventCode :: Lens' Event (Maybe EventCode)
- eEventId :: Lens' Event (Maybe Text)
- data FleetAttributes
- fleetAttributes :: FleetAttributes
- faCreationTime :: Lens' FleetAttributes (Maybe UTCTime)
- faStatus :: Lens' FleetAttributes (Maybe FleetStatus)
- faServerLaunchParameters :: Lens' FleetAttributes (Maybe Text)
- faLogPaths :: Lens' FleetAttributes [Text]
- faOperatingSystem :: Lens' FleetAttributes (Maybe OperatingSystem)
- faBuildId :: Lens' FleetAttributes (Maybe Text)
- faTerminationTime :: Lens' FleetAttributes (Maybe UTCTime)
- faNewGameSessionProtectionPolicy :: Lens' FleetAttributes (Maybe ProtectionPolicy)
- faName :: Lens' FleetAttributes (Maybe Text)
- faServerLaunchPath :: Lens' FleetAttributes (Maybe Text)
- faFleetId :: Lens' FleetAttributes (Maybe Text)
- faDescription :: Lens' FleetAttributes (Maybe Text)
- faResourceCreationLimitPolicy :: Lens' FleetAttributes (Maybe ResourceCreationLimitPolicy)
- data FleetCapacity
- fleetCapacity :: FleetCapacity
- fcInstanceType :: Lens' FleetCapacity (Maybe EC2InstanceType)
- fcFleetId :: Lens' FleetCapacity (Maybe Text)
- fcInstanceCounts :: Lens' FleetCapacity (Maybe EC2InstanceCounts)
- data FleetUtilization
- fleetUtilization :: FleetUtilization
- fuActiveGameSessionCount :: Lens' FleetUtilization (Maybe Natural)
- fuMaximumPlayerSessionCount :: Lens' FleetUtilization (Maybe Natural)
- fuCurrentPlayerSessionCount :: Lens' FleetUtilization (Maybe Natural)
- fuFleetId :: Lens' FleetUtilization (Maybe Text)
- fuActiveServerProcessCount :: Lens' FleetUtilization (Maybe Natural)
- data GameProperty
- gameProperty :: Text -> Text -> GameProperty
- gpKey :: Lens' GameProperty Text
- gpValue :: Lens' GameProperty Text
- data GameSession
- gameSession :: GameSession
- gsCreationTime :: Lens' GameSession (Maybe UTCTime)
- gsStatus :: Lens' GameSession (Maybe GameSessionStatus)
- gsGameProperties :: Lens' GameSession [GameProperty]
- gsIPAddress :: Lens' GameSession (Maybe Text)
- gsGameSessionId :: Lens' GameSession (Maybe Text)
- gsMaximumPlayerSessionCount :: Lens' GameSession (Maybe Natural)
- gsTerminationTime :: Lens' GameSession (Maybe UTCTime)
- gsPlayerSessionCreationPolicy :: Lens' GameSession (Maybe PlayerSessionCreationPolicy)
- gsName :: Lens' GameSession (Maybe Text)
- gsCurrentPlayerSessionCount :: Lens' GameSession (Maybe Natural)
- gsFleetId :: Lens' GameSession (Maybe Text)
- gsCreatorId :: Lens' GameSession (Maybe Text)
- gsPort :: Lens' GameSession (Maybe Natural)
- data GameSessionDetail
- gameSessionDetail :: GameSessionDetail
- gsdGameSession :: Lens' GameSessionDetail (Maybe GameSession)
- gsdProtectionPolicy :: Lens' GameSessionDetail (Maybe ProtectionPolicy)
- data IPPermission
- ipPermission :: Natural -> Natural -> Text -> IPProtocol -> IPPermission
- ipFromPort :: Lens' IPPermission Natural
- ipToPort :: Lens' IPPermission Natural
- ipIPRange :: Lens' IPPermission Text
- ipProtocol :: Lens' IPPermission IPProtocol
- data Instance
- instance' :: Instance
- iCreationTime :: Lens' Instance (Maybe UTCTime)
- iInstanceId :: Lens' Instance (Maybe Text)
- iStatus :: Lens' Instance (Maybe InstanceStatus)
- iIPAddress :: Lens' Instance (Maybe Text)
- iOperatingSystem :: Lens' Instance (Maybe OperatingSystem)
- iType :: Lens' Instance (Maybe EC2InstanceType)
- iFleetId :: Lens' Instance (Maybe Text)
- data InstanceAccess
- instanceAccess :: InstanceAccess
- iaInstanceId :: Lens' InstanceAccess (Maybe Text)
- iaIPAddress :: Lens' InstanceAccess (Maybe Text)
- iaOperatingSystem :: Lens' InstanceAccess (Maybe OperatingSystem)
- iaCredentials :: Lens' InstanceAccess (Maybe InstanceCredentials)
- iaFleetId :: Lens' InstanceAccess (Maybe Text)
- data InstanceCredentials
- instanceCredentials :: InstanceCredentials
- icUserName :: Lens' InstanceCredentials (Maybe Text)
- icSecret :: Lens' InstanceCredentials (Maybe Text)
- data PlayerSession
- playerSession :: PlayerSession
- psCreationTime :: Lens' PlayerSession (Maybe UTCTime)
- psStatus :: Lens' PlayerSession (Maybe PlayerSessionStatus)
- psIPAddress :: Lens' PlayerSession (Maybe Text)
- psGameSessionId :: Lens' PlayerSession (Maybe Text)
- psTerminationTime :: Lens' PlayerSession (Maybe UTCTime)
- psPlayerSessionId :: Lens' PlayerSession (Maybe Text)
- psFleetId :: Lens' PlayerSession (Maybe Text)
- psPlayerId :: Lens' PlayerSession (Maybe Text)
- psPort :: Lens' PlayerSession (Maybe Natural)
- data ResourceCreationLimitPolicy
- resourceCreationLimitPolicy :: ResourceCreationLimitPolicy
- rclpNewGameSessionsPerCreator :: Lens' ResourceCreationLimitPolicy (Maybe Natural)
- rclpPolicyPeriodInMinutes :: Lens' ResourceCreationLimitPolicy (Maybe Natural)
- data RoutingStrategy
- routingStrategy :: RoutingStrategy
- rsType :: Lens' RoutingStrategy (Maybe RoutingStrategyType)
- rsMessage :: Lens' RoutingStrategy (Maybe Text)
- rsFleetId :: Lens' RoutingStrategy (Maybe Text)
- data RuntimeConfiguration
- runtimeConfiguration :: RuntimeConfiguration
- rcServerProcesses :: Lens' RuntimeConfiguration (Maybe (NonEmpty ServerProcess))
- data S3Location
- s3Location :: S3Location
- slBucket :: Lens' S3Location (Maybe Text)
- slKey :: Lens' S3Location (Maybe Text)
- slRoleARN :: Lens' S3Location (Maybe Text)
- data ScalingPolicy
- scalingPolicy :: ScalingPolicy
- spStatus :: Lens' ScalingPolicy (Maybe ScalingStatusType)
- spScalingAdjustmentType :: Lens' ScalingPolicy (Maybe ScalingAdjustmentType)
- spEvaluationPeriods :: Lens' ScalingPolicy (Maybe Natural)
- spMetricName :: Lens' ScalingPolicy (Maybe MetricName)
- spComparisonOperator :: Lens' ScalingPolicy (Maybe ComparisonOperatorType)
- spName :: Lens' ScalingPolicy (Maybe Text)
- spThreshold :: Lens' ScalingPolicy (Maybe Double)
- spScalingAdjustment :: Lens' ScalingPolicy (Maybe Int)
- spFleetId :: Lens' ScalingPolicy (Maybe Text)
- data ServerProcess
- serverProcess :: Text -> Natural -> ServerProcess
- spParameters :: Lens' ServerProcess (Maybe Text)
- spLaunchPath :: Lens' ServerProcess Text
- spConcurrentExecutions :: Lens' ServerProcess Natural
Service Configuration
Errors
_InvalidFleetStatusException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested operation would cause a conflict with the current state of a resource associated with the request and/or the fleet. Resolve the conflict before retrying.
_InvalidRequestException :: AsError a => Getting (First ServiceError) a ServiceError Source #
One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying.
_ConflictException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.
_TerminalRoutingStrategyException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The service is unable to resolve the routing for a particular alias because it has a terminal RoutingStrategy
associated with it. The message returned in this exception is the message defined in the routing strategy itself. Such requests should only be retried if the routing strategy for the specified alias is modified.
_NotFoundException :: AsError a => Getting (First ServiceError) a ServiceError Source #
A service resource associated with the request could not be found. Clients should not retry such requests.
_GameSessionFullException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The game instance is currently full and cannot allow the requested player(s) to join. Clients can retry such requests immediately or after a waiting period.
_InvalidGameSessionStatusException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested operation would cause a conflict with the current state of a resource associated with the request and/or the game instance. Resolve the conflict before retrying.
_InternalServiceException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period.
_IdempotentParameterMismatchException :: AsError a => Getting (First ServiceError) a ServiceError Source #
A game session with this custom ID string already exists in this fleet. Resolve this conflict before retrying this request.
_UnauthorizedException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The client failed authentication. Clients should not retry such requests.
_FleetCapacityExceededException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The specified fleet has no available instances to fulfill a CreateGameSession
request. Clients can retry such requests immediately or after a waiting period.
_LimitExceededException :: AsError a => Getting (First ServiceError) a ServiceError Source #
The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue before retrying.
BuildStatus
data BuildStatus Source #
ComparisonOperatorType
data ComparisonOperatorType Source #
EC2InstanceType
data EC2InstanceType Source #
EventCode
FleetStatus
data FleetStatus Source #
GameSessionStatus
data GameSessionStatus Source #
IPProtocol
data IPProtocol Source #
InstanceStatus
data InstanceStatus Source #
MetricName
data MetricName Source #
ActivatingGameSessions | |
ActiveGameSessions | |
ActiveInstances | |
AvailablePlayerSessions | |
CurrentPlayerSessions | |
IdleInstances |
OperatingSystem
data OperatingSystem Source #
PlayerSessionCreationPolicy
data PlayerSessionCreationPolicy Source #
PlayerSessionStatus
data PlayerSessionStatus Source #
ProtectionPolicy
data ProtectionPolicy Source #
RoutingStrategyType
data RoutingStrategyType Source #
ScalingAdjustmentType
data ScalingAdjustmentType Source #
ScalingStatusType
data ScalingStatusType Source #
AWSCredentials
data AWSCredentials Source #
AWS access credentials required to upload game build files to Amazon GameLift. These credentials are generated with CreateBuild
, and are valid for a limited time. If they expire before you upload your game build, get a new set by calling RequestUploadCredentials
.
See: awsCredentials
smart constructor.
awsCredentials :: AWSCredentials Source #
Creates a value of AWSCredentials
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
acSecretAccessKey
- Secret key for an AWS account.acSessionToken
- Token specific to a build ID.acAccessKeyId
- Access key for an AWS account.
acSecretAccessKey :: Lens' AWSCredentials (Maybe Text) Source #
Secret key for an AWS account.
acSessionToken :: Lens' AWSCredentials (Maybe Text) Source #
Token specific to a build ID.
acAccessKeyId :: Lens' AWSCredentials (Maybe Text) Source #
Access key for an AWS account.
Alias
Properties describing a fleet alias.
See: alias
smart constructor.
Creates a value of Alias
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
aCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").aLastUpdatedTime
- Time stamp indicating when this data object was last modified. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").aAliasId
- Unique identifier for a fleet alias.aRoutingStrategy
- Undocumented member.aName
- Descriptive label associated with an alias. Alias names do not need to be unique.aDescription
- Human-readable description of an alias.
aCreationTime :: Lens' Alias (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
aLastUpdatedTime :: Lens' Alias (Maybe UTCTime) Source #
Time stamp indicating when this data object was last modified. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
aRoutingStrategy :: Lens' Alias (Maybe RoutingStrategy) Source #
Undocumented member.
aName :: Lens' Alias (Maybe Text) Source #
Descriptive label associated with an alias. Alias names do not need to be unique.
Build
Properties describing a game build.
See: build
smart constructor.
Creates a value of Build
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
bCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").bStatus
- Current status of the build. Possible build statuses include the following: * INITIALIZED – A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value. * READY – The game build has been successfully uploaded. You can now create new fleets for this build. * FAILED – The game build upload failed. You cannot create new fleets for this build.bOperatingSystem
- Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build.bBuildId
- Unique identifier for a build.bName
- Descriptive label associated with a build. Build names do not need to be unique. It can be set usingCreateBuild
orUpdateBuild
.bVersion
- Version associated with this build. Version strings do not need to be unique to a build. This value can be set usingCreateBuild
orUpdateBuild
.bSizeOnDisk
- File size of the uploaded game build, expressed in bytes. When the build status isINITIALIZED
, this value is 0.
bCreationTime :: Lens' Build (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
bStatus :: Lens' Build (Maybe BuildStatus) Source #
Current status of the build. Possible build statuses include the following: * INITIALIZED – A new build has been defined, but no files have been uploaded. You cannot create fleets for builds that are in this status. When a build is successfully created, the build status is set to this value. * READY – The game build has been successfully uploaded. You can now create new fleets for this build. * FAILED – The game build upload failed. You cannot create new fleets for this build.
bOperatingSystem :: Lens' Build (Maybe OperatingSystem) Source #
Operating system that the game server binaries are built to run on. This value determines the type of fleet resources that you can use for this build.
bName :: Lens' Build (Maybe Text) Source #
Descriptive label associated with a build. Build names do not need to be unique. It can be set using CreateBuild
or UpdateBuild
.
bVersion :: Lens' Build (Maybe Text) Source #
Version associated with this build. Version strings do not need to be unique to a build. This value can be set using CreateBuild
or UpdateBuild
.
bSizeOnDisk :: Lens' Build (Maybe Natural) Source #
File size of the uploaded game build, expressed in bytes. When the build status is INITIALIZED
, this value is 0.
EC2InstanceCounts
data EC2InstanceCounts Source #
Current status of fleet capacity. The number of active instances should match or be in the process of matching the number of desired instances. Pending and terminating counts are non-zero only if fleet capacity is adjusting to an UpdateFleetCapacity
request, or if access to resources is temporarily affected.
See: ec2InstanceCounts
smart constructor.
ec2InstanceCounts :: EC2InstanceCounts Source #
Creates a value of EC2InstanceCounts
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
eicIdLE
- Number of active instances in the fleet that are not currently hosting a game session.eicTERMINATING
- Number of instances in the fleet that are no longer active but haven't yet been terminated.eicPENDING
- Number of instances in the fleet that are starting but not yet active.eicMAXIMUM
- Maximum value allowed for the fleet's instance count.eicDESIRED
- Ideal number of active instances in the fleet.eicMINIMUM
- Minimum value allowed for the fleet's instance count.eicACTIVE
- Actual number of active instances in the fleet.
eicIdLE :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Number of active instances in the fleet that are not currently hosting a game session.
eicTERMINATING :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Number of instances in the fleet that are no longer active but haven't yet been terminated.
eicPENDING :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Number of instances in the fleet that are starting but not yet active.
eicMAXIMUM :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Maximum value allowed for the fleet's instance count.
eicDESIRED :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Ideal number of active instances in the fleet.
eicMINIMUM :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Minimum value allowed for the fleet's instance count.
eicACTIVE :: Lens' EC2InstanceCounts (Maybe Natural) Source #
Actual number of active instances in the fleet.
EC2InstanceLimit
data EC2InstanceLimit Source #
Maximum number of instances allowed based on the Amazon Elastic Compute Cloud (Amazon EC2) instance type. Instance limits can be retrieved by calling DescribeEC2InstanceLimits
.
See: ec2InstanceLimit
smart constructor.
ec2InstanceLimit :: EC2InstanceLimit Source #
Creates a value of EC2InstanceLimit
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
eilEC2InstanceType
- Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.eilCurrentInstances
- Number of instances of the specified type that are currently in use by this AWS account.eilInstanceLimit
- Number of instances allowed.
eilEC2InstanceType :: Lens' EC2InstanceLimit (Maybe EC2InstanceType) Source #
Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.
eilCurrentInstances :: Lens' EC2InstanceLimit (Maybe Natural) Source #
Number of instances of the specified type that are currently in use by this AWS account.
eilInstanceLimit :: Lens' EC2InstanceLimit (Maybe Natural) Source #
Number of instances allowed.
Event
Log entry describing an event involving Amazon GameLift resources (such as a fleet). In addition to tracking activity, event codes and messages can provide additional information for troubleshooting and debugging problems.
See: event
smart constructor.
Creates a value of Event
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
eResourceId
- Unique identifier for the resource, such as a fleet ID.eEventTime
- Time stamp indicating when this event occurred. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").eMessage
- Additional information related to the event.eEventCode
- Type of event being logged.eEventId
- Unique identifier for a fleet event.
eResourceId :: Lens' Event (Maybe Text) Source #
Unique identifier for the resource, such as a fleet ID.
eEventTime :: Lens' Event (Maybe UTCTime) Source #
Time stamp indicating when this event occurred. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
FleetAttributes
data FleetAttributes Source #
General properties describing a fleet.
See: fleetAttributes
smart constructor.
fleetAttributes :: FleetAttributes Source #
Creates a value of FleetAttributes
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
faCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").faStatus
- Current status of the fleet. Possible fleet statuses include the following: * NEW – A new fleet has been defined and desired instances is set to 1. * DOWNLOADINGVALIDATINGBUILDING/ACTIVATING – GameLift is setting up the new fleet, creating new instances with the game build and starting server processes. * ACTIVE – Hosts can now accept game sessions. * ERROR – An error occurred when downloading, validating, building, or activating the fleet. * DELETING – Hosts are responding to a delete fleet request. * TERMINATED – The fleet no longer exists.faServerLaunchParameters
- Game server launch parameters specified for fleets created prior to 2016-08-04 (or AWS SDK v. 0.12.16). Server launch parameters for fleets created after this date are specified in the fleet's
.RuntimeConfiguration
faLogPaths
- Location of default log files. When a server process is shut down, Amazon GameLift captures and stores any log files in this location. These logs are in addition to game session logs; see more on game session logs in the Amazon GameLift Developer Guide . If no default log path for a fleet is specified, GameLift will automatically upload logs that are stored on each instance atC:gamelogs
(for Windows) orlocalgame/logs
(for Linux). Use the GameLift console to access stored logs.faOperatingSystem
- Operating system of the fleet's computing resources. A fleet's operating system depends on the OS specified for the build that is deployed on this fleet.faBuildId
- Unique identifier for a build.faTerminationTime
- Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").faNewGameSessionProtectionPolicy
- Type of game session protection to set for all new instances started in the fleet. * NoProtection – The game session can be terminated during a scale-down event. * FullProtection – If the game session is in anACTIVE
status, it cannot be terminated during a scale-down event.faName
- Descriptive label associated with a fleet. Fleet names do not need to be unique.faServerLaunchPath
- Path to a game server executable in the fleet's build, specified for fleets created prior to 2016-08-04 (or AWS SDK v. 0.12.16). Server launch paths for fleets created after this date are specified in the fleet's
.RuntimeConfiguration
faFleetId
- Unique identifier for a fleet.faDescription
- Human-readable description of the fleet.faResourceCreationLimitPolicy
- Fleet policy to limit the number of game sessions an individual player can create over a span of time.
faCreationTime :: Lens' FleetAttributes (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
faStatus :: Lens' FleetAttributes (Maybe FleetStatus) Source #
Current status of the fleet. Possible fleet statuses include the following: * NEW – A new fleet has been defined and desired instances is set to 1. * DOWNLOADINGVALIDATINGBUILDING/ACTIVATING – GameLift is setting up the new fleet, creating new instances with the game build and starting server processes. * ACTIVE – Hosts can now accept game sessions. * ERROR – An error occurred when downloading, validating, building, or activating the fleet. * DELETING – Hosts are responding to a delete fleet request. * TERMINATED – The fleet no longer exists.
faServerLaunchParameters :: Lens' FleetAttributes (Maybe Text) Source #
Game server launch parameters specified for fleets created prior to 2016-08-04 (or AWS SDK v. 0.12.16). Server launch parameters for fleets created after this date are specified in the fleet's
.RuntimeConfiguration
faLogPaths :: Lens' FleetAttributes [Text] Source #
Location of default log files. When a server process is shut down, Amazon GameLift captures and stores any log files in this location. These logs are in addition to game session logs; see more on game session logs in the Amazon GameLift Developer Guide . If no default log path for a fleet is specified, GameLift will automatically upload logs that are stored on each instance at C:gamelogs
(for Windows) or localgame/logs
(for Linux). Use the GameLift console to access stored logs.
faOperatingSystem :: Lens' FleetAttributes (Maybe OperatingSystem) Source #
Operating system of the fleet's computing resources. A fleet's operating system depends on the OS specified for the build that is deployed on this fleet.
faTerminationTime :: Lens' FleetAttributes (Maybe UTCTime) Source #
Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
faNewGameSessionProtectionPolicy :: Lens' FleetAttributes (Maybe ProtectionPolicy) Source #
Type of game session protection to set for all new instances started in the fleet. * NoProtection – The game session can be terminated during a scale-down event. * FullProtection – If the game session is in an ACTIVE
status, it cannot be terminated during a scale-down event.
faName :: Lens' FleetAttributes (Maybe Text) Source #
Descriptive label associated with a fleet. Fleet names do not need to be unique.
faServerLaunchPath :: Lens' FleetAttributes (Maybe Text) Source #
Path to a game server executable in the fleet's build, specified for fleets created prior to 2016-08-04 (or AWS SDK v. 0.12.16). Server launch paths for fleets created after this date are specified in the fleet's
.RuntimeConfiguration
faDescription :: Lens' FleetAttributes (Maybe Text) Source #
Human-readable description of the fleet.
faResourceCreationLimitPolicy :: Lens' FleetAttributes (Maybe ResourceCreationLimitPolicy) Source #
Fleet policy to limit the number of game sessions an individual player can create over a span of time.
FleetCapacity
data FleetCapacity Source #
Information about the fleet's capacity. Fleet capacity is measured in EC2 instances. By default, new fleets have a capacity of one instance, but can be updated as needed. The maximum number of instances for a fleet is determined by the fleet's instance type.
See: fleetCapacity
smart constructor.
fleetCapacity :: FleetCapacity Source #
Creates a value of FleetCapacity
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
fcInstanceType
- Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.fcFleetId
- Unique identifier for a fleet.fcInstanceCounts
- Current status of fleet capacity.
fcInstanceType :: Lens' FleetCapacity (Maybe EC2InstanceType) Source #
Name of an EC2 instance type that is supported in Amazon GameLift. A fleet instance type determines the computing resources of each instance in the fleet, including CPU, memory, storage, and networking capacity. GameLift supports the following EC2 instance types. See Amazon EC2 Instance Types for detailed descriptions.
fcInstanceCounts :: Lens' FleetCapacity (Maybe EC2InstanceCounts) Source #
Current status of fleet capacity.
FleetUtilization
data FleetUtilization Source #
Current status of fleet utilization, including the number of game and player sessions being hosted.
See: fleetUtilization
smart constructor.
fleetUtilization :: FleetUtilization Source #
Creates a value of FleetUtilization
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
fuActiveGameSessionCount
- Number of active game sessions currently being hosted on all instances in the fleet.fuMaximumPlayerSessionCount
- Maximum players allowed across all game sessions currently being hosted on all instances in the fleet.fuCurrentPlayerSessionCount
- Number of active player sessions currently being hosted on all instances in the fleet.fuFleetId
- Unique identifier for a fleet.fuActiveServerProcessCount
- Number of server processes in anACTIVE
status currently running across all instances in the fleet
fuActiveGameSessionCount :: Lens' FleetUtilization (Maybe Natural) Source #
Number of active game sessions currently being hosted on all instances in the fleet.
fuMaximumPlayerSessionCount :: Lens' FleetUtilization (Maybe Natural) Source #
Maximum players allowed across all game sessions currently being hosted on all instances in the fleet.
fuCurrentPlayerSessionCount :: Lens' FleetUtilization (Maybe Natural) Source #
Number of active player sessions currently being hosted on all instances in the fleet.
fuActiveServerProcessCount :: Lens' FleetUtilization (Maybe Natural) Source #
Number of server processes in an ACTIVE
status currently running across all instances in the fleet
GameProperty
data GameProperty Source #
Set of key-value pairs containing information a server process requires to set up a game session. This object allows you to pass in any set of data needed for your game. For more information, see the Amazon GameLift Developer Guide .
See: gameProperty
smart constructor.
:: Text | |
-> Text | |
-> GameProperty |
Creates a value of GameProperty
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
GameSession
data GameSession Source #
Properties describing a game session.
See: gameSession
smart constructor.
gameSession :: GameSession Source #
Creates a value of GameSession
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
gsCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").gsStatus
- Current status of the game session. A game session must be in anACTIVE
status to have player sessions.gsGameProperties
- Set of custom properties for the game session.gsIPAddress
- IP address of the game session. To connect to a GameLift server process, an app needs both the IP address and port number.gsGameSessionId
- Unique identifier for a game session. 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.gsMaximumPlayerSessionCount
- Maximum number of players allowed in the game session.gsTerminationTime
- Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").gsPlayerSessionCreationPolicy
- Indicates whether or not the game session is accepting new players.gsName
- Descriptive label associated with a game session. Session names do not need to be unique.gsCurrentPlayerSessionCount
- Number of players currently in the game session.gsFleetId
- Unique identifier for a fleet.gsCreatorId
- Player ID of the person or entity that created the game session. This ID is used to enforce a resource protection policy (if one exists) that limits the number of concurrent active game sessions for a single player.gsPort
- Port number for the game session. To connect to a GameLift server process, an app needs both the IP address and port number.
gsCreationTime :: Lens' GameSession (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
gsStatus :: Lens' GameSession (Maybe GameSessionStatus) Source #
Current status of the game session. A game session must be in an ACTIVE
status to have player sessions.
gsGameProperties :: Lens' GameSession [GameProperty] Source #
Set of custom properties for the game session.
gsIPAddress :: Lens' GameSession (Maybe Text) Source #
IP address of the game session. To connect to a GameLift server process, an app needs both the IP address and port number.
gsMaximumPlayerSessionCount :: Lens' GameSession (Maybe Natural) Source #
Maximum number of players allowed in the game session.
gsTerminationTime :: Lens' GameSession (Maybe UTCTime) Source #
Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
gsPlayerSessionCreationPolicy :: Lens' GameSession (Maybe PlayerSessionCreationPolicy) Source #
Indicates whether or not the game session is accepting new players.
gsName :: Lens' GameSession (Maybe Text) Source #
Descriptive label associated with a game session. Session names do not need to be unique.
gsCurrentPlayerSessionCount :: Lens' GameSession (Maybe Natural) Source #
Number of players currently in the game session.
gsCreatorId :: Lens' GameSession (Maybe Text) Source #
Player ID of the person or entity that created the game session. This ID is used to enforce a resource protection policy (if one exists) that limits the number of concurrent active game sessions for a single player.
gsPort :: Lens' GameSession (Maybe Natural) Source #
Port number for the game session. To connect to a GameLift server process, an app needs both the IP address and port number.
GameSessionDetail
data GameSessionDetail Source #
A game session's properties and the protection policy currently in force.
See: gameSessionDetail
smart constructor.
gameSessionDetail :: GameSessionDetail Source #
Creates a value of GameSessionDetail
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
gsdGameSession
- Undocumented member.gsdProtectionPolicy
- Current status of protection for the game session. * NoProtection – The game session can be terminated during a scale-down event. * FullProtection – If the game session is in anACTIVE
status, it cannot be terminated during a scale-down event.
gsdGameSession :: Lens' GameSessionDetail (Maybe GameSession) Source #
Undocumented member.
gsdProtectionPolicy :: Lens' GameSessionDetail (Maybe ProtectionPolicy) Source #
Current status of protection for the game session. * NoProtection – The game session can be terminated during a scale-down event. * FullProtection – If the game session is in an ACTIVE
status, it cannot be terminated during a scale-down event.
IPPermission
data IPPermission Source #
A range of IP addresses and port settings that allow inbound traffic to connect to server processes on GameLift. Each game session hosted on a fleet is assigned a unique combination of IP address and port number, which must fall into the fleet's allowed ranges. This combination is included in the GameSession
object.
See: ipPermission
smart constructor.
Creates a value of IPPermission
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
ipFromPort
- Starting value for a range of allowed port numbers.ipToPort
- Ending value for a range of allowed port numbers. Port numbers are end-inclusive. This value must be higher thanFromPort
.ipIPRange
- Range of allowed IP addresses. This value must be expressed in CIDR notation . Example: "000.000.000.000/[subnet mask]
" or optionally the shortened version "0.0.0.0/[subnet mask]
".ipProtocol
- Network communication protocol used by the fleet.
ipFromPort :: Lens' IPPermission Natural Source #
Starting value for a range of allowed port numbers.
ipToPort :: Lens' IPPermission Natural Source #
Ending value for a range of allowed port numbers. Port numbers are end-inclusive. This value must be higher than FromPort
.
ipIPRange :: Lens' IPPermission Text Source #
Range of allowed IP addresses. This value must be expressed in CIDR notation . Example: "000.000.000.000/[subnet mask]
" or optionally the shortened version "0.0.0.0/[subnet mask]
".
ipProtocol :: Lens' IPPermission IPProtocol Source #
Network communication protocol used by the fleet.
Instance
Properties that describe an instance of a virtual computing resource that hosts one or more game servers. A fleet contains zero or more instances.
See: instance'
smart constructor.
instance' :: Instance Source #
Creates a value of Instance
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
iCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").iInstanceId
- Unique identifier for the instance.iStatus
- Current status of the instance. Possible statuses include the following: * PENDING – The instance is in the process of being created and launching server processes as defined in the fleet's runtime configuration. * ACTIVE – The instance has been successfully created and at least one server process has successfully launched and reported back to GameLift that it is ready to host a game session. The instance is now considered ready to host game sessions. * TERMINATING – The instance is in the process of shutting down. This may happen to reduce capacity during a scaling down event or to recycle resources in the event of a problem.iIPAddress
- IP address assigned to the instance.iOperatingSystem
- Operating system that is running on this instance.iType
- EC2 instance type that defines the computing resources of this instance.iFleetId
- Unique identifier for the fleet that the instance belongs to.
iCreationTime :: Lens' Instance (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
iStatus :: Lens' Instance (Maybe InstanceStatus) Source #
Current status of the instance. Possible statuses include the following: * PENDING – The instance is in the process of being created and launching server processes as defined in the fleet's runtime configuration. * ACTIVE – The instance has been successfully created and at least one server process has successfully launched and reported back to GameLift that it is ready to host a game session. The instance is now considered ready to host game sessions. * TERMINATING – The instance is in the process of shutting down. This may happen to reduce capacity during a scaling down event or to recycle resources in the event of a problem.
iOperatingSystem :: Lens' Instance (Maybe OperatingSystem) Source #
Operating system that is running on this instance.
iType :: Lens' Instance (Maybe EC2InstanceType) Source #
EC2 instance type that defines the computing resources of this instance.
iFleetId :: Lens' Instance (Maybe Text) Source #
Unique identifier for the fleet that the instance belongs to.
InstanceAccess
data InstanceAccess Source #
Information required to remotely connect to a fleet instance. Access is requested by calling GetInstanceAccess
.
See: instanceAccess
smart constructor.
instanceAccess :: InstanceAccess Source #
Creates a value of InstanceAccess
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
iaInstanceId
- Unique identifier for the instance being accessed.iaIPAddress
- IP address assigned to the instance.iaOperatingSystem
- Operating system that is running on the instance.iaCredentials
- Credentials required to access the instance.iaFleetId
- Unique identifier for the fleet containing the instance being accessed.
iaInstanceId :: Lens' InstanceAccess (Maybe Text) Source #
Unique identifier for the instance being accessed.
iaIPAddress :: Lens' InstanceAccess (Maybe Text) Source #
IP address assigned to the instance.
iaOperatingSystem :: Lens' InstanceAccess (Maybe OperatingSystem) Source #
Operating system that is running on the instance.
iaCredentials :: Lens' InstanceAccess (Maybe InstanceCredentials) Source #
Credentials required to access the instance.
iaFleetId :: Lens' InstanceAccess (Maybe Text) Source #
Unique identifier for the fleet containing the instance being accessed.
InstanceCredentials
data InstanceCredentials Source #
Set of credentials required to remotely access a fleet instance. Access credentials are requested by calling GetInstanceAccess
and returned in an InstanceAccess
object.
See: instanceCredentials
smart constructor.
instanceCredentials :: InstanceCredentials Source #
Creates a value of InstanceCredentials
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
icUserName
- User login string.icSecret
- Secret string. For Windows instances, the secret is a password. For Linux instances, it is a private key.
icUserName :: Lens' InstanceCredentials (Maybe Text) Source #
User login string.
icSecret :: Lens' InstanceCredentials (Maybe Text) Source #
Secret string. For Windows instances, the secret is a password. For Linux instances, it is a private key.
PlayerSession
data PlayerSession Source #
Properties describing a player session.
See: playerSession
smart constructor.
playerSession :: PlayerSession Source #
Creates a value of PlayerSession
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
psCreationTime
- Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").psStatus
- Current status of the player session. Possible player session statuses include the following: * RESERVED – The player session request has been received, but the player has not yet connected to the server process andor been validated. * ACTIVE – The player has been validated by the server process and is currently connected. * COMPLETED – The player connection has been dropped. * TIMEDOUT – A player session request was received, but the player did not connect andor was not validated within the time-out limit (60 seconds).psIPAddress
- Game session IP address. All player sessions reference the game session location.psGameSessionId
- Unique identifier for the game session that the player session is connected to.psTerminationTime
- Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").psPlayerSessionId
- Unique identifier for a player session.psFleetId
- Unique identifier for a fleet.psPlayerId
- Unique identifier for a player.psPort
- Port number for the game session. To connect to a GameLift server process, an app needs both the IP address and port number.
psCreationTime :: Lens' PlayerSession (Maybe UTCTime) Source #
Time stamp indicating when this data object was created. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
psStatus :: Lens' PlayerSession (Maybe PlayerSessionStatus) Source #
Current status of the player session. Possible player session statuses include the following: * RESERVED – The player session request has been received, but the player has not yet connected to the server process andor been validated. * ACTIVE – The player has been validated by the server process and is currently connected. * COMPLETED – The player connection has been dropped. * TIMEDOUT – A player session request was received, but the player did not connect andor was not validated within the time-out limit (60 seconds).
psIPAddress :: Lens' PlayerSession (Maybe Text) Source #
Game session IP address. All player sessions reference the game session location.
psGameSessionId :: Lens' PlayerSession (Maybe Text) Source #
Unique identifier for the game session that the player session is connected to.
psTerminationTime :: Lens' PlayerSession (Maybe UTCTime) Source #
Time stamp indicating when this data object was terminated. Format is a number expressed in Unix time as milliseconds (ex: "1469498468.057").
psPlayerSessionId :: Lens' PlayerSession (Maybe Text) Source #
Unique identifier for a player session.
psPlayerId :: Lens' PlayerSession (Maybe Text) Source #
Unique identifier for a player.
psPort :: Lens' PlayerSession (Maybe Natural) Source #
Port number for the game session. To connect to a GameLift server process, an app needs both the IP address and port number.
ResourceCreationLimitPolicy
data ResourceCreationLimitPolicy Source #
Policy that limits the number of game sessions a player can create on the same fleet. This optional policy gives game owners control over how players can consume available game server resources. A resource creation policy makes the following statement: "An individual player can create a maximum number of new game sessions within a specified time period".
The policy is evaluated when a player tries to create a new game session. For example, with a policy of 10 new game sessions and a time period of 60 minutes, on receiving a CreateGameSession
request, GameLift checks that the player (identified by CreatorId
) has created fewer than 10 game sessions in the past 60 minutes.
See: resourceCreationLimitPolicy
smart constructor.
resourceCreationLimitPolicy :: ResourceCreationLimitPolicy Source #
Creates a value of ResourceCreationLimitPolicy
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rclpNewGameSessionsPerCreator
- Maximum number of game sessions that an individual can create during the policy period.rclpPolicyPeriodInMinutes
- Time span used in evaluating the resource creation limit policy.
rclpNewGameSessionsPerCreator :: Lens' ResourceCreationLimitPolicy (Maybe Natural) Source #
Maximum number of game sessions that an individual can create during the policy period.
rclpPolicyPeriodInMinutes :: Lens' ResourceCreationLimitPolicy (Maybe Natural) Source #
Time span used in evaluating the resource creation limit policy.
RoutingStrategy
data RoutingStrategy Source #
Routing configuration for a fleet alias.
See: routingStrategy
smart constructor.
routingStrategy :: RoutingStrategy Source #
Creates a value of RoutingStrategy
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rsType
- Type of routing strategy. Possible routing types include the following: * SIMPLE – The alias resolves to one specific fleet. Use this type when routing to active fleets. * TERMINAL – The alias does not resolve to a fleet but instead can be used to display a message to the user. A terminal alias throws a TerminalRoutingStrategyException with theRoutingStrategy
message embedded.rsMessage
- Message text to be used with a terminal routing strategy.rsFleetId
- Unique identifier for a fleet.
rsType :: Lens' RoutingStrategy (Maybe RoutingStrategyType) Source #
Type of routing strategy. Possible routing types include the following: * SIMPLE – The alias resolves to one specific fleet. Use this type when routing to active fleets. * TERMINAL – The alias does not resolve to a fleet but instead can be used to display a message to the user. A terminal alias throws a TerminalRoutingStrategyException with the RoutingStrategy
message embedded.
rsMessage :: Lens' RoutingStrategy (Maybe Text) Source #
Message text to be used with a terminal routing strategy.
RuntimeConfiguration
data RuntimeConfiguration Source #
Collection of server process configurations that describe what processes should be run on each instance in a fleet. An instance can launch and maintain multiple server processes based on the runtime configuration; it regularly checks for an updated runtime configuration and starts new server processes to match the latest version.
The key purpose of a runtime configuration with multiple server process configurations is to be able to run more than one kind of game server in a single fleet. You can include configurations for more than one server executable in order to run two or more different programs to run on the same instance. This option might be useful, for example, to run more than one version of your game server on the same fleet. Another option is to specify configurations for the same server executable but with different launch parameters.
A GameLift instance is limited to 50 processes running simultaneously. To calculate the total number of processes specified in a runtime configuration, add the values of the ConcurrentExecutions
parameter for each
object in the runtime configuration.ServerProcess
See: runtimeConfiguration
smart constructor.
runtimeConfiguration :: RuntimeConfiguration Source #
Creates a value of RuntimeConfiguration
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rcServerProcesses
- Collection of server process configurations describing what server processes to run on each instance in a fleet
rcServerProcesses :: Lens' RuntimeConfiguration (Maybe (NonEmpty ServerProcess)) Source #
Collection of server process configurations describing what server processes to run on each instance in a fleet
S3Location
data S3Location Source #
Location in Amazon Simple Storage Service (Amazon S3) where a build's files are stored. This location is assigned in response to a CreateBuild
call, and is always in the same region as the service used to create the build. For more details see the Amazon S3 documentation .
See: s3Location
smart constructor.
s3Location :: S3Location Source #
Creates a value of S3Location
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
slRoleARN :: Lens' S3Location (Maybe Text) Source #
Amazon resource number for the cross-account access role that allows GameLift access to the S3 bucket.
ScalingPolicy
data ScalingPolicy Source #
Rule that controls how a fleet is scaled. Scaling policies are uniquely identified by the combination of name and fleet ID.
See: scalingPolicy
smart constructor.
scalingPolicy :: ScalingPolicy Source #
Creates a value of ScalingPolicy
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
spStatus
- Current status of the scaling policy. The scaling policy is only in force when in anACTIVE
status. * ACTIVE – The scaling policy is currently in force. * UPDATE_REQUESTED – A request to update the scaling policy has been received. * UPDATING – A change is being made to the scaling policy. * DELETE_REQUESTED – A request to delete the scaling policy has been received. * DELETING – The scaling policy is being deleted. * DELETED – The scaling policy has been deleted. * ERROR – An error occurred in creating the policy. It should be removed and recreated.spScalingAdjustmentType
- Type of adjustment to make to a fleet's instance count (seeFleetCapacity
): * ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down. * ExactCapacity – set the instance count to the scaling adjustment value. * PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.spEvaluationPeriods
- Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.spMetricName
- Name of the GameLift-defined metric that is used to trigger an adjustment. * ActivatingGameSessions – number of game sessions in the process of being created (game session status =ACTIVATING
). * ActiveGameSessions – number of game sessions currently running (game session status =ACTIVE
). * CurrentPlayerSessions – number of active or reserved player sessions (player session status =ACTIVE
orRESERVED
). * AvailablePlayerSessions – number of player session slots currently available in active game sessions across the fleet, calculated by subtracting a game session's current player session count from its maximum player session count. This number does include game sessions that are not currently accepting players (game sessionPlayerSessionCreationPolicy
=DENY_ALL
). * ActiveInstances – number of instances currently running a game session. * IdleInstances – number of instances not currently running a game session.spComparisonOperator
- Comparison operator to use when measuring a metric against the threshold value.spName
- Descriptive label associated with a scaling policy. Policy names do not need to be unique.spThreshold
- Metric value used to trigger a scaling event.spScalingAdjustment
- Amount of adjustment to make, based on the scaling adjustment type.spFleetId
- Unique identity for the fleet associated with this scaling policy.
spStatus :: Lens' ScalingPolicy (Maybe ScalingStatusType) Source #
Current status of the scaling policy. The scaling policy is only in force when in an ACTIVE
status. * ACTIVE – The scaling policy is currently in force. * UPDATE_REQUESTED – A request to update the scaling policy has been received. * UPDATING – A change is being made to the scaling policy. * DELETE_REQUESTED – A request to delete the scaling policy has been received. * DELETING – The scaling policy is being deleted. * DELETED – The scaling policy has been deleted. * ERROR – An error occurred in creating the policy. It should be removed and recreated.
spScalingAdjustmentType :: Lens' ScalingPolicy (Maybe ScalingAdjustmentType) Source #
Type of adjustment to make to a fleet's instance count (see FleetCapacity
): * ChangeInCapacity – add (or subtract) the scaling adjustment value from the current instance count. Positive values scale up while negative values scale down. * ExactCapacity – set the instance count to the scaling adjustment value. * PercentChangeInCapacity – increase or reduce the current instance count by the scaling adjustment, read as a percentage. Positive values scale up while negative values scale down.
spEvaluationPeriods :: Lens' ScalingPolicy (Maybe Natural) Source #
Length of time (in minutes) the metric must be at or beyond the threshold before a scaling event is triggered.
spMetricName :: Lens' ScalingPolicy (Maybe MetricName) Source #
Name of the GameLift-defined metric that is used to trigger an adjustment. * ActivatingGameSessions – number of game sessions in the process of being created (game session status = ACTIVATING
). * ActiveGameSessions – number of game sessions currently running (game session status = ACTIVE
). * CurrentPlayerSessions – number of active or reserved player sessions (player session status = ACTIVE
or RESERVED
). * AvailablePlayerSessions – number of player session slots currently available in active game sessions across the fleet, calculated by subtracting a game session's current player session count from its maximum player session count. This number does include game sessions that are not currently accepting players (game session PlayerSessionCreationPolicy
= DENY_ALL
). * ActiveInstances – number of instances currently running a game session. * IdleInstances – number of instances not currently running a game session.
spComparisonOperator :: Lens' ScalingPolicy (Maybe ComparisonOperatorType) Source #
Comparison operator to use when measuring a metric against the threshold value.
spName :: Lens' ScalingPolicy (Maybe Text) Source #
Descriptive label associated with a scaling policy. Policy names do not need to be unique.
spThreshold :: Lens' ScalingPolicy (Maybe Double) Source #
Metric value used to trigger a scaling event.
spScalingAdjustment :: Lens' ScalingPolicy (Maybe Int) Source #
Amount of adjustment to make, based on the scaling adjustment type.
spFleetId :: Lens' ScalingPolicy (Maybe Text) Source #
Unique identity for the fleet associated with this scaling policy.
ServerProcess
data ServerProcess Source #
A set of instructions for launching server processes on each instance in a fleet. Each instruction set identifies the location of the server executable, optional launch parameters, and the number of server processes with this configuration to maintain concurrently on the instance. Server process configurations make up a fleet's
.RuntimeConfiguration
See: serverProcess
smart constructor.
Creates a value of ServerProcess
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
spParameters
- Optional list of parameters to pass to the server executable on launch.spLaunchPath
- Location of the server executable in a game build. All game builds are installed on instances at the root : for Windows instancesC:game
, and for Linux instanceslocalgame
. A Windows game build with an executable file located atMyGamelatestserver.exe
must have a launch path of "C:gameMyGamelatestserver.exe
". A Linux game build with an executable file located atMyGamelatestserver.exe
must have a launch path of "localgameMyGamelatest/server.exe
".spConcurrentExecutions
- Number of server processes using this configuration to run concurrently on an instance.
spParameters :: Lens' ServerProcess (Maybe Text) Source #
Optional list of parameters to pass to the server executable on launch.
spLaunchPath :: Lens' ServerProcess Text Source #
Location of the server executable in a game build. All game builds are installed on instances at the root : for Windows instances C:game
, and for Linux instances localgame
. A Windows game build with an executable file located at MyGamelatestserver.exe
must have a launch path of "C:gameMyGamelatestserver.exe
". A Linux game build with an executable file located at MyGamelatestserver.exe
must have a launch path of "localgameMyGamelatest/server.exe
".
spConcurrentExecutions :: Lens' ServerProcess Natural Source #
Number of server processes using this configuration to run concurrently on an instance.