Skip to content

/AWS1/CL_GMLPRIORITYCONF

Custom prioritization settings to use with a game session queue. Prioritization settings determine how the queue selects a game hosting resource to start a new game session. This configuration replaces the default prioritization process for queues.

By default, a queue makes game session placements based on the following criteria:

  • When a game session request does not include player latency data, Amazon GameLift Servers places game sessions based on the following priorities: (1) the queue's default destination order, and (2) for multi-location fleets, an alphabetic list of locations.

  • When a game session request includes player latency data, Amazon GameLift Servers re-orders the queue's destinations to make placements where the average player latency is lowest. It reorders based the following priorities: (1) the lowest average latency across all players, (2) the lowest hosting cost, (3) the queue's default destination order, and (4) for multi-location fleets, an alphabetic list of locations.

CONSTRUCTOR

IMPORTING

Optional arguments:

it_priorityorder TYPE /AWS1/CL_GMLPRIORITYTYPELIST_W=>TT_PRIORITYTYPELIST TT_PRIORITYTYPELIST

A custom sequence to use when prioritizing where to place new game sessions. Each priority type is listed once.

  • LATENCY -- Amazon GameLift Servers prioritizes locations where the average player latency is lowest. Player latency data is provided in each game session placement request.

  • COST -- Amazon GameLift Servers prioritizes queue destinations with the lowest current hosting costs. Cost is evaluated based on the destination's location, instance type, and fleet type (Spot or On-Demand).

  • DESTINATION -- Amazon GameLift Servers prioritizes based on the list order of destinations in the queue configuration.

  • LOCATION -- Amazon GameLift Servers prioritizes based on the provided order of locations, as defined in LocationOrder.

it_locationorder TYPE /AWS1/CL_GMLLOCATIONLIST_W=>TT_LOCATIONLIST TT_LOCATIONLIST

The prioritization order to use for fleet locations, when the PriorityOrder property includes LOCATION. Locations can include Amazon Web Services Region codes (such as us-west-2), local zones, and custom locations (for Anywhere fleets). Each location must be listed only once. For details, see Amazon GameLift Servers service locations.

Queryable Attributes

PriorityOrder

A custom sequence to use when prioritizing where to place new game sessions. Each priority type is listed once.

  • LATENCY -- Amazon GameLift Servers prioritizes locations where the average player latency is lowest. Player latency data is provided in each game session placement request.

  • COST -- Amazon GameLift Servers prioritizes queue destinations with the lowest current hosting costs. Cost is evaluated based on the destination's location, instance type, and fleet type (Spot or On-Demand).

  • DESTINATION -- Amazon GameLift Servers prioritizes based on the list order of destinations in the queue configuration.

  • LOCATION -- Amazon GameLift Servers prioritizes based on the provided order of locations, as defined in LocationOrder.

Accessible with the following methods

Method Description
GET_PRIORITYORDER() Getter for PRIORITYORDER, with configurable default
ASK_PRIORITYORDER() Getter for PRIORITYORDER w/ exceptions if field has no value
HAS_PRIORITYORDER() Determine if PRIORITYORDER has a value

LocationOrder

The prioritization order to use for fleet locations, when the PriorityOrder property includes LOCATION. Locations can include Amazon Web Services Region codes (such as us-west-2), local zones, and custom locations (for Anywhere fleets). Each location must be listed only once. For details, see Amazon GameLift Servers service locations.

Accessible with the following methods

Method Description
GET_LOCATIONORDER() Getter for LOCATIONORDER, with configurable default
ASK_LOCATIONORDER() Getter for LOCATIONORDER w/ exceptions if field has no value
HAS_LOCATIONORDER() Determine if LOCATIONORDER has a value