@aws-sdk/client-gamelift 3.32.0 → 3.36.0

package/dist-cjs/commands/SearchGameSessionsCommand.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchGameSessionsCommand = void 0;
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+const models_0_1 = require("../models/models_0");
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+/**
+ * <p>Retrieves all active game sessions that match a set of search criteria and sorts them
+ *             into a specified order. </p>
+ *         <p>When searching for game sessions, you specify exactly where you want to search and
+ *             provide a search filter expression, a sort expression, or both. A search request can
+ *             search only one fleet, but it can search all of a fleet's locations.  </p>
+ *         <p>This operation can be used in the following ways: </p>
+ *         <ul>
+ *             <li>
+ *                 <p>To search all game sessions that are currently running on all locations in a
+ *                     fleet, provide a fleet or alias ID. This approach returns game sessions in the
+ *                     fleet's home Region and all remote locations that fit the search
+ *                     criteria.</p>
+ *             </li>
+ *             <li>
+ *                 <p>To search all game sessions that are currently running on a specific fleet
+ *                     location, provide a fleet or alias ID and a location name. For location, you can
+ *                     specify a fleet's home Region or any remote location.</p>
+ *             </li>
+ *          </ul>
+ *         <p>Use the pagination parameters to retrieve results as a set of sequential pages. </p>
+ *         <p>If successful, a <code>GameSession</code> object is returned for each game session
+ *             that matches the request. Search finds game sessions that are in <code>ACTIVE</code>
+ *             status only. To retrieve information on game sessions in other statuses, use <a>DescribeGameSessions</a>.</p>
+ *         <p>You can search or sort by the following game session attributes:</p>
+ *         <ul>
+ *             <li>
+ *                 <p>
+ *                   <b>gameSessionId</b> -- A unique identifier for the game session. You can use
+ *                     either a <code>GameSessionId</code> or <code>GameSessionArn</code> value.
+ *                 </p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>gameSessionName</b> -- Name assigned to a game
+ *                     session. This value is set when requesting a new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>. Game session names do not need to be unique
+ *                     to a game session.</p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>gameSessionProperties</b> -- Custom data
+ *                     defined in a game session's <code>GameProperty</code> parameter.
+ *                         <code>GameProperty</code> values are stored as key:value pairs; the filter
+ *                     expression must indicate the key and a string to search the data values for. For
+ *                     example, to search for game sessions with custom data containing the key:value
+ *                     pair "gameMode:brawl", specify the following:
+ *                         <code>gameSessionProperties.gameMode = "brawl"</code>. All custom data
+ *                     values are searched as strings.</p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>maximumSessions</b> -- Maximum number of
+ *                     player sessions allowed for a game session. This value is set when requesting a
+ *                     new game session with <a>CreateGameSession</a> or updating with <a>UpdateGameSession</a>.</p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>creationTimeMillis</b> -- Value indicating
+ *                     when a game session was created. It is expressed in Unix time as
+ *                     milliseconds.</p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>playerSessionCount</b> -- Number of players
+ *                     currently connected to a game session. This value changes rapidly as players
+ *                     join the session or drop out.</p>
+ *             </li>
+ *             <li>
+ *                 <p>
+ *                   <b>hasAvailablePlayerSessions</b> -- Boolean
+ *                     value indicating whether a game session has reached its maximum number of
+ *                     players. It is highly recommended that all search requests include this filter
+ *                     attribute to optimize search performance and return only sessions that players
+ *                     can join. </p>
+ *             </li>
+ *          </ul>
+ *         <note>
+ *             <p>Returned values for <code>playerSessionCount</code> and
+ *                     <code>hasAvailablePlayerSessions</code> change quickly as players join sessions
+ *                 and others drop out. Results should be considered a snapshot in time. Be sure to
+ *                 refresh search results often, and handle sessions that fill up before a player can
+ *                 join. </p>
+ *         </note>
+ *         <p>
+ *             <b>Related actions</b>
+ *          </p>
+ *                     <p>
+ *             <a>CreateGameSession</a> |
+ *                     <a>DescribeGameSessions</a> |
+ *                     <a>DescribeGameSessionDetails</a> |
+ *                     <a>SearchGameSessions</a> |
+ *                     <a>UpdateGameSession</a> |
+ *                     <a>GetGameSessionLogUrl</a> |
+ *                     <a>StartGameSessionPlacement</a> |
+ *                     <a>DescribeGameSessionPlacement</a> |
+ *                     <a>StopGameSessionPlacement</a> |
+ *                     <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+ *          </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GameLiftClient, SearchGameSessionsCommand } from "@aws-sdk/client-gamelift"; // ES Modules import
+ * // const { GameLiftClient, SearchGameSessionsCommand } = require("@aws-sdk/client-gamelift"); // CommonJS import
+ * const client = new GameLiftClient(config);
+ * const command = new SearchGameSessionsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link SearchGameSessionsCommandInput} for command's `input` shape.
+ * @see {@link SearchGameSessionsCommandOutput} for command's `response` shape.
+ * @see {@link GameLiftClientResolvedConfig | config} for command's `input` shape.
+ *
+ */
+class SearchGameSessionsCommand extends smithy_client_1.Command {
+    // Start section: command_properties
+    // End section: command_properties
+    constructor(input) {
+        // Start section: command_constructor
+        super();
+        this.input = input;
+        // End section: command_constructor
+    }
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "GameLiftClient";
+        const commandName = "SearchGameSessionsCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: models_0_1.SearchGameSessionsInput.filterSensitiveLog,
+            outputFilterSensitiveLog: models_0_1.SearchGameSessionsOutput.filterSensitiveLog,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return Aws_json1_1_1.serializeAws_json1_1SearchGameSessionsCommand(input, context);
+    }
+    deserialize(output, context) {
+        return Aws_json1_1_1.deserializeAws_json1_1SearchGameSessionsCommand(output, context);
+    }
+}
+exports.SearchGameSessionsCommand = SearchGameSessionsCommand;

package/dist-cjs/commands/StartFleetActionsCommand.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartFleetActionsCommand = void 0;
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+const models_0_1 = require("../models/models_0");
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+/**
+ * <p>Resumes certain types of activity on fleet instances that were suspended with <a>StopFleetActions</a>. For multi-location fleets, fleet actions are managed
+ *             separately for each location. Currently, this operation is used to restart a fleet's
+ *             auto-scaling activity.</p>
+ *         <p>This operation can be used in the following ways: </p>
+ *         <ul>
+ *             <li>
+ *                 <p>To restart actions on instances in the fleet's home Region, provide a fleet ID
+ *                     and the type of actions to resume. </p>
+ *             </li>
+ *             <li>
+ *                 <p>To restart actions on instances in one of the fleet's remote locations,
+ *                     provide a fleet ID, a location name, and the type of actions to resume.  </p>
+ *             </li>
+ *          </ul>
+ *         <p>If successful, GameLift once again initiates scaling events as triggered by the fleet's
+ *             scaling policies. If actions on the fleet location were never stopped, this operation
+ *             will have no effect. You can view a fleet's stopped actions using <a>DescribeFleetAttributes</a> or <a>DescribeFleetLocationAttributes</a>.</p>
+ *         <p>
+ *             <b>Learn more</b>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html">Setting up GameLift fleets</a>
+ *          </p>
+ *         <p>
+ *             <b>Related actions</b>
+ *          </p>
+ *                     <p>
+ *             <a>CreateFleet</a> |
+ *                     <a>UpdateFleetCapacity</a> |
+ *                     <a>PutScalingPolicy</a> |
+ *                     <a>DescribeEC2InstanceLimits</a> |
+ *                     <a>DescribeFleetAttributes</a> |
+ *                     <a>DescribeFleetLocationAttributes</a> |
+ *                     <a>UpdateFleetAttributes</a> |
+ *                     <a>StopFleetActions</a> |
+ *                     <a>DeleteFleet</a> |
+ *                     <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+ *          </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GameLiftClient, StartFleetActionsCommand } from "@aws-sdk/client-gamelift"; // ES Modules import
+ * // const { GameLiftClient, StartFleetActionsCommand } = require("@aws-sdk/client-gamelift"); // CommonJS import
+ * const client = new GameLiftClient(config);
+ * const command = new StartFleetActionsCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link StartFleetActionsCommandInput} for command's `input` shape.
+ * @see {@link StartFleetActionsCommandOutput} for command's `response` shape.
+ * @see {@link GameLiftClientResolvedConfig | config} for command's `input` shape.
+ *
+ */
+class StartFleetActionsCommand extends smithy_client_1.Command {
+    // Start section: command_properties
+    // End section: command_properties
+    constructor(input) {
+        // Start section: command_constructor
+        super();
+        this.input = input;
+        // End section: command_constructor
+    }
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "GameLiftClient";
+        const commandName = "StartFleetActionsCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: models_0_1.StartFleetActionsInput.filterSensitiveLog,
+            outputFilterSensitiveLog: models_0_1.StartFleetActionsOutput.filterSensitiveLog,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return Aws_json1_1_1.serializeAws_json1_1StartFleetActionsCommand(input, context);
+    }
+    deserialize(output, context) {
+        return Aws_json1_1_1.deserializeAws_json1_1StartFleetActionsCommand(output, context);
+    }
+}
+exports.StartFleetActionsCommand = StartFleetActionsCommand;

package/dist-cjs/commands/StartGameSessionPlacementCommand.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartGameSessionPlacementCommand = void 0;
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+const models_0_1 = require("../models/models_0");
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+/**
+ * <p>Places a request for a new game session in a queue (see <a>CreateGameSessionQueue</a>). When processing a placement request, Amazon GameLift
+ *         searches for available resources on the queue's destinations, scanning each until it
+ *         finds resources or the placement request times out.</p>
+ *          <p>A game session placement request can also request player sessions. When a new game
+ *         session is successfully created, Amazon GameLift creates a player session for each player
+ *         included in the request.</p>
+ *          <p>When placing a game session, by default Amazon GameLift tries each fleet in the order they
+ *         are listed in the queue configuration. Ideally, a queue's destinations are listed in
+ *         preference order.</p>
+ *          <p>Alternatively, when requesting a game session with players, you can also provide
+ *         latency data for each player in relevant Regions. Latency data indicates the performance
+ *         lag a player experiences when connected to a fleet in the Region. Amazon GameLift uses latency
+ *         data to reorder the list of destinations to place the game session in a Region with
+ *         minimal lag. If latency data is provided for multiple players, Amazon GameLift calculates each
+ *         Region's average lag for all players and reorders to get the best game play across all
+ *         players. </p>
+ *          <p>To place a new game session request, specify the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>The queue name and a set of game session properties and settings</p>
+ *             </li>
+ *             <li>
+ *                <p>A unique ID (such as a UUID) for the placement. You use this ID to track
+ *                 the status of the placement request</p>
+ *             </li>
+ *             <li>
+ *                <p>(Optional) A set of player data and a unique player ID for each player that
+ *                 you are joining to the new game session (player data is optional, but if you
+ *                 include it, you must also provide a unique ID for each player)</p>
+ *             </li>
+ *             <li>
+ *                <p>Latency data for all players (if you want to optimize game play for the
+ *                 players)</p>
+ *             </li>
+ *          </ul>
+ *          <p>If successful, a new game session placement is created.</p>
+ *          <p>To track the status of a placement request, call <a>DescribeGameSessionPlacement</a> and check the request's status. If the
+ *         status is <code>FULFILLED</code>, a new game session has been created and a game session
+ *         ARN and Region are referenced. If the placement request times out, you can resubmit the
+ *         request or retry it with a different queue. </p>
+ *          <p>
+ *             <b>Related actions</b>
+ *          </p>
+ *                     <p>
+ *             <a>CreateGameSession</a> |
+ *                     <a>DescribeGameSessions</a> |
+ *                     <a>DescribeGameSessionDetails</a> |
+ *                     <a>SearchGameSessions</a> |
+ *                     <a>UpdateGameSession</a> |
+ *                     <a>GetGameSessionLogUrl</a> |
+ *                     <a>StartGameSessionPlacement</a> |
+ *                     <a>DescribeGameSessionPlacement</a> |
+ *                     <a>StopGameSessionPlacement</a> |
+ *                     <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+ *          </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GameLiftClient, StartGameSessionPlacementCommand } from "@aws-sdk/client-gamelift"; // ES Modules import
+ * // const { GameLiftClient, StartGameSessionPlacementCommand } = require("@aws-sdk/client-gamelift"); // CommonJS import
+ * const client = new GameLiftClient(config);
+ * const command = new StartGameSessionPlacementCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link StartGameSessionPlacementCommandInput} for command's `input` shape.
+ * @see {@link StartGameSessionPlacementCommandOutput} for command's `response` shape.
+ * @see {@link GameLiftClientResolvedConfig | config} for command's `input` shape.
+ *
+ */
+class StartGameSessionPlacementCommand extends smithy_client_1.Command {
+    // Start section: command_properties
+    // End section: command_properties
+    constructor(input) {
+        // Start section: command_constructor
+        super();
+        this.input = input;
+        // End section: command_constructor
+    }
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "GameLiftClient";
+        const commandName = "StartGameSessionPlacementCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: models_0_1.StartGameSessionPlacementInput.filterSensitiveLog,
+            outputFilterSensitiveLog: models_0_1.StartGameSessionPlacementOutput.filterSensitiveLog,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return Aws_json1_1_1.serializeAws_json1_1StartGameSessionPlacementCommand(input, context);
+    }
+    deserialize(output, context) {
+        return Aws_json1_1_1.deserializeAws_json1_1StartGameSessionPlacementCommand(output, context);
+    }
+}
+exports.StartGameSessionPlacementCommand = StartGameSessionPlacementCommand;

package/dist-cjs/commands/StartMatchBackfillCommand.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartMatchBackfillCommand = void 0;
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+const models_0_1 = require("../models/models_0");
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+/**
+ * <p>Finds new players to fill open slots in currently running game sessions.
+ *             The backfill match process is essentially identical to the process of forming new
+ *             matches. Backfill
+ *             requests use the same matchmaker that was used to make the original match, and they provide
+ *             matchmaking data for all players currently in the game session. FlexMatch uses this information
+ *             to select new players so that backfilled match continues to meet the original match requirements. </p>
+ *         <p>When using FlexMatch with GameLift managed hosting, you can request a backfill match from
+ *             a client service by calling this operation with a <a>GameSession</a>
+ *             identifier. You also have the option of making backfill requests directly from your game
+ *             server. In response to a request, FlexMatch creates player sessions for the new players,
+ *             updates the <code>GameSession</code> resource, and sends updated matchmaking data to the
+ *             game server. You can request a backfill match at any point after a game session is
+ *             started. Each game session can have only one active backfill request at a time; a
+ *             subsequent request automatically replaces the earlier request.</p>
+ *         <p>When using FlexMatch as a standalone component, request a backfill match by calling this operation
+ *         without a game session identifier. As with newly formed matches, matchmaking results are returned
+ *         in a matchmaking event so that your game can update the game session that is being backfilled.</p>
+ *         <p>To request a backfill match, specify a unique ticket ID, the original matchmaking
+ *             configuration, and matchmaking data for all current players in the game session being
+ *             backfilled. Optionally, specify the <code>GameSession</code> ARN. If successful, a match
+ *             backfill ticket is created and returned with status set to QUEUED. Track the status of
+ *             backfill tickets using the same method for tracking tickets for new matches.</p>
+ *         <p>
+ *             <b>Learn more</b>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html">
+ *             Backfill existing games with FlexMatch</a>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html">
+ *             Matchmaking events</a> (reference)</p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/gamelift-match.html">
+ *                 How GameLift FlexMatch works</a>
+ *          </p>
+ *         <p>
+ *             <b>Related actions</b>
+ *          </p>
+ *                     <p>
+ *             <a>StartMatchmaking</a> |
+ *                     <a>DescribeMatchmaking</a> |
+ *                     <a>StopMatchmaking</a> |
+ *                     <a>AcceptMatch</a> |
+ *                     <a>StartMatchBackfill</a> |
+ *                     <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+ *          </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GameLiftClient, StartMatchBackfillCommand } from "@aws-sdk/client-gamelift"; // ES Modules import
+ * // const { GameLiftClient, StartMatchBackfillCommand } = require("@aws-sdk/client-gamelift"); // CommonJS import
+ * const client = new GameLiftClient(config);
+ * const command = new StartMatchBackfillCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link StartMatchBackfillCommandInput} for command's `input` shape.
+ * @see {@link StartMatchBackfillCommandOutput} for command's `response` shape.
+ * @see {@link GameLiftClientResolvedConfig | config} for command's `input` shape.
+ *
+ */
+class StartMatchBackfillCommand extends smithy_client_1.Command {
+    // Start section: command_properties
+    // End section: command_properties
+    constructor(input) {
+        // Start section: command_constructor
+        super();
+        this.input = input;
+        // End section: command_constructor
+    }
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "GameLiftClient";
+        const commandName = "StartMatchBackfillCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: models_0_1.StartMatchBackfillInput.filterSensitiveLog,
+            outputFilterSensitiveLog: models_0_1.StartMatchBackfillOutput.filterSensitiveLog,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return Aws_json1_1_1.serializeAws_json1_1StartMatchBackfillCommand(input, context);
+    }
+    deserialize(output, context) {
+        return Aws_json1_1_1.deserializeAws_json1_1StartMatchBackfillCommand(output, context);
+    }
+}
+exports.StartMatchBackfillCommand = StartMatchBackfillCommand;

package/dist-cjs/commands/StartMatchmakingCommand.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StartMatchmakingCommand = void 0;
+const middleware_serde_1 = require("@aws-sdk/middleware-serde");
+const smithy_client_1 = require("@aws-sdk/smithy-client");
+const models_0_1 = require("../models/models_0");
+const Aws_json1_1_1 = require("../protocols/Aws_json1_1");
+/**
+ * <p>Uses FlexMatch to create a game match for a group of players based on custom matchmaking
+ *             rules. With games that use GameLift managed hosting, this operation also triggers GameLift
+ *             to find hosting resources and start a new game session for the new match. Each
+ *             matchmaking request includes information on one or more players and specifies the
+ *             FlexMatch matchmaker to use. When a request is for multiple players, FlexMatch attempts to
+ *             build a match that includes all players in the request, placing them in the same team
+ *             and finding additional players as needed to fill the match. </p>
+ *         <p>To start matchmaking, provide a unique ticket ID, specify a matchmaking configuration,
+ *             and include the players to be matched. You must also include any player attributes that
+ *             are required by the matchmaking configuration's rule set. If successful, a matchmaking
+ *             ticket is returned with status set to <code>QUEUED</code>. </p>
+ *         <p>Track matchmaking events to respond as needed and acquire game session connection
+ *             information for successfully completed matches. Ticket status updates are tracked using
+ *             event notification through Amazon Simple Notification Service (SNS), which is defined in the matchmaking
+ *             configuration.</p>
+ *         <p>
+ *             <b>Learn more</b>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-client.html">
+ *             Add FlexMatch to a game client</a>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html">
+ *             Set Up FlexMatch event notification</a>
+ *          </p>
+ *         <p>
+ *             <a href="https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/gamelift-match.html">
+ *             How GameLift FlexMatch works</a>
+ *          </p>
+ *         <p>
+ *             <b>Related actions</b>
+ *          </p>
+ *                     <p>
+ *             <a>StartMatchmaking</a> |
+ *                     <a>DescribeMatchmaking</a> |
+ *                     <a>StopMatchmaking</a> |
+ *                     <a>AcceptMatch</a> |
+ *                     <a>StartMatchBackfill</a> |
+ *                     <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+ *          </p>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { GameLiftClient, StartMatchmakingCommand } from "@aws-sdk/client-gamelift"; // ES Modules import
+ * // const { GameLiftClient, StartMatchmakingCommand } = require("@aws-sdk/client-gamelift"); // CommonJS import
+ * const client = new GameLiftClient(config);
+ * const command = new StartMatchmakingCommand(input);
+ * const response = await client.send(command);
+ * ```
+ *
+ * @see {@link StartMatchmakingCommandInput} for command's `input` shape.
+ * @see {@link StartMatchmakingCommandOutput} for command's `response` shape.
+ * @see {@link GameLiftClientResolvedConfig | config} for command's `input` shape.
+ *
+ */
+class StartMatchmakingCommand extends smithy_client_1.Command {
+    // Start section: command_properties
+    // End section: command_properties
+    constructor(input) {
+        // Start section: command_constructor
+        super();
+        this.input = input;
+        // End section: command_constructor
+    }
+    /**
+     * @internal
+     */
+    resolveMiddleware(clientStack, configuration, options) {
+        this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
+        const stack = clientStack.concat(this.middlewareStack);
+        const { logger } = configuration;
+        const clientName = "GameLiftClient";
+        const commandName = "StartMatchmakingCommand";
+        const handlerExecutionContext = {
+            logger,
+            clientName,
+            commandName,
+            inputFilterSensitiveLog: models_0_1.StartMatchmakingInput.filterSensitiveLog,
+            outputFilterSensitiveLog: models_0_1.StartMatchmakingOutput.filterSensitiveLog,
+        };
+        const { requestHandler } = configuration;
+        return stack.resolve((request) => requestHandler.handle(request.request, options || {}), handlerExecutionContext);
+    }
+    serialize(input, context) {
+        return Aws_json1_1_1.serializeAws_json1_1StartMatchmakingCommand(input, context);
+    }
+    deserialize(output, context) {
+        return Aws_json1_1_1.deserializeAws_json1_1StartMatchmakingCommand(output, context);
+    }
+}
+exports.StartMatchmakingCommand = StartMatchmakingCommand;