@aws-sdk/client-gamelift 3.714.0 → 3.721.0

package/dist-types/models/models_1.d.ts

@@ -1141,6 +1141,76 @@ export interface TagResourceRequest {
  */
 export interface TagResourceResponse {
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const TerminationMode: {
+    readonly FORCE_TERMINATE: "FORCE_TERMINATE";
+    readonly TRIGGER_ON_PROCESS_TERMINATE: "TRIGGER_ON_PROCESS_TERMINATE";
+};
+/**
+ * @public
+ */
+export type TerminationMode = (typeof TerminationMode)[keyof typeof TerminationMode];
+/**
+ * @public
+ */
+export interface TerminateGameSessionInput {
+    /**
+     * <p>A unique identifier for the game session to be terminated. A game session ARN has the following format:
+     *     <code>arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token></code>.</p>
+     * @public
+     */
+    GameSessionId: string | undefined;
+    /**
+     * <p>The method to use to terminate the game session. Available methods include: </p>
+     *          <ul>
+     *             <li>
+     *                <p>
+     *                   <code>TRIGGER_ON_PROCESS_TERMINATE</code> – Sends an
+     *                         <code>OnProcessTerminate()</code> callback to the server process to initiate
+     *                     the normal game session shutdown sequence. At a minimum, the callback method
+     *                     must include a call to the server SDK action <code>ProcessEnding()</code>, which
+     *                     is how the server process signals that a game session is ending. If the server
+     *                     process doesn't call <code>ProcessEnding()</code>, this termination method won't
+     *                     be successful.</p>
+     *             </li>
+     *             <li>
+     *                <p>
+     *                   <code>FORCE_TERMINATE</code> – Takes action to stop the server process, using
+     *                     existing methods to control how server processes run on an Amazon GameLift managed
+     *                     compute. </p>
+     *                <note>
+     *                   <p>This method is not available for game sessions that are running on
+     *                         Anywhere fleets unless the fleet is deployed with the Amazon GameLift Agent. In this
+     *                         scenario, a force terminate request results in an invalid or bad request
+     *                         exception.</p>
+     *                </note>
+     *             </li>
+     *          </ul>
+     * @public
+     */
+    TerminationMode: TerminationMode | undefined;
+}
+/**
+ * @public
+ */
+export interface TerminateGameSessionOutput {
+    /**
+     * <p>Properties describing a game session.</p>
+     *          <p>A game session in ACTIVE status can host players. When a game session ends, its status
+     *             is set to <code>TERMINATED</code>. </p>
+     *          <p>Amazon GameLift retains a game session resource for 30 days after the game session ends. You
+     *             can reuse idempotency token values after this time. Game session logs are retained for
+     *             14 days.</p>
+     *          <p>
+     *             <a href="https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets">All APIs by task</a>
+     *          </p>
+     * @public
+     */
+    GameSession?: GameSession | undefined;
+}
 /**
  * @public
  */
@@ -1248,7 +1318,11 @@ export interface UpdateContainerFleetInput {
      *             fleet to the latest version of a container group definition, you can use the name value.
      *             You can't remove a fleet's game server container group definition, you can only update
      *             or replace it with another definition.</p>
-     *          <p>Update a container group definition by calling <a>UpdateContainerGroupDefinition</a>. This operation creates a <a>ContainerGroupDefinition</a> resource with an incremented version. </p>
+     *          <p>Update a container group definition by calling
+     *             <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateContainerGroupDefinition.html">UpdateContainerGroupDefinition</a>.
+     *             This operation creates a
+     *             <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_ContainerGroupDefinition.html">ContainerGroupDefinition</a>
+     *             resource with an incremented version. </p>
      * @public
      */
     GameServerContainerGroupDefinitionName?: string | undefined;
@@ -1258,7 +1332,11 @@ export interface UpdateContainerFleetInput {
      *             definition, use the ARN value and include the version number. If you're updating the
      *             fleet to the latest version of a container group definition, you can use the name
      *             value.</p>
-     *          <p>Update a container group definition by calling <a>UpdateContainerGroupDefinition</a>. This operation creates a <a>ContainerGroupDefinition</a> resource with an incremented version. </p>
+     *          <p>Update a container group definition by calling
+     *             <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateContainerGroupDefinition.html">UpdateContainerGroupDefinition</a>.
+     *             This operation creates a
+     *             <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_ContainerGroupDefinition.html">ContainerGroupDefinition</a>
+     *             resource with an incremented version. </p>
      *          <p>To remove a fleet's per-instance container group definition, leave this parameter empty
      *             and use the parameter <code>RemoveAttributes</code>.</p>
      * @public
@@ -1438,7 +1516,7 @@ export interface UpdateFleetAttributesInput {
     /**
      * <p>The game session protection policy to apply to all new game sessions created in this
      *             fleet. Game sessions that already exist are not affected. You can set protection for
-     *             individual game sessions using <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html">UpdateGameSession</a>.</p>
+     *             individual game sessions using <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html">UpdateGameSession</a> .</p>
      *          <ul>
      *             <li>
      *                <p>
@@ -1749,12 +1827,12 @@ export interface UpdateGameSessionInput {
      *          <ul>
      *             <li>
      *                <p>
-     *                   <b>NoProtection</b> -- The game session can be
-     *                     terminated during a scale-down event.</p>
+     *                   <code>NoProtection</code> -- The game session can be terminated during a
+     *                     scale-down event.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <b>FullProtection</b> -- If the game session is in an
+     *                   <code>FullProtection</code> -- If the game session is in an
      *                         <code>ACTIVE</code> status, it cannot be terminated during a scale-down
      *                     event.</p>
      *             </li>
@@ -2130,6 +2208,10 @@ export declare const StartMatchmakingOutputFilterSensitiveLog: (obj: StartMatchm
  * @internal
  */
 export declare const StopGameSessionPlacementOutputFilterSensitiveLog: (obj: StopGameSessionPlacementOutput) => any;
+/**
+ * @internal
+ */
+export declare const TerminateGameSessionOutputFilterSensitiveLog: (obj: TerminateGameSessionOutput) => any;
 /**
  * @internal
  */

package/dist-types/protocols/Aws_json1_1.d.ts

@@ -101,6 +101,7 @@ import { StopGameSessionPlacementCommandInput, StopGameSessionPlacementCommandOu
 import { StopMatchmakingCommandInput, StopMatchmakingCommandOutput } from "../commands/StopMatchmakingCommand";
 import { SuspendGameServerGroupCommandInput, SuspendGameServerGroupCommandOutput } from "../commands/SuspendGameServerGroupCommand";
 import { TagResourceCommandInput, TagResourceCommandOutput } from "../commands/TagResourceCommand";
+import { TerminateGameSessionCommandInput, TerminateGameSessionCommandOutput } from "../commands/TerminateGameSessionCommand";
 import { UntagResourceCommandInput, UntagResourceCommandOutput } from "../commands/UntagResourceCommand";
 import { UpdateAliasCommandInput, UpdateAliasCommandOutput } from "../commands/UpdateAliasCommand";
 import { UpdateBuildCommandInput, UpdateBuildCommandOutput } from "../commands/UpdateBuildCommand";
@@ -521,6 +522,10 @@ export declare const se_SuspendGameServerGroupCommand: (input: SuspendGameServer
  * serializeAws_json1_1TagResourceCommand
  */
 export declare const se_TagResourceCommand: (input: TagResourceCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
+/**
+ * serializeAws_json1_1TerminateGameSessionCommand
+ */
+export declare const se_TerminateGameSessionCommand: (input: TerminateGameSessionCommandInput, context: __SerdeContext) => Promise<__HttpRequest>;
 /**
  * serializeAws_json1_1UntagResourceCommand
  */
@@ -989,6 +994,10 @@ export declare const de_SuspendGameServerGroupCommand: (output: __HttpResponse,
  * deserializeAws_json1_1TagResourceCommand
  */
 export declare const de_TagResourceCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<TagResourceCommandOutput>;
+/**
+ * deserializeAws_json1_1TerminateGameSessionCommand
+ */
+export declare const de_TerminateGameSessionCommand: (output: __HttpResponse, context: __SerdeContext) => Promise<TerminateGameSessionCommandOutput>;
 /**
  * deserializeAws_json1_1UntagResourceCommand
  */

package/dist-types/ts3.4/GameLift.d.ts

@@ -403,6 +403,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "./commands/TagResourceCommand";
+import {
+  TerminateGameSessionCommandInput,
+  TerminateGameSessionCommandOutput,
+} from "./commands/TerminateGameSessionCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -1818,6 +1822,19 @@ export interface GameLift {
     options: __HttpHandlerOptions,
     cb: (err: any, data?: TagResourceCommandOutput) => void
   ): void;
+  terminateGameSession(
+    args: TerminateGameSessionCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<TerminateGameSessionCommandOutput>;
+  terminateGameSession(
+    args: TerminateGameSessionCommandInput,
+    cb: (err: any, data?: TerminateGameSessionCommandOutput) => void
+  ): void;
+  terminateGameSession(
+    args: TerminateGameSessionCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: TerminateGameSessionCommandOutput) => void
+  ): void;
   untagResource(
     args: UntagResourceCommandInput,
     options?: __HttpHandlerOptions

package/dist-types/ts3.4/GameLiftClient.d.ts

@@ -449,6 +449,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "./commands/TagResourceCommand";
+import {
+  TerminateGameSessionCommandInput,
+  TerminateGameSessionCommandOutput,
+} from "./commands/TerminateGameSessionCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -622,6 +626,7 @@ export type ServiceInputTypes =
   | StopMatchmakingCommandInput
   | SuspendGameServerGroupCommandInput
   | TagResourceCommandInput
+  | TerminateGameSessionCommandInput
   | UntagResourceCommandInput
   | UpdateAliasCommandInput
   | UpdateBuildCommandInput
@@ -740,6 +745,7 @@ export type ServiceOutputTypes =
   | StopMatchmakingCommandOutput
   | SuspendGameServerGroupCommandOutput
   | TagResourceCommandOutput
+  | TerminateGameSessionCommandOutput
   | UntagResourceCommandOutput
   | UpdateAliasCommandOutput
   | UpdateBuildCommandOutput

package/dist-types/ts3.4/commands/TerminateGameSessionCommand.d.ts

@@ -0,0 +1,51 @@
+import { Command as $Command } from "@smithy/smithy-client";
+import { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import {
+  GameLiftClientResolvedConfig,
+  ServiceInputTypes,
+  ServiceOutputTypes,
+} from "../GameLiftClient";
+import {
+  TerminateGameSessionInput,
+  TerminateGameSessionOutput,
+} from "../models/models_1";
+export { __MetadataBearer };
+export { $Command };
+export interface TerminateGameSessionCommandInput
+  extends TerminateGameSessionInput {}
+export interface TerminateGameSessionCommandOutput
+  extends TerminateGameSessionOutput,
+    __MetadataBearer {}
+declare const TerminateGameSessionCommand_base: {
+  new (
+    input: TerminateGameSessionCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    TerminateGameSessionCommandInput,
+    TerminateGameSessionCommandOutput,
+    GameLiftClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  new (
+    __0_0: TerminateGameSessionCommandInput
+  ): import("@smithy/smithy-client").CommandImpl<
+    TerminateGameSessionCommandInput,
+    TerminateGameSessionCommandOutput,
+    GameLiftClientResolvedConfig,
+    ServiceInputTypes,
+    ServiceOutputTypes
+  >;
+  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
+};
+export declare class TerminateGameSessionCommand extends TerminateGameSessionCommand_base {
+  protected static __types: {
+    api: {
+      input: TerminateGameSessionInput;
+      output: TerminateGameSessionOutput;
+    };
+    sdk: {
+      input: TerminateGameSessionCommandInput;
+      output: TerminateGameSessionCommandOutput;
+    };
+  };
+}

package/dist-types/ts3.4/commands/index.d.ts

@@ -99,6 +99,7 @@ export * from "./StopGameSessionPlacementCommand";
 export * from "./StopMatchmakingCommand";
 export * from "./SuspendGameServerGroupCommand";
 export * from "./TagResourceCommand";
+export * from "./TerminateGameSessionCommand";
 export * from "./UntagResourceCommand";
 export * from "./UpdateAliasCommand";
 export * from "./UpdateBuildCommand";

package/dist-types/ts3.4/models/models_0.d.ts

@@ -1036,7 +1036,9 @@ export declare const GameSessionStatus: {
 export type GameSessionStatus =
   (typeof GameSessionStatus)[keyof typeof GameSessionStatus];
 export declare const GameSessionStatusReason: {
+  readonly FORCE_TERMINATED: "FORCE_TERMINATED";
   readonly INTERRUPTED: "INTERRUPTED";
+  readonly TRIGGERED_ON_PROCESS_TERMINATE: "TRIGGERED_ON_PROCESS_TERMINATE";
 };
 export type GameSessionStatusReason =
   (typeof GameSessionStatusReason)[keyof typeof GameSessionStatusReason];

package/dist-types/ts3.4/models/models_1.d.ts

@@ -284,6 +284,19 @@ export interface TagResourceRequest {
   Tags: Tag[] | undefined;
 }
 export interface TagResourceResponse {}
+export declare const TerminationMode: {
+  readonly FORCE_TERMINATE: "FORCE_TERMINATE";
+  readonly TRIGGER_ON_PROCESS_TERMINATE: "TRIGGER_ON_PROCESS_TERMINATE";
+};
+export type TerminationMode =
+  (typeof TerminationMode)[keyof typeof TerminationMode];
+export interface TerminateGameSessionInput {
+  GameSessionId: string | undefined;
+  TerminationMode: TerminationMode | undefined;
+}
+export interface TerminateGameSessionOutput {
+  GameSession?: GameSession | undefined;
+}
 export interface UntagResourceRequest {
   ResourceARN: string | undefined;
   TagKeys: string[] | undefined;
@@ -504,6 +517,9 @@ export declare const StartMatchmakingOutputFilterSensitiveLog: (
 export declare const StopGameSessionPlacementOutputFilterSensitiveLog: (
   obj: StopGameSessionPlacementOutput
 ) => any;
+export declare const TerminateGameSessionOutputFilterSensitiveLog: (
+  obj: TerminateGameSessionOutput
+) => any;
 export declare const UpdateContainerFleetInputFilterSensitiveLog: (
   obj: UpdateContainerFleetInput
 ) => any;

package/dist-types/ts3.4/protocols/Aws_json1_1.d.ts

@@ -407,6 +407,10 @@ import {
   TagResourceCommandInput,
   TagResourceCommandOutput,
 } from "../commands/TagResourceCommand";
+import {
+  TerminateGameSessionCommandInput,
+  TerminateGameSessionCommandOutput,
+} from "../commands/TerminateGameSessionCommand";
 import {
   UntagResourceCommandInput,
   UntagResourceCommandOutput,
@@ -875,6 +879,10 @@ export declare const se_TagResourceCommand: (
   input: TagResourceCommandInput,
   context: __SerdeContext
 ) => Promise<__HttpRequest>;
+export declare const se_TerminateGameSessionCommand: (
+  input: TerminateGameSessionCommandInput,
+  context: __SerdeContext
+) => Promise<__HttpRequest>;
 export declare const se_UntagResourceCommand: (
   input: UntagResourceCommandInput,
   context: __SerdeContext
@@ -1343,6 +1351,10 @@ export declare const de_TagResourceCommand: (
   output: __HttpResponse,
   context: __SerdeContext
 ) => Promise<TagResourceCommandOutput>;
+export declare const de_TerminateGameSessionCommand: (
+  output: __HttpResponse,
+  context: __SerdeContext
+) => Promise<TerminateGameSessionCommandOutput>;
 export declare const de_UntagResourceCommand: (
   output: __HttpResponse,
   context: __SerdeContext

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-gamelift",
   "description": "AWS SDK for JavaScript Gamelift Client for Node.js, Browser and React Native",
-  "version": "3.714.0",
+  "version": "3.721.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-gamelift",
@@ -20,40 +20,40 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "5.2.0",
     "@aws-crypto/sha256-js": "5.2.0",
-    "@aws-sdk/client-sso-oidc": "3.714.0",
-    "@aws-sdk/client-sts": "3.714.0",
-    "@aws-sdk/core": "3.714.0",
-    "@aws-sdk/credential-provider-node": "3.714.0",
+    "@aws-sdk/client-sso-oidc": "3.721.0",
+    "@aws-sdk/client-sts": "3.721.0",
+    "@aws-sdk/core": "3.716.0",
+    "@aws-sdk/credential-provider-node": "3.721.0",
     "@aws-sdk/middleware-host-header": "3.714.0",
     "@aws-sdk/middleware-logger": "3.714.0",
     "@aws-sdk/middleware-recursion-detection": "3.714.0",
-    "@aws-sdk/middleware-user-agent": "3.714.0",
+    "@aws-sdk/middleware-user-agent": "3.721.0",
     "@aws-sdk/region-config-resolver": "3.714.0",
     "@aws-sdk/types": "3.714.0",
     "@aws-sdk/util-endpoints": "3.714.0",
     "@aws-sdk/util-user-agent-browser": "3.714.0",
-    "@aws-sdk/util-user-agent-node": "3.714.0",
+    "@aws-sdk/util-user-agent-node": "3.721.0",
     "@smithy/config-resolver": "^3.0.13",
     "@smithy/core": "^2.5.5",
     "@smithy/fetch-http-handler": "^4.1.2",
     "@smithy/hash-node": "^3.0.11",
     "@smithy/invalid-dependency": "^3.0.11",
     "@smithy/middleware-content-length": "^3.0.13",
-    "@smithy/middleware-endpoint": "^3.2.5",
-    "@smithy/middleware-retry": "^3.0.30",
+    "@smithy/middleware-endpoint": "^3.2.6",
+    "@smithy/middleware-retry": "^3.0.31",
     "@smithy/middleware-serde": "^3.0.11",
     "@smithy/middleware-stack": "^3.0.11",
     "@smithy/node-config-provider": "^3.1.12",
     "@smithy/node-http-handler": "^3.3.2",
     "@smithy/protocol-http": "^4.1.8",
-    "@smithy/smithy-client": "^3.5.0",
+    "@smithy/smithy-client": "^3.5.1",
     "@smithy/types": "^3.7.2",
     "@smithy/url-parser": "^3.0.11",
     "@smithy/util-base64": "^3.0.0",
     "@smithy/util-body-length-browser": "^3.0.0",
     "@smithy/util-body-length-node": "^3.0.0",
-    "@smithy/util-defaults-mode-browser": "^3.0.30",
-    "@smithy/util-defaults-mode-node": "^3.0.30",
+    "@smithy/util-defaults-mode-browser": "^3.0.31",
+    "@smithy/util-defaults-mode-node": "^3.0.31",
     "@smithy/util-endpoints": "^2.1.7",
     "@smithy/util-middleware": "^3.0.11",
     "@smithy/util-retry": "^3.0.11",