aws-sdk-gamelift 1.62.0 → 1.63.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a08da55249c4e39f7a3ab16af7625f0cc75387f594a76bab07f23d0f7c687c19
-  data.tar.gz: e59ddb10d86f8955f6fe9b4ebdcb3af81d12974958f325d78bca6e3e6d075733
+  metadata.gz: 86f595da881b4621e4c248b656ca7476d176cec9b077cb742e17e6e0d1b12692
+  data.tar.gz: 7eba1d74cde02868f44a3eecc5007010a930dedf9ccdef11ba7e079eaf660790
 SHA512:
-  metadata.gz: 0d523b13c7ea6c87030d2df5e95aeac9d1d42ede3000bc8e8a6cca26cb402f429e6b7039f162ff7be58dd04fa0afee7288098a0038224467b7e82e7818ef4eae
-  data.tar.gz: b6bb23a224f47120712e56a6e375f7177611b700ea610135cffabb46f32adc9b4c3c1267ba898eb2e06d341c27e2084134d9afc523cb4d4a21dcc329638080f1
+  metadata.gz: 144af29ae9d76827f246e3144b9c86f11f701f9f091441c57b6363afd07df89ac115acd5eae737a28cc5397d587e9eaf1100478b2a1be26d73c20b9fc86a9351
+  data.tar.gz: 00ecd5e78cfcc260d9b14b828fbaf7a716167b1ab33feb0672328c73e1f6b57978817b6060171214c9f689d7def64cbc9ac53f8365d0d64c244f09229454382c

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.63.0 (2023-05-25)
+------------------
+
+* Feature - GameLift FleetIQ users can now filter game server claim requests to exclude servers on instances that are draining.
+
 1.62.0 (2023-04-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.62.0
+1.63.0

data/lib/aws-sdk-gamelift/client.rb

@@ -460,7 +460,9 @@ module Aws::GameLift
     # specify a game server ID, although this approach bypasses Amazon
     # GameLift FleetIQ placement optimization. Optionally, include game data
     # to pass to the game server at the start of a game session, such as a
-    # game map or player information.
+    # game map or player information. Filter options may be included to
+    # further restrict how a game server is chosen, such as only allowing
+    # game servers on `ACTIVE` instances to be claimed.
     #
     # When a game server is successfully claimed, connection information is
     # returned. A claimed game server's utilization status remains
@@ -478,21 +480,17 @@ module Aws::GameLift
     #
     # * If the game server claim status is `CLAIMED`.
     #
-    # <note markdown="1"> When claiming a specific game server, this request will succeed even
-    # if the game server is running on an instance in `DRAINING` status. To
-    # avoid this, first check the instance status by calling
-    # [DescribeGameServerInstances][1] .
-    #
-    #  </note>
+    # * If the game server is running on an instance in `DRAINING` status
+    #   and provided filter option does not allow placing on `DRAINING`
+    #   instances.
     #
     # **Learn more**
     #
-    # [Amazon GameLift FleetIQ Guide][2]
+    # [Amazon GameLift FleetIQ Guide][1]
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameServerInstances.html
-    # [2]: https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/fleetiqguide/gsg-intro.html
     #
     # @option params [required, String] :game_server_group_name
     #   A unique identifier for the game server group where the game server is
@@ -510,6 +508,9 @@ module Aws::GameLift
     #   value. This data is passed to a game client or service when it
     #   requests information on game servers.
     #
+    # @option params [Types::ClaimFilterOption] :filter_option
+    #   Object that restricts how a claimed game server is chosen.
+    #
     # @return [Types::ClaimGameServerOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ClaimGameServerOutput#game_server #game_server} => Types::GameServer
@@ -520,6 +521,9 @@ module Aws::GameLift
     #     game_server_group_name: "GameServerGroupNameOrArn", # required
     #     game_server_id: "GameServerId",
     #     game_server_data: "GameServerData",
+    #     filter_option: {
+    #       instance_statuses: ["ACTIVE"], # accepts ACTIVE, DRAINING
+    #     },
     #   })
     #
     # @example Response structure
@@ -644,25 +648,25 @@ module Aws::GameLift
     # using the CLI command <b> <a
     # href="https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html">upload-build</a>
     # </b>. This helper command combines two tasks: (1) it uploads your
-    # build files from a file directory to a Amazon GameLift Amazon S3
+    # build files from a file directory to an Amazon GameLift Amazon S3
     # location, and (2) it creates a new build resource.
     #
-    # You can use the operation in the following scenarios:
+    # You can use the `CreateBuild` operation in the following scenarios:
     #
-    # * To create a new game build with build files that are in an Amazon S3
+    # * Create a new game build with build files that are in an Amazon S3
     #   location under an Amazon Web Services account that you control. To
     #   use this option, you give Amazon GameLift access to the Amazon S3
     #   bucket. With permissions in place, specify a build name, operating
     #   system, and the Amazon S3 storage location of your game build.
     #
-    # * To directly upload your build files to a Amazon GameLift Amazon S3
-    #   location. To use this option, specify a build name and operating
-    #   system. This operation creates a new build resource and also returns
-    #   an Amazon S3 location with temporary access credentials. Use the
-    #   credentials to manually upload your build files to the specified
-    #   Amazon S3 location. For more information, see [Uploading Objects][1]
-    #   in the *Amazon S3 Developer Guide*. After you upload build files to
-    #   the Amazon GameLift Amazon S3 location, you can't update them.
+    # * Upload your build files to a Amazon GameLift Amazon S3 location. To
+    #   use this option, specify a build name and operating system. This
+    #   operation creates a new build resource and also returns an Amazon S3
+    #   location with temporary access credentials. Use the credentials to
+    #   manually upload your build files to the specified Amazon S3
+    #   location. For more information, see [Uploading Objects][1] in the
+    #   *Amazon S3 Developer Guide*. After you upload build files to the
+    #   Amazon GameLift Amazon S3 location, you can't update them.
     #
     # If successful, this operation creates a new build resource with a
     # unique build ID and places it in `INITIALIZED` status. A build must be
@@ -704,12 +708,19 @@ module Aws::GameLift
     #   `SizeOnDisk` of 0.
     #
     # @option params [String] :operating_system
-    #   The operating system that you built the game server binaries to run
-    #   on. This value determines the type of fleet resources that you can use
-    #   for this build. If your game build contains multiple executables, they
-    #   all must run on the same operating system. If an operating system
-    #   isn't specified when creating a build, Amazon GameLift uses the
-    #   default value (WINDOWS\_2012). This value can't be changed later.
+    #   The operating system that your game server binaries run on. This value
+    #   determines the type of fleet resources that you use for this build. If
+    #   your game build contains multiple executables, they all must run on
+    #   the same operating system. You must specify a valid operating system
+    #   in this request. There is no default value. You can't change a
+    #   build's operating system later.
+    #
+    #   <note markdown="1"> If you have active fleets using the Windows Server 2012 operating
+    #   system, you can continue to create new builds using this OS until
+    #   October 10, 2023, when Microsoft ends its support. All others must use
+    #   Windows Server 2016 when creating new Windows-based builds.
+    #
+    #    </note>
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of labels to assign to the new build resource. Tags are
@@ -1723,7 +1734,8 @@ module Aws::GameLift
     # @option params [Integer] :timeout_in_seconds
     #   The maximum time, in seconds, that a new game session placement
     #   request remains in the queue. When a request exceeds this time, the
-    #   game session placement changes to a `TIMED_OUT` status.
+    #   game session placement changes to a `TIMED_OUT` status. By default,
+    #   this property is set to `600`.
     #
     # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
     #   A set of policies that act as a sliding cap on player latency. FleetIQ
@@ -5684,9 +5696,9 @@ module Aws::GameLift
     end
 
     # Retrieves the location of stored game session logs for a specified
-    # game session. When a game session is terminated, Amazon GameLift
-    # automatically stores the logs in Amazon S3 and retains them for 14
-    # days. Use this URL to download the logs.
+    # game session on Amazon GameLift managed fleets. When a game session is
+    # terminated, Amazon GameLift automatically stores the logs in Amazon S3
+    # and retains them for 14 days. Use this URL to download the logs.
     #
     # <note markdown="1"> See the [Amazon Web Services Service Limits][1] page for maximum log
     # file sizes. Log files that exceed this limit are not saved.
@@ -8804,7 +8816,8 @@ module Aws::GameLift
     # @option params [Integer] :timeout_in_seconds
     #   The maximum time, in seconds, that a new game session placement
     #   request remains in the queue. When a request exceeds this time, the
-    #   game session placement changes to a `TIMED_OUT` status.
+    #   game session placement changes to a `TIMED_OUT` status. By default,
+    #   this property is set to `600`.
     #
     # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
     #   A set of policies that act as a sliding cap on player latency. FleetIQ
@@ -9330,7 +9343,7 @@ module Aws::GameLift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-gamelift'
-      context[:gem_version] = '1.62.0'
+      context[:gem_version] = '1.63.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-gamelift/client_api.rb

@@ -38,6 +38,7 @@ module Aws::GameLift
     BuildStatus = Shapes::StringShape.new(name: 'BuildStatus')
     CertificateConfiguration = Shapes::StructureShape.new(name: 'CertificateConfiguration')
     CertificateType = Shapes::StringShape.new(name: 'CertificateType')
+    ClaimFilterOption = Shapes::StructureShape.new(name: 'ClaimFilterOption')
     ClaimGameServerInput = Shapes::StructureShape.new(name: 'ClaimGameServerInput')
     ClaimGameServerOutput = Shapes::StructureShape.new(name: 'ClaimGameServerOutput')
     ComparisonOperatorType = Shapes::StringShape.new(name: 'ComparisonOperatorType')
@@ -179,6 +180,8 @@ module Aws::GameLift
     EventCode = Shapes::StringShape.new(name: 'EventCode')
     EventList = Shapes::ListShape.new(name: 'EventList')
     FilterConfiguration = Shapes::StructureShape.new(name: 'FilterConfiguration')
+    FilterInstanceStatus = Shapes::StringShape.new(name: 'FilterInstanceStatus')
+    FilterInstanceStatuses = Shapes::ListShape.new(name: 'FilterInstanceStatuses')
     FleetAction = Shapes::StringShape.new(name: 'FleetAction')
     FleetActionList = Shapes::ListShape.new(name: 'FleetActionList')
     FleetArn = Shapes::StringShape.new(name: 'FleetArn')
@@ -536,9 +539,13 @@ module Aws::GameLift
     CertificateConfiguration.add_member(:certificate_type, Shapes::ShapeRef.new(shape: CertificateType, required: true, location_name: "CertificateType"))
     CertificateConfiguration.struct_class = Types::CertificateConfiguration
 
+    ClaimFilterOption.add_member(:instance_statuses, Shapes::ShapeRef.new(shape: FilterInstanceStatuses, location_name: "InstanceStatuses"))
+    ClaimFilterOption.struct_class = Types::ClaimFilterOption
+
     ClaimGameServerInput.add_member(:game_server_group_name, Shapes::ShapeRef.new(shape: GameServerGroupNameOrArn, required: true, location_name: "GameServerGroupName"))
     ClaimGameServerInput.add_member(:game_server_id, Shapes::ShapeRef.new(shape: GameServerId, location_name: "GameServerId"))
     ClaimGameServerInput.add_member(:game_server_data, Shapes::ShapeRef.new(shape: GameServerData, location_name: "GameServerData"))
+    ClaimGameServerInput.add_member(:filter_option, Shapes::ShapeRef.new(shape: ClaimFilterOption, location_name: "FilterOption"))
     ClaimGameServerInput.struct_class = Types::ClaimGameServerInput
 
     ClaimGameServerOutput.add_member(:game_server, Shapes::ShapeRef.new(shape: GameServer, location_name: "GameServer"))
@@ -1099,6 +1106,8 @@ module Aws::GameLift
     FilterConfiguration.add_member(:allowed_locations, Shapes::ShapeRef.new(shape: LocationList, location_name: "AllowedLocations"))
     FilterConfiguration.struct_class = Types::FilterConfiguration
 
+    FilterInstanceStatuses.member = Shapes::ShapeRef.new(shape: FilterInstanceStatus)
+
     FleetActionList.member = Shapes::ShapeRef.new(shape: FleetAction)
 
     FleetAttributes.add_member(:fleet_id, Shapes::ShapeRef.new(shape: FleetId, location_name: "FleetId"))

data/lib/aws-sdk-gamelift/types.rb

@@ -322,6 +322,25 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # **This data type is used with the Amazon GameLift FleetIQ and game
+    # server groups.**
+    #
+    # Filters which game servers may be claimed when calling
+    # `ClaimGameServer`.
+    #
+    # @!attribute [rw] instance_statuses
+    #   List of instance statuses that game servers may be claimed on. If
+    #   provided, the list must contain the `ACTIVE` status.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ClaimFilterOption AWS API Documentation
+    #
+    class ClaimFilterOption < Struct.new(
+      :instance_statuses)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] game_server_group_name
     #   A unique identifier for the game server group where the game server
     #   is running. If you are not specifying a game server to claim, this
@@ -341,12 +360,17 @@ module Aws::GameLift
     #   requests information on game servers.
     #   @return [String]
     #
+    # @!attribute [rw] filter_option
+    #   Object that restricts how a claimed game server is chosen.
+    #   @return [Types::ClaimFilterOption]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ClaimGameServerInput AWS API Documentation
     #
     class ClaimGameServerInput < Struct.new(
       :game_server_group_name,
       :game_server_id,
-      :game_server_data)
+      :game_server_data,
+      :filter_option)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -534,13 +558,19 @@ module Aws::GameLift
     #   @return [Types::S3Location]
     #
     # @!attribute [rw] operating_system
-    #   The operating system that you built the game server binaries to run
-    #   on. This value determines the type of fleet resources that you can
-    #   use for this build. If your game build contains multiple
-    #   executables, they all must run on the same operating system. If an
-    #   operating system isn't specified when creating a build, Amazon
-    #   GameLift uses the default value (WINDOWS\_2012). This value can't
-    #   be changed later.
+    #   The operating system that your game server binaries run on. This
+    #   value determines the type of fleet resources that you use for this
+    #   build. If your game build contains multiple executables, they all
+    #   must run on the same operating system. You must specify a valid
+    #   operating system in this request. There is no default value. You
+    #   can't change a build's operating system later.
+    #
+    #   <note markdown="1"> If you have active fleets using the Windows Server 2012 operating
+    #   system, you can continue to create new builds using this OS until
+    #   October 10, 2023, when Microsoft ends its support. All others must
+    #   use Windows Server 2016 when creating new Windows-based builds.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -1257,7 +1287,8 @@ module Aws::GameLift
     # @!attribute [rw] timeout_in_seconds
     #   The maximum time, in seconds, that a new game session placement
     #   request remains in the queue. When a request exceeds this time, the
-    #   game session placement changes to a `TIMED_OUT` status.
+    #   game session placement changes to a `TIMED_OUT` status. By default,
+    #   this property is set to `600`.
     #   @return [Integer]
     #
     # @!attribute [rw] player_latency_policies
@@ -5106,7 +5137,8 @@ module Aws::GameLift
     # @!attribute [rw] timeout_in_seconds
     #   The maximum time, in seconds, that a new game session placement
     #   request remains in the queue. When a request exceeds this time, the
-    #   game session placement changes to a `TIMED_OUT` status.
+    #   game session placement changes to a `TIMED_OUT` status. By default,
+    #   this property is set to `600`.
     #   @return [Integer]
     #
     # @!attribute [rw] player_latency_policies
@@ -9074,7 +9106,8 @@ module Aws::GameLift
     # @!attribute [rw] timeout_in_seconds
     #   The maximum time, in seconds, that a new game session placement
     #   request remains in the queue. When a request exceeds this time, the
-    #   game session placement changes to a `TIMED_OUT` status.
+    #   game session placement changes to a `TIMED_OUT` status. By default,
+    #   this property is set to `600`.
     #   @return [Integer]
     #
     # @!attribute [rw] player_latency_policies

data/lib/aws-sdk-gamelift.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-gamelift/customizations'
 # @!group service
 module Aws::GameLift
 
-  GEM_VERSION = '1.62.0'
+  GEM_VERSION = '1.63.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-gamelift
 version: !ruby/object:Gem::Version
-  version: 1.62.0
+  version: 1.63.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-20 00:00:00.000000000 Z
+date: 2023-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core