AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
This operation is used with the GameLift FleetIQ solution and game server groups.
Updates information about a registered game server to help GameLift FleetIQ to track game server availability. This operation is called by a game server process that is running on an instance in a game server group.
Use this operation to update the following types of game server information. You can make all three types of updates in the same request:
To update the game server's utilization status, identify the game server and game server group and specify the current utilization status. Use this status to identify when game servers are currently hosting games and when they are available to be claimed.
To report health status, identify the game server and game server group and set health
HEALTHY. If a game server does not report health status for
a certain length of time, the game server is no longer considered healthy. As a result,
it will be eventually deregistered from the game server group to avoid affecting utilization
metrics. The best practice is to report health every 60 seconds.
To change game server metadata, provide updated game server data.
Once a game server is successfully updated, the relevant statuses and timestamps are updated.
For .NET Core this operation is only available in asynchronous form. Please refer to UpdateGameServerAsync.
public abstract UpdateGameServerResponse UpdateGameServer( UpdateGameServerRequest request )
Container for the necessary parameters to execute the UpdateGameServer service method.
|InternalServiceException||The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period.|
|InvalidRequestException||One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying.|
|NotFoundException||A service resource associated with the request could not be found. Clients should not retry such requests.|
|UnauthorizedException||The client failed authentication. Clients should not retry such requests.|
Supported in: 4.5, 4.0, 3.5