GameSessionQueueProps

class aws_cdk.aws_gamelift_alpha.GameSessionQueueProps(*, destinations, game_session_queue_name, allowed_locations=None, custom_event_data=None, notification_target=None, player_latency_policies=None, priority_configuration=None, timeout=None)

Bases: object

(experimental) Properties for a new Fleet gameSessionQueue.

Parameters:

destinations (Sequence[IGameSessionQueueDestination]) – (experimental) A list of fleets and/or fleet alias that can be used to fulfill game session placement requests in the queue. Destinations are listed in order of placement preference.
game_session_queue_name (str) – (experimental) Name of this gameSessionQueue.
allowed_locations (Optional[Sequence[str]]) – (experimental) A list of locations where a queue is allowed to place new game sessions. Locations are specified in the form of AWS Region codes, such as us-west-2. For queues that have multi-location fleets, you can use a filter configuration allow placement with some, but not all of these locations. Default: game sessions can be placed in any queue location
custom_event_data (Optional[str]) – (experimental) Information to be added to all events that are related to this game session queue. Default: no customer event data
notification_target (Optional[ITopic]) – (experimental) An SNS topic is set up to receive game session placement notifications. Default: no notification
player_latency_policies (Optional[Sequence[Union[PlayerLatencyPolicy, Dict[str, Any]]]]) – (experimental) A set of policies that act as a sliding cap on player latency. FleetIQ works to deliver low latency for most players in a game session. These policies ensure that no individual player can be placed into a game with unreasonably high latency. Use multiple policies to gradually relax latency requirements a step at a time. Multiple policies are applied based on their maximum allowed latency, starting with the lowest value. Default: no player latency policy
priority_configuration (Union[PriorityConfiguration, Dict[str, Any], None]) – (experimental) Custom settings to use when prioritizing destinations and locations for game session placements. This configuration replaces the FleetIQ default prioritization process. Priority types that are not explicitly named will be automatically applied at the end of the prioritization process. Default: no priority configuration
timeout (Optional[Duration]) – (experimental) The maximum time, that a new game session placement request remains in the queue. When a request exceeds this time, the game session placement changes to a TIMED_OUT status. Default: 50 seconds

Stability:

experimental

ExampleMetadata:

infused

Example:

# fleet: gamelift.BuildFleet
# alias: gamelift.Alias


queue = gamelift.GameSessionQueue(self, "GameSessionQueue",
    game_session_queue_name="my-queue-name",
    destinations=[fleet]
)
queue.add_destination(alias)

Attributes

allowed_locations

(experimental) A list of locations where a queue is allowed to place new game sessions.

Locations are specified in the form of AWS Region codes, such as us-west-2.

For queues that have multi-location fleets, you can use a filter configuration allow placement with some, but not all of these locations.

Default:: game sessions can be placed in any queue location
Stability:: experimental

custom_event_data

(experimental) Information to be added to all events that are related to this game session queue.

Default:: no customer event data
Stability:: experimental

destinations

(experimental) A list of fleets and/or fleet alias that can be used to fulfill game session placement requests in the queue.

Destinations are listed in order of placement preference.

Stability:: experimental

game_session_queue_name

(experimental) Name of this gameSessionQueue.

Stability:: experimental

notification_target

(experimental) An SNS topic is set up to receive game session placement notifications.

Default:: no notification
See:: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
Stability:: experimental

player_latency_policies

(experimental) A set of policies that act as a sliding cap on player latency.

FleetIQ works to deliver low latency for most players in a game session. These policies ensure that no individual player can be placed into a game with unreasonably high latency. Use multiple policies to gradually relax latency requirements a step at a time. Multiple policies are applied based on their maximum allowed latency, starting with the lowest value.

Default:: no player latency policy
Stability:: experimental

priority_configuration

(experimental) Custom settings to use when prioritizing destinations and locations for game session placements.

This configuration replaces the FleetIQ default prioritization process.

Priority types that are not explicitly named will be automatically applied at the end of the prioritization process.

Default:: no priority configuration
Stability:: experimental

timeout

(experimental) The maximum time, that a new game session placement request remains in the queue.

When a request exceeds this time, the game session placement changes to a TIMED_OUT status.

Default:: 50 seconds
Stability:: experimental