Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
__This operation is used with the GameLift FleetIQ solution and game server groups.__
Creates a new game server resource and notifies GameLift FleetIQ that the game server is ready to host gameplay and players. This operation is called by a game server process that is running on an instance in a game server group. Registering game servers enables GameLift FleetIQ to track available game servers and enables game clients and services to claim a game server for a new game session.
To register a game server, identify the game server group and instance where the game server is running, and provide a unique identifier for the game server. You can also include connection and game server data.
Once a game server is successfully registered, it is put in status
AVAILABLE
. A request to register a game server may fail if the
instance it is running on is in the process of shutting down as part of
instance balancing or scale-down activity.
Learn more
Synopsis
- data RegisterGameServer = RegisterGameServer' {}
- newRegisterGameServer :: Text -> Text -> Text -> RegisterGameServer
- registerGameServer_connectionInfo :: Lens' RegisterGameServer (Maybe Text)
- registerGameServer_gameServerData :: Lens' RegisterGameServer (Maybe Text)
- registerGameServer_gameServerGroupName :: Lens' RegisterGameServer Text
- registerGameServer_gameServerId :: Lens' RegisterGameServer Text
- registerGameServer_instanceId :: Lens' RegisterGameServer Text
- data RegisterGameServerResponse = RegisterGameServerResponse' {}
- newRegisterGameServerResponse :: Int -> RegisterGameServerResponse
- registerGameServerResponse_gameServer :: Lens' RegisterGameServerResponse (Maybe GameServer)
- registerGameServerResponse_httpStatus :: Lens' RegisterGameServerResponse Int
Creating a Request
data RegisterGameServer Source #
See: newRegisterGameServer
smart constructor.
RegisterGameServer' | |
|
Instances
newRegisterGameServer Source #
Create a value of RegisterGameServer
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:
RegisterGameServer
, registerGameServer_connectionInfo
- Information that is needed to make inbound client connections to the
game server. This might include the IP address and port, DNS name, and
other information.
RegisterGameServer
, registerGameServer_gameServerData
- A set of custom game server properties, formatted as a single string
value. This data is passed to a game client or service when it requests
information on game servers.
RegisterGameServer
, registerGameServer_gameServerGroupName
- A unique identifier for the game server group where the game server is
running.
RegisterGameServer
, registerGameServer_gameServerId
- A custom string that uniquely identifies the game server to register.
Game server IDs are developer-defined and must be unique across all game
server groups in your Amazon Web Services account.
RegisterGameServer
, registerGameServer_instanceId
- The unique identifier for the instance where the game server is running.
This ID is available in the instance metadata. EC2 instance IDs use a
17-character format, for example: i-1234567890abcdef0
.
Request Lenses
registerGameServer_connectionInfo :: Lens' RegisterGameServer (Maybe Text) Source #
Information that is needed to make inbound client connections to the game server. This might include the IP address and port, DNS name, and other information.
registerGameServer_gameServerData :: Lens' RegisterGameServer (Maybe Text) Source #
A set of custom game server properties, formatted as a single string value. This data is passed to a game client or service when it requests information on game servers.
registerGameServer_gameServerGroupName :: Lens' RegisterGameServer Text Source #
A unique identifier for the game server group where the game server is running.
registerGameServer_gameServerId :: Lens' RegisterGameServer Text Source #
A custom string that uniquely identifies the game server to register. Game server IDs are developer-defined and must be unique across all game server groups in your Amazon Web Services account.
registerGameServer_instanceId :: Lens' RegisterGameServer Text Source #
The unique identifier for the instance where the game server is running.
This ID is available in the instance metadata. EC2 instance IDs use a
17-character format, for example: i-1234567890abcdef0
.
Destructuring the Response
data RegisterGameServerResponse Source #
See: newRegisterGameServerResponse
smart constructor.
RegisterGameServerResponse' | |
|
Instances
newRegisterGameServerResponse Source #
Create a value of RegisterGameServerResponse
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:gameServer:RegisterGameServerResponse'
, registerGameServerResponse_gameServer
- Object that describes the newly registered game server.
$sel:httpStatus:RegisterGameServerResponse'
, registerGameServerResponse_httpStatus
- The response's http status code.
Response Lenses
registerGameServerResponse_gameServer :: Lens' RegisterGameServerResponse (Maybe GameServer) Source #
Object that describes the newly registered game server.
registerGameServerResponse_httpStatus :: Lens' RegisterGameServerResponse Int Source #
The response's http status code.