Creates an alias for a fleet. In most situations, you can use an alias ID in place of a fleet ID. By using a fleet alias instead of a specific fleet ID, you can switch gameplay and players to a new fleet without changing your game client or other game components. For example, for games in production, using an alias allows you to seamlessly redirect your player base to a new game server update.
Amazon GameLift supports two types of routing strategies for aliases: simple and terminal. A simple alias points to an active fleet. A terminal alias is used to display messaging or link to a URL instead of routing players to an active fleet. For example, you might use a terminal alias when a game version is no longer supported and you want to direct players to an upgrade site.
To create a fleet alias, specify an alias name, routing strategy, and optional description.
Each simple alias can point to only one fleet, but a fleet can have multiple aliases.
If successful, a new alias record is returned, including an alias ID, which you can
reference when creating a game session. You can reassign an alias to another fleet
Alias-related operations include:
For PCL this operation is only available in asynchronous form. Please refer to CreateAliasAsync.
public abstract CreateAliasResponse CreateAlias( CreateAliasRequest request )
Container for the necessary parameters to execute the CreateAlias 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.|
|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.|
|LimitExceededException||The requested operation would cause the resource to exceed the allowed service limit. Resolve the issue before retrying.|
|UnauthorizedException||The client failed authentication. Clients should not retry such requests.|
Supported in: 4.5, 4.0, 3.5
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms