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.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginUpdateGameServer and EndUpdateGameServer.
public abstract Task<UpdateGameServerResponse> UpdateGameServerAsync( UpdateGameServerRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the UpdateGameServer service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
|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||THe requested resources was not found. The resource was either not created yet or deleted.|
|UnauthorizedException||The client failed authentication. Clients should not retry such requests.|
.NET Core App:
Supported in: 3.1
Supported in: 2.0
Supported in: 4.5