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.
Creates a multiplayer game session for players. This action creates a game session
record and assigns an available server process in the specified fleet to host the
game session. A fleet must have an
ACTIVE status before a game session
can be created in it.
To create a game session, specify either fleet ID or alias ID and indicate a maximum number of players to allow in the game session. You can also provide a name and game-specific properties for this game session. If successful, a GameSession object is returned containing the game session properties and other settings you specified.
Idempotency tokens. You can add a token that uniquely identifies game session requests. This is useful for ensuring that game session requests are idempotent. Multiple requests with the same idempotency token are processed only once; subsequent requests return the original result. All response values are the same with the exception of game session status, which may change.
Resource creation limits. If you are creating a game session on a fleet with a resource creation limit policy in force, then you must specify a creator ID. Without this ID, Amazon GameLift has no way to evaluate the policy for this new game session request.
Player acceptance policy. By default, newly created game sessions are open to new players. You can restrict new player access by using UpdateGameSession to change the game session's player session creation policy.
Game session logs. Logs are retained for all active game sessions for 14 days. To access the logs, call GetGameSessionLogUrl to download the log files.
Available in Amazon GameLift Local.
Game-session-related operations include:
Game session placements
For .NET Core and PCL this operation is only available in asynchronous form. Please refer to CreateGameSessionAsync.
public virtual CreateGameSessionResponse CreateGameSession( CreateGameSessionRequest request )
Container for the necessary parameters to execute the CreateGameSession service method.
|ConflictException||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.|
|FleetCapacityExceededException||The specified fleet has no available instances to fulfill a CreateGameSession request. Clients can retry such requests immediately or after a waiting period.|
|IdempotentParameterMismatchException||A game session with this custom ID string already exists in this fleet. Resolve this conflict before retrying this request.|
|InternalServiceException||The service encountered an unrecoverable internal failure while processing the request. Clients can retry such requests immediately or after a waiting period.|
|InvalidFleetStatusException||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||One or more parameter values in the request are invalid. Correct the invalid parameter values before retrying.|
|LimitExceededException||The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue before retrying.|
|NotFoundException||A service resource associated with the request could not be found. Clients should not retry such requests.|
|TerminalRoutingStrategyException||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.|
|UnauthorizedException||The client failed authentication. Clients should not retry such requests.|
Supported in: 4.5, 4.0, 3.5
Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms