> **Experimental**
>
> `@aws-cdk/aws-gamelift-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# GameSessionQueueProps

Properties for a new Fleet gameSessionQueue.

Extends: GameSessionQueueProps
Used as props by: GameSessionQueue

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/game-session-queue.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0-alpha.0/packages/@aws-cdk/aws-gamelift-alpha/lib/game-session-queue.ts#L177)

## Example

```ts
declare const fleet: gamelift.BuildFleet;
declare const alias: gamelift.Alias;

const queue = new gamelift.GameSessionQueue(this, 'GameSessionQueue', {
  gameSessionQueueName: 'my-queue-name',
  destinations: [fleet]
});
queue.addDestination(alias);
```

## Properties

- `allowedLocations`: string[] — A list of locations where a queue is allowed to place new game sessions.

  **Default:** game sessions can be placed in any queue location

  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.

- `customEventData`: string — Information to be added to all events that are related to this game session queue.

  **Default:** no customer event data

- `destinations`: [IGameSessionQueueDestination](/cdk/api/v2/docs/@aws-cdk_aws-gamelift-alpha.IGameSessionQueueDestination.html)[] (required) — 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.

- `gameSessionQueueName`: string (required) — Name of this gameSessionQueue.

- `notificationTarget`: [ITopic](/cdk/api/v2/docs/aws-cdk-lib.aws_sns.ITopic.html) — An SNS topic is set up to receive game session placement notifications.

  **Default:** no notification

- `playerLatencyPolicies`: [PlayerLatencyPolicy](/cdk/api/v2/docs/@aws-cdk_aws-gamelift-alpha.PlayerLatencyPolicy.html)[] — A set of policies that act as a sliding cap on player latency.

  **Default:** no player latency policy

  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.

- `priorityConfiguration`: [PriorityConfiguration](/cdk/api/v2/docs/@aws-cdk_aws-gamelift-alpha.PriorityConfiguration.html) — Custom settings to use when prioritizing destinations and locations for game session placements.

  **Default:** no priority configuration

  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.

- `timeout`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum time, that a new game session placement request remains in the queue.

  **Default:** 50 seconds

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