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

Properties for a new Fleet gameSessionQueue.

Used as props by: [GameSessionQueue](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-gamelift-alpha.GameSessionQueue.html)

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

## Example

TypeScript:

```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);
```

Python:

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

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

Java:

```java
BuildFleet fleet;
Alias alias;

GameSessionQueue queue = GameSessionQueue.Builder.create(this, "GameSessionQueue")
        .gameSessionQueueName("my-queue-name")
        .destinations(List.of(fleet))
        .build();
queue.addDestination(alias);
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.GameLift.Alpha
BuildFleet fleet;
Alias alias;

var queue = new GameSessionQueue(this, "GameSessionQueue", new GameSessionQueueProps {
    GameSessionQueueName = "my-queue-name",
    Destinations = new [] { fleet }
});
queue.AddDestination(alias);
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdkgameliftalpha/v2
var fleet BuildFleet
var alias Alias

queue := gamelift.NewGameSessionQueue(this, jsii.String("GameSessionQueue"), &GameSessionQueueProps{
	GameSessionQueueName: jsii.String("my-queue-name"),
	Destinations: []IGameSessionQueueDestination{
		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](https://docs.aws.amazon.com/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](https://docs.aws.amazon.com/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](https://docs.aws.amazon.com/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](https://docs.aws.amazon.com/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](https://docs.aws.amazon.com/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.
