@aws-cdk/aws-gamelift-alpha 2.53.0-alpha.0 → 2.55.0-alpha.0

package/.warnings.jsii.js

@@ -1,3 +1,25 @@
+function _aws_cdk_aws_gamelift_alpha_IAlias(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_AliasOptions(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_AliasAttributes(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_AliasProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.fleet))
+            _aws_cdk_aws_gamelift_alpha_IFleet(p.fleet);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_gamelift_alpha_AliasBase(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_Alias(p) {
+}
 function _aws_cdk_aws_gamelift_alpha_Content(p) {
 }
 function _aws_cdk_aws_gamelift_alpha_ContentConfig(p) {
@@ -204,6 +226,94 @@ function _aws_cdk_aws_gamelift_alpha_BuildFleetProps(p) {
 }
 function _aws_cdk_aws_gamelift_alpha_BuildFleet(p) {
 }
+function _aws_cdk_aws_gamelift_alpha_IGameSessionQueueDestination(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_PriorityType(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_PriorityConfiguration(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (p.priorityOrder != null)
+            for (const o of p.priorityOrder)
+                if (!visitedObjects.has(o))
+                    _aws_cdk_aws_gamelift_alpha_PriorityType(o);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_gamelift_alpha_PlayerLatencyPolicy(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_IGameSessionQueue(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_GameSessionQueueAttributes(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_GameSessionQueueProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (p.destinations != null)
+            for (const o of p.destinations)
+                if (!visitedObjects.has(o))
+                    _aws_cdk_aws_gamelift_alpha_IGameSessionQueueDestination(o);
+        if (p.playerLatencyPolicies != null)
+            for (const o of p.playerLatencyPolicies)
+                if (!visitedObjects.has(o))
+                    _aws_cdk_aws_gamelift_alpha_PlayerLatencyPolicy(o);
+        if (!visitedObjects.has(p.priorityConfiguration))
+            _aws_cdk_aws_gamelift_alpha_PriorityConfiguration(p.priorityConfiguration);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_gamelift_alpha_GameSessionQueueBase(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_GameSessionQueue(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_IMatchmakingRuleSet(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.content))
+            _aws_cdk_aws_gamelift_alpha_RuleSetContent(p.content);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetAttributes(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetBase(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSet(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_IRuleSetBody(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_RuleSetBodyConfig(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_IRuleSetContent(p) {
+}
+function _aws_cdk_aws_gamelift_alpha_RuleSetContentProps(p) {
+    if (p == null)
+        return;
+    visitedObjects.add(p);
+    try {
+        if (!visitedObjects.has(p.content))
+            _aws_cdk_aws_gamelift_alpha_IRuleSetBody(p.content);
+    }
+    finally {
+        visitedObjects.delete(p);
+    }
+}
+function _aws_cdk_aws_gamelift_alpha_RuleSetContent(p) {
+}
 function print(name, deprecationMessage) {
     const deprecated = process.env.JSII_DEPRECATED;
     const deprecationMode = ["warn", "fail", "quiet"].includes(deprecated) ? deprecated : "warn";
@@ -240,4 +350,4 @@ class DeprecationError extends Error {
         });
     }
 }
-module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_gamelift_alpha_Content, _aws_cdk_aws_gamelift_alpha_ContentConfig, _aws_cdk_aws_gamelift_alpha_S3Content, _aws_cdk_aws_gamelift_alpha_AssetContent, _aws_cdk_aws_gamelift_alpha_IBuild, _aws_cdk_aws_gamelift_alpha_BuildBase, _aws_cdk_aws_gamelift_alpha_OperatingSystem, _aws_cdk_aws_gamelift_alpha_BuildAttributes, _aws_cdk_aws_gamelift_alpha_BuildProps, _aws_cdk_aws_gamelift_alpha_Build, _aws_cdk_aws_gamelift_alpha_IScript, _aws_cdk_aws_gamelift_alpha_ScriptBase, _aws_cdk_aws_gamelift_alpha_ScriptAttributes, _aws_cdk_aws_gamelift_alpha_ScriptProps, _aws_cdk_aws_gamelift_alpha_Script, _aws_cdk_aws_gamelift_alpha_AutoScalingPolicy, _aws_cdk_aws_gamelift_alpha_InstanceDefinition, _aws_cdk_aws_gamelift_alpha_DeleteOption, _aws_cdk_aws_gamelift_alpha_BalancingStrategy, _aws_cdk_aws_gamelift_alpha_IGameServerGroup, _aws_cdk_aws_gamelift_alpha_GameServerGroupBase, _aws_cdk_aws_gamelift_alpha_GameServerGroupAttributes, _aws_cdk_aws_gamelift_alpha_GameServerGroupProps, _aws_cdk_aws_gamelift_alpha_GameServerGroup, _aws_cdk_aws_gamelift_alpha_Protocol, _aws_cdk_aws_gamelift_alpha_PortProps, _aws_cdk_aws_gamelift_alpha_Port, _aws_cdk_aws_gamelift_alpha_IPeer, _aws_cdk_aws_gamelift_alpha_Peer, _aws_cdk_aws_gamelift_alpha_IngressRule, _aws_cdk_aws_gamelift_alpha_LocationCapacity, _aws_cdk_aws_gamelift_alpha_Location, _aws_cdk_aws_gamelift_alpha_ServerProcess, _aws_cdk_aws_gamelift_alpha_RuntimeConfiguration, _aws_cdk_aws_gamelift_alpha_ResourceCreationLimitPolicy, _aws_cdk_aws_gamelift_alpha_IFleet, _aws_cdk_aws_gamelift_alpha_FleetProps, _aws_cdk_aws_gamelift_alpha_FleetAttributes, _aws_cdk_aws_gamelift_alpha_FleetBase, _aws_cdk_aws_gamelift_alpha_IBuildFleet, _aws_cdk_aws_gamelift_alpha_BuildFleetProps, _aws_cdk_aws_gamelift_alpha_BuildFleet };
+module.exports = { print, getPropertyDescriptor, DeprecationError, _aws_cdk_aws_gamelift_alpha_IAlias, _aws_cdk_aws_gamelift_alpha_AliasOptions, _aws_cdk_aws_gamelift_alpha_AliasAttributes, _aws_cdk_aws_gamelift_alpha_AliasProps, _aws_cdk_aws_gamelift_alpha_AliasBase, _aws_cdk_aws_gamelift_alpha_Alias, _aws_cdk_aws_gamelift_alpha_Content, _aws_cdk_aws_gamelift_alpha_ContentConfig, _aws_cdk_aws_gamelift_alpha_S3Content, _aws_cdk_aws_gamelift_alpha_AssetContent, _aws_cdk_aws_gamelift_alpha_IBuild, _aws_cdk_aws_gamelift_alpha_BuildBase, _aws_cdk_aws_gamelift_alpha_OperatingSystem, _aws_cdk_aws_gamelift_alpha_BuildAttributes, _aws_cdk_aws_gamelift_alpha_BuildProps, _aws_cdk_aws_gamelift_alpha_Build, _aws_cdk_aws_gamelift_alpha_IScript, _aws_cdk_aws_gamelift_alpha_ScriptBase, _aws_cdk_aws_gamelift_alpha_ScriptAttributes, _aws_cdk_aws_gamelift_alpha_ScriptProps, _aws_cdk_aws_gamelift_alpha_Script, _aws_cdk_aws_gamelift_alpha_AutoScalingPolicy, _aws_cdk_aws_gamelift_alpha_InstanceDefinition, _aws_cdk_aws_gamelift_alpha_DeleteOption, _aws_cdk_aws_gamelift_alpha_BalancingStrategy, _aws_cdk_aws_gamelift_alpha_IGameServerGroup, _aws_cdk_aws_gamelift_alpha_GameServerGroupBase, _aws_cdk_aws_gamelift_alpha_GameServerGroupAttributes, _aws_cdk_aws_gamelift_alpha_GameServerGroupProps, _aws_cdk_aws_gamelift_alpha_GameServerGroup, _aws_cdk_aws_gamelift_alpha_Protocol, _aws_cdk_aws_gamelift_alpha_PortProps, _aws_cdk_aws_gamelift_alpha_Port, _aws_cdk_aws_gamelift_alpha_IPeer, _aws_cdk_aws_gamelift_alpha_Peer, _aws_cdk_aws_gamelift_alpha_IngressRule, _aws_cdk_aws_gamelift_alpha_LocationCapacity, _aws_cdk_aws_gamelift_alpha_Location, _aws_cdk_aws_gamelift_alpha_ServerProcess, _aws_cdk_aws_gamelift_alpha_RuntimeConfiguration, _aws_cdk_aws_gamelift_alpha_ResourceCreationLimitPolicy, _aws_cdk_aws_gamelift_alpha_IFleet, _aws_cdk_aws_gamelift_alpha_FleetProps, _aws_cdk_aws_gamelift_alpha_FleetAttributes, _aws_cdk_aws_gamelift_alpha_FleetBase, _aws_cdk_aws_gamelift_alpha_IBuildFleet, _aws_cdk_aws_gamelift_alpha_BuildFleetProps, _aws_cdk_aws_gamelift_alpha_BuildFleet, _aws_cdk_aws_gamelift_alpha_IGameSessionQueueDestination, _aws_cdk_aws_gamelift_alpha_PriorityType, _aws_cdk_aws_gamelift_alpha_PriorityConfiguration, _aws_cdk_aws_gamelift_alpha_PlayerLatencyPolicy, _aws_cdk_aws_gamelift_alpha_IGameSessionQueue, _aws_cdk_aws_gamelift_alpha_GameSessionQueueAttributes, _aws_cdk_aws_gamelift_alpha_GameSessionQueueProps, _aws_cdk_aws_gamelift_alpha_GameSessionQueueBase, _aws_cdk_aws_gamelift_alpha_GameSessionQueue, _aws_cdk_aws_gamelift_alpha_IMatchmakingRuleSet, _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetProps, _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetAttributes, _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSetBase, _aws_cdk_aws_gamelift_alpha_MatchmakingRuleSet, _aws_cdk_aws_gamelift_alpha_IRuleSetBody, _aws_cdk_aws_gamelift_alpha_RuleSetBodyConfig, _aws_cdk_aws_gamelift_alpha_IRuleSetContent, _aws_cdk_aws_gamelift_alpha_RuleSetContentProps, _aws_cdk_aws_gamelift_alpha_RuleSetContent };

package/README.md

@@ -44,6 +44,73 @@ deliver inexpensive, resilient game hosting for your players
 This module is part of the [AWS Cloud Development Kit](https://github.com/aws/aws-cdk) project. It allows you to define components for your matchmaking
 configuration or game server fleet management system.
 
+## GameLift FlexMatch
+
+### Matchmaking RuleSet
+
+Every FlexMatch matchmaker must have a rule set. The rule set determines the
+two key elements of a match: your game's team structure and size, and how to
+group players together for the best possible match.
+
+For example, a rule set might describe a match like this: Create a match with
+two teams of four to eight players each, one team is the cowboy and the other
+team the aliens. A team can have novice and experienced players, but the
+average skill of the two teams must be within 10 points of each other. If no
+match is made after 30 seconds, gradually relax the skill requirements.
+
+```ts
+new gamelift.MatchmakingRuleSet(this, 'RuleSet', {
+  matchmakingRuleSetName: 'my-test-ruleset',
+  content: gamelift.RuleSetContent.fromJsonFile(path.join(__dirname, 'my-ruleset/ruleset.json')),
+});
+```
+
+### FlexMatch Monitoring
+
+You can monitor GameLift FlexMatch activity for matchmaking configurations and
+matchmaking rules using Amazon CloudWatch. These statistics are used to provide
+a historical perspective on how your Gamelift FlexMatch solution is performing.
+
+#### FlexMatch Metrics
+
+GameLift FlexMatch sends metrics to CloudWatch so that you can collect and
+analyze the activity of your matchmaking solution, including match acceptance
+workflow, ticket consumtion.
+
+You can then use CloudWatch alarms to alert you, for example, when matches has
+been rejected (potential matches that were rejected by at least one player
+since the last report) exceed a certain thresold which could means that you may
+have an issue in your matchmaking rules.
+
+CDK provides methods for accessing GameLift FlexMatch metrics with default configuration,
+such as `metricRuleEvaluationsPassed`, or `metricRuleEvaluationsFailed` (see
+[`IMatchmakingRuleSet`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-gamelift.IMatchmakingRuleSet.html)
+for a full list). CDK also provides a generic `metric` method that can be used
+to produce metric configurations for any metric provided by GameLift FlexMatch;
+the configurations are pre-populated with the correct dimensions for the
+matchmaking configuration.
+
+```ts
+declare const matchmakingRuleSet: gamelift.MatchmakingRuleSet;
+// Alarm that triggers when the per-second average of not placed matches exceed 10%
+const ruleEvaluationRatio = new cloudwatch.MathExpression({
+  expression: '1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)',
+  usingMetrics: {
+    ruleEvaluationsPassed: matchmakingRuleSet.metricRuleEvaluationsPassed({ statistic: cloudwatch.Statistic.SUM }),
+    ruleEvaluationsFailed: matchmakingRuleSet.metric('ruleEvaluationsFailed'),
+  },
+});
+new cloudwatch.Alarm(this, 'Alarm', {
+  metric: ruleEvaluationRatio,
+  threshold: 0.1,
+  evaluationPeriods: 3,
+});
+```
+
+See: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)
+in the *Amazon GameLift Developer Guide*.
+
+
 ## GameLift Hosting
 
 ### Uploading builds and scripts to GameLift
@@ -74,9 +141,12 @@ services.
 
 ```ts
 declare const bucket: s3.Bucket;
-new gamelift.Build(this, 'Build', {
+const build = new gamelift.Build(this, 'Build', {
   content: gamelift.Content.fromBucket(bucket, "sample-asset-key")
 });
+
+new CfnOutput(this, 'BuildArn', { value: build.buildArn });
+new CfnOutput(this, 'BuildId', { value: build.buildId });
 ```
 
 #### Upload a realtime server Script
@@ -280,7 +350,7 @@ fleet.addLocation('ap-southeast-1', 5, 2, 10);
 Some GameLift features require you to extend limited access to your AWS
 resources. This is done by creating an AWS IAM role. The GameLift Fleet class
 automatically created an IAM role with all the minimum necessary permissions
-for GameLift to access your ressources. If you wish, you may
+for GameLift to access your resources. If you wish, you may
 specify your own IAM role.
 
 ```ts
@@ -306,12 +376,36 @@ const fleet = new gamelift.BuildFleet(this, 'Game server fleet', {
 fleet.grant(role, 'gamelift:ListFleets');
 ```
 
+### Alias
+
+A GameLift alias is used to abstract a fleet designation. Fleet designations
+tell Amazon GameLift where to search for available resources when creating new
+game sessions for players. By using aliases instead of specific fleet IDs, you
+can more easily and seamlessly switch player traffic from one fleet to another
+by changing the alias's target location.
+
+```ts
+declare const fleet: gamelift.BuildFleet;
+
+// Add an alias to an existing fleet using a dedicated fleet method
+const liveAlias = fleet.addAlias('live');
+
+// You can also create a standalone alias
+new gamelift.Alias(this, 'TerminalAlias', {
+  aliasName: 'terminal-alias',
+  terminalMessage: 'A terminal message',
+});
+```
+
+See [Add an alias to a GameLift fleet](https://docs.aws.amazon.com/gamelift/latest/developerguide/aliases-creating.html)
+in the *Amazon GameLift Developer Guide*.
+
 ### Monitoring your Fleet
 
 GameLift is integrated with CloudWatch, so you can monitor the performance of
 your game servers via logs and metrics.
 
-#### Metrics
+#### Fleet Metrics
 
 GameLift Fleet sends metrics to CloudWatch so that you can collect and analyze
 the activity of your Fleet, including game  and player sessions and server
@@ -319,7 +413,7 @@ processes.
 
 You can then use CloudWatch alarms to alert you, for example, when matches has
 been rejected (potential matches that were rejected by at least one player
-since the last report) exceed a certain thresold which could means that you may
+since the last report) exceed a certain threshold which could means that you may
 have an issue in your matchmaking rules.
 
 CDK provides methods for accessing GameLift Fleet metrics with default configuration,
@@ -349,6 +443,65 @@ new cloudwatch.Alarm(this, 'Alarm', {
 See: [Monitoring Using CloudWatch Metrics](https://docs.aws.amazon.com/gamelift/latest/developerguide/monitoring-cloudwatch.html)
 in the *Amazon GameLift Developer Guide*.
 
+## Game session queue
+
+The game session queue is the primary mechanism for processing new game session
+requests and locating available game servers to host them. Although it is
+possible to request a new game session be hosted on specific fleet or location.
+
+The `GameSessionQueue` resource creates a placement queue that processes requests for
+new game sessions. A queue uses FleetIQ algorithms to determine the best placement
+locations and find an available game server, then prompts the game server to start a
+new game session. Queues can have destinations (GameLift fleets or aliases), which
+determine where the queue can place new game sessions. A queue can have destinations
+with varied fleet type (Spot and On-Demand), instance type, and AWS Region.
+
+```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);
+```
+
+A more complex configuration can also be definied to override how FleetIQ algorithms prioritize game session placement in order to favour a destination based on `Cost`, `Latency`, `Destination order`or `Location`.
+
+```ts
+declare const fleet: gamelift.BuildFleet;
+declare const topic: sns.Topic;
+
+new gamelift.GameSessionQueue(this, 'MyGameSessionQueue', {
+      gameSessionQueueName: 'test-gameSessionQueue',
+      customEventData: 'test-event-data',
+      allowedLocations: ['eu-west-1', 'eu-west-2'],
+      destinations: [fleet],
+      notificationTarget: topic,
+      playerLatencyPolicies: [{
+        maximumIndividualPlayerLatency: Duration.millis(100),
+        policyDuration: Duration.seconds(300),
+      }],
+      priorityConfiguration: {
+        locationOrder: [
+          'eu-west-1',
+          'eu-west-2',
+        ],
+        priorityOrder: [
+          gamelift.PriorityType.LATENCY,
+          gamelift.PriorityType.COST,
+          gamelift.PriorityType.DESTINATION,
+          gamelift.PriorityType.LOCATION,
+        ],
+      },
+      timeout: Duration.seconds(300),
+    });
+```
+
+See [Setting up GameLift queues for game session placement](https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-script-uploading.html)
+in the *Amazon GameLift Developer Guide*.
+
 ## GameLift FleetIQ
 
 The GameLift FleetIQ solution is a game hosting layer that supplements the full
@@ -427,7 +580,7 @@ in the *Amazon GameLift FleetIQ Developer Guide*.
 
 The GameLift FleetIQ class automatically creates an IAM role with all the minimum necessary
 permissions for GameLift to access your Amazon EC2 Auto Scaling groups. If you wish, you may
-specify your own IAM role. It must have the correct permissions, or FleetIQ creation or ressource usage may fail.
+specify your own IAM role. It must have the correct permissions, or FleetIQ creation or resource usage may fail.
 
 ```ts
 declare const launchTemplate: ec2.ILaunchTemplate;
@@ -484,7 +637,7 @@ new gamelift.GameServerGroup(this, 'GameServerGroup', {
 });
 ```
 
-### Monitoring
+### FleetIQ Monitoring
 
 GameLift FleetIQ sends metrics to CloudWatch so that you can collect and
 analyze the activity of your Game server fleet, including the number of
@@ -493,7 +646,7 @@ limited Spot availability.
 
 You can then use CloudWatch alarms to alert you, for example, when the portion
 of game servers that are currently supporting game executions exceed a certain
-thresold which could means that your autoscaling policy need to be adjust to
+threshold which could means that your autoscaling policy need to be adjust to
 add more instances to match with player demand.
 
 CDK provides a generic `metric` method that can be used

package/lib/alias.d.ts

@@ -0,0 +1,146 @@
+import * as cdk from 'aws-cdk-lib';
+import { Construct } from 'constructs';
+import { IFleet } from './fleet-base';
+import { IGameSessionQueueDestination } from './game-session-queue';
+/**
+ * Represents a Gamelift Alias for a Gamelift fleet destination.
+ */
+export interface IAlias extends cdk.IResource, IGameSessionQueueDestination {
+    /**
+       * The Identifier of the alias.
+       *
+       * @attribute
+       */
+    readonly aliasId: string;
+    /**
+     * The ARN of the alias.
+     *
+     * @attribute
+     */
+    readonly aliasArn: string;
+}
+/**
+ * Options for `gamelift.Alias`.
+ */
+export interface AliasOptions {
+    /**
+       * Description for the alias
+       *
+       * @default No description
+       */
+    readonly description?: string;
+}
+/**
+ * A full specification of an alias that can be used to import it fluently into the CDK application.
+ */
+export interface AliasAttributes {
+    /**
+         * The ARN of the alias
+         *
+         * At least one of `aliasArn` and `aliasId` must be provided.
+         *
+         * @default derived from `aliasId`.
+         */
+    readonly aliasArn?: string;
+    /**
+       * The identifier of the alias
+       *
+       * At least one of `aliasId` and `aliasArn`  must be provided.
+       *
+       * @default derived from `aliasArn`.
+       */
+    readonly aliasId?: string;
+}
+/**
+ * Properties for a new Fleet alias
+ */
+export interface AliasProps {
+    /**
+       * Name of this alias
+       */
+    readonly aliasName: string;
+    /**
+       * A human-readable description of the alias
+       *
+       * @default no description
+       */
+    readonly description?: string;
+    /**
+     * A fleet that the alias points to.
+     * If specified, the alias resolves to one specific fleet.
+     *
+     * At least one of `fleet` and `terminalMessage` must be provided.
+     *
+     * @default no fleet that the alias points to.
+     */
+    readonly fleet?: IFleet;
+    /**
+     * The message text to be used with a terminal routing strategy.
+     *
+     * At least one of `fleet` and `terminalMessage` must be provided.
+     *
+     * @default no terminal message
+     */
+    readonly terminalMessage?: string;
+}
+/**
+ * Base class for new and imported GameLift Alias.
+ */
+export declare abstract class AliasBase extends cdk.Resource implements IAlias {
+    /**
+   * The Identifier of the alias.
+   */
+    abstract readonly aliasId: string;
+    /**
+     * The ARN of the alias
+     */
+    abstract readonly aliasArn: string;
+    /**
+     * The ARN to put into the destination field of a game session queue
+     */
+    get resourceArnForDestination(): string;
+}
+/**
+ * A Amazon GameLift alias is used to abstract a fleet designation.
+ * Fleet designations tell GameLift where to search for available resources when creating new game sessions for players.
+ * Use aliases instead of specific fleet IDs to seamlessly switch player traffic from one fleet to another by changing the alias's target location.
+ *
+ * Aliases are useful in games that don't use queues.
+ * Switching fleets in a queue is a simple matter of creating a new fleet, adding it to the queue, and removing the old fleet, none of which is visible to players.
+ * In contrast, game clients that don't use queues must specify which fleet to use when communicating with the GameLift service.
+ * Without aliases, a fleet switch requires updates to your game code and possibly distribution of an updated game clients to players.
+ *
+ * When updating the fleet-id an alias points to, there is a transition period of up to 2 minutes where game sessions on the alias may end up on the old fleet.
+ *
+ * @see https://docs.aws.amazon.com/gamelift/latest/developerguide/aliases-creating.html
+ *
+ * @resource AWS::GameLift::Alias
+ */
+export declare class Alias extends AliasBase {
+    /**
+     * Import an existing alias from its identifier.
+     */
+    static fromAliasId(scope: Construct, id: string, aliasId: string): IAlias;
+    /**
+     * Import an existing alias from its ARN.
+     */
+    static fromAliasArn(scope: Construct, id: string, aliasArn: string): IAlias;
+    /**
+     * Import an existing alias from its attributes.
+     */
+    static fromAliasAttributes(scope: Construct, id: string, attrs: AliasAttributes): IAlias;
+    /**
+     * The Identifier of the alias.
+     */
+    readonly aliasId: string;
+    /**
+      * The ARN of the alias.
+      */
+    readonly aliasArn: string;
+    /**
+     * A fleet that the alias points to.
+     */
+    readonly fleet?: IFleet;
+    constructor(scope: Construct, id: string, props: AliasProps);
+    private parseRoutingStrategy;
+}