aws-sdk-gamelift 1.21.0 → 1.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7e41196c3b68b25ea1beb5ca4cbd55f3e292f1fc
-  data.tar.gz: e61dee62e0076087403f820ee46dcb500069867c
+  metadata.gz: 350adc0b3d0c1c371def46b25318b18a9546add7
+  data.tar.gz: 36c083a34e829598faab51c929f7295fe1a628bf
 SHA512:
-  metadata.gz: 8dcf785b05c2fa4e7d6bbfc3c252e03e4d81c95dd601ef01cebf9ea7cb1b235edc8c18746ec1006ae23844796b3e743558344f503a5659fc63f93f3fb214fd63
-  data.tar.gz: 8ad34b74f7fa7106f05aba97f86b4b44691ba3e811e0a45a5db77f623e3d02d81c3f04337c2c40006ee866b807a97dcf466f2815d8a15d74560d006644d8a7be
+  metadata.gz: cd8a66e33446e7e4eea317046d488e575b43ea7bca20e52ca6767178438ffbbab5ea02166b17b9d1ba49bf4bf7960723c553f9aeaaa5112589874aa5013ec2ee
+  data.tar.gz: 43d98f6fc4c87eb6c3e05359b764cd4e80b45d275fd85f3819f9a72a09826641324d91e6f1352d6241893f7b0258a8484f9d54bd8f69ead496a4b7f1980b34e8

data/lib/aws-sdk-gamelift.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-gamelift/customizations'
 # @service
 module Aws::GameLift
 
-  GEM_VERSION = '1.21.0'
+  GEM_VERSION = '1.22.0'
 
 end

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

@@ -284,11 +284,19 @@ module Aws::GameLift
     # If any player rejects the match, or if acceptances are not received
     # before a specified timeout, the proposed match is dropped. The
     # matchmaking tickets are then handled in one of two ways: For tickets
-    # where all players accepted the match, the ticket status is returned to
-    # `SEARCHING` to find a new match. For tickets where one or more players
-    # failed to accept the match, the ticket status is set to `FAILED`, and
-    # processing is terminated. A new matchmaking request for these players
-    # can be submitted as needed.
+    # where one or more players rejected the match, the ticket status is
+    # returned to `SEARCHING` to find a new match. For tickets where one or
+    # more players failed to respond, the ticket status is set to
+    # `CANCELLED`, and processing is terminated. A new matchmaking request
+    # for these players can be submitted as needed.
+    #
+    # **Learn more**
+    #
+    # [ Add FlexMatch to a Game Client][1]
+    #
+    # [ FlexMatch Events Reference][2]
+    #
+    # **Related operations**
     #
     # * StartMatchmaking
     #
@@ -300,6 +308,11 @@ module Aws::GameLift
     #
     # * StartMatchBackfill
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
+    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-events.html
+    #
     # @option params [required, String] :ticket_id
     #   Unique identifier for a matchmaking ticket. The ticket must be in
     #   status `REQUIRES_ACCEPTANCE`; otherwise this request will fail.
@@ -1157,22 +1170,22 @@ module Aws::GameLift
     # use when placing a new game session for the match; and the maximum
     # time allowed for a matchmaking attempt.
     #
-    # **Player acceptance** -- In each configuration, you have the option to
-    # require that all players accept participation in a proposed match. To
-    # enable this feature, set *AcceptanceRequired* to true and specify a
-    # time limit for player acceptance. Players have the option to accept or
-    # reject a proposed match, and a match does not move ahead to game
-    # session placement unless all matched players accept.
-    #
-    # **Matchmaking status notification** -- There are two ways to track the
-    # progress of matchmaking tickets: (1) polling ticket status with
-    # DescribeMatchmaking; or (2) receiving notifications with Amazon Simple
-    # Notification Service (SNS). To use notifications, you first need to
-    # set up an SNS topic to receive the notifications, and provide the
-    # topic ARN in the matchmaking configuration (see [ Setting up
-    # Notifications for Matchmaking][1]). Since notifications promise only
-    # "best effort" delivery, we recommend calling `DescribeMatchmaking`
-    # if no notifications are received within 30 seconds.
+    # There are two ways to track the progress of matchmaking tickets: (1)
+    # polling ticket status with DescribeMatchmaking; or (2) receiving
+    # notifications with Amazon Simple Notification Service (SNS). To use
+    # notifications, you first need to set up an SNS topic to receive the
+    # notifications, and provide the topic ARN in the matchmaking
+    # configuration. Since notifications promise only "best effort"
+    # delivery, we recommend calling `DescribeMatchmaking` if no
+    # notifications are received within 30 seconds.
+    #
+    # **Learn more**
+    #
+    # [ Design a FlexMatch Matchmaker][1]
+    #
+    # [ Setting up Notifications for Matchmaking][2]
+    #
+    # **Related operations**
     #
     # * CreateMatchmakingConfiguration
     #
@@ -1192,7 +1205,8 @@ module Aws::GameLift
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-configuration.html
+    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
     #
     # @option params [required, String] :name
     #   Unique identifier for a matchmaking configuration. This name is used
@@ -1205,10 +1219,10 @@ module Aws::GameLift
     # @option params [required, Array<String>] :game_session_queue_arns
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
-    #   These queues are used when placing game sessions for matches that are
-    #   created with this matchmaking configuration. Queues can be located in
-    #   any region.
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`. These queues are used when placing game sessions for matches
+    #   that are created with this matchmaking configuration. Queues can be
+    #   located in any region.
     #
     #
     #
@@ -1216,8 +1230,8 @@ module Aws::GameLift
     #
     # @option params [required, Integer] :request_timeout_seconds
     #   Maximum duration, in seconds, that a matchmaking ticket can remain in
-    #   process before timing out. Requests that time out can be resubmitted
-    #   as needed.
+    #   process before timing out. Requests that fail due to timing out can be
+    #   resubmitted as needed.
     #
     # @option params [Integer] :acceptance_timeout_seconds
     #   Length of time (in seconds) to wait for players to accept a proposed
@@ -1225,7 +1239,7 @@ module Aws::GameLift
     #   timeout, the ticket continues to look for an acceptable match.
     #
     # @option params [required, Boolean] :acceptance_required
-    #   Flag that determines whether or not a match that was created with this
+    #   Flag that determines whether a match that was created with this
     #   configuration must be accepted by the matched players. To require
     #   acceptance, set to TRUE.
     #
@@ -1244,7 +1258,7 @@ module Aws::GameLift
     #   only 10 players are selected for the match.
     #
     # @option params [String] :custom_event_data
-    #   Information to attached to all events related to the matchmaking
+    #   Information to be added to all events related to this matchmaking
     #   configuration.
     #
     # @option params [Array<Types::GameProperty>] :game_properties
@@ -1269,6 +1283,18 @@ module Aws::GameLift
     #
     #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
     #
+    # @option params [String] :backfill_mode
+    #   Method used to backfill game sessions created with this matchmaking
+    #   configuration. Specify MANUAL when your game manages backfill requests
+    #   manually or does not use the match backfill feature. Specify AUTOMATIC
+    #   to have GameLift create a StartMatchBackfill request whenever a game
+    #   session has one or more open slots. Learn more about manual and
+    #   automatic backfill in [ Backfill Existing Games with FlexMatch][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
+    #
     # @return [Types::CreateMatchmakingConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateMatchmakingConfigurationOutput#configuration #configuration} => Types::MatchmakingConfiguration
@@ -1293,6 +1319,7 @@ module Aws::GameLift
     #       },
     #     ],
     #     game_session_data: "GameSessionData",
+    #     backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
     #   })
     #
     # @example Response structure
@@ -1313,6 +1340,7 @@ module Aws::GameLift
     #   resp.configuration.game_properties[0].key #=> String
     #   resp.configuration.game_properties[0].value #=> String
     #   resp.configuration.game_session_data #=> String
+    #   resp.configuration.backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateMatchmakingConfiguration AWS API Documentation
     #
@@ -1331,7 +1359,7 @@ module Aws::GameLift
     #
     # To create a matchmaking rule set, provide unique rule set name and the
     # rule set body in JSON format. Rule sets must be defined in the same
-    # region as the matchmaking configuration they will be used with.
+    # region as the matchmaking configuration they are used with.
     #
     # Since matchmaking rule sets cannot be edited, it is a good idea to
     # check the rule set syntax using ValidateMatchmakingRuleSet before
@@ -1376,9 +1404,9 @@ module Aws::GameLift
     #   in the rule set body.)
     #
     # @option params [required, String] :rule_set_body
-    #   Collection of matchmaking rules, formatted as a JSON string. Note that
-    #   comments are not allowed in JSON, but most elements support a
-    #   description field.
+    #   Collection of matchmaking rules, formatted as a JSON string. Comments
+    #   are not allowed in JSON, but most elements support a description
+    #   field.
     #
     # @return [Types::CreateMatchmakingRuleSetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1942,6 +1970,12 @@ module Aws::GameLift
     # must set the fleet's desired capacity to zero. See
     # UpdateFleetCapacity.
     #
+    # If the fleet being deleted has a VPC peering connection, you first
+    # need to get a valid authorization (good for 24 hours) by calling
+    # CreateVpcPeeringAuthorization. You do not need to explicitly delete
+    # the VPC peering connection--this is done as part of the delete fleet
+    # process.
+    #
     # This action removes the fleet's resources and the fleet record. Once
     # a fleet is deleted, you can no longer use that fleet.
     #
@@ -2050,6 +2084,8 @@ module Aws::GameLift
     # specify the configuration name. A matchmaking configuration cannot be
     # deleted if it is being used in any active matchmaking tickets.
     #
+    # **Related operations**
+    #
     # * CreateMatchmakingConfiguration
     #
     # * DescribeMatchmakingConfigurations
@@ -2244,8 +2280,8 @@ module Aws::GameLift
     end
 
     # Cancels a pending VPC peering authorization for the specified VPC. If
-    # the authorization has already been used to create a peering
-    # connection, call DeleteVpcPeeringConnection to remove the connection.
+    # you need to delete an existing VPC peering connection, call
+    # DeleteVpcPeeringConnection.
     #
     # * CreateVpcPeeringAuthorization
     #
@@ -3534,6 +3570,14 @@ module Aws::GameLift
     # If the request is successful, a ticket object is returned for each
     # requested ID that currently exists.
     #
+    # **Learn more**
+    #
+    # [ Add FlexMatch to a Game Client][1]
+    #
+    # [ Set Up FlexMatch Event Notification][2]
+    #
+    # **Related operations**
+    #
     # * StartMatchmaking
     #
     # * DescribeMatchmaking
@@ -3544,6 +3588,11 @@ module Aws::GameLift
     #
     # * StartMatchBackfill
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
+    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguidematch-notification.html
+    #
     # @option params [required, Array<String>] :ticket_ids
     #   Unique identifier for a matchmaking ticket. You can include up to 10
     #   ID values.
@@ -3592,7 +3641,7 @@ module Aws::GameLift
       req.send_request(options)
     end
 
-    # Retrieves the details of FlexMatch matchmaking configurations. with
+    # Retrieves the details of FlexMatch matchmaking configurations. With
     # this operation, you have the following options: (1) retrieve all
     # existing configurations, (2) provide the names of one or more
     # configurations to retrieve, or (3) retrieve all configurations that
@@ -3602,6 +3651,12 @@ module Aws::GameLift
     # name. When specifying a list of names, only configurations that
     # currently exist are returned.
     #
+    # **Learn more**
+    #
+    # [ Setting Up FlexMatch Matchmakers][1]
+    #
+    # **Related operations**
+    #
     # * CreateMatchmakingConfiguration
     #
     # * DescribeMatchmakingConfigurations
@@ -3618,6 +3673,10 @@ module Aws::GameLift
     #
     # * DeleteMatchmakingRuleSet
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/matchmaker-build.html
+    #
     # @option params [Array<String>] :names
     #   Unique identifier for a matchmaking configuration(s) to retrieve. To
     #   request all existing configurations, leave this parameter empty.
@@ -3669,6 +3728,7 @@ module Aws::GameLift
     #   resp.configurations[0].game_properties[0].key #=> String
     #   resp.configurations[0].game_properties[0].value #=> String
     #   resp.configurations[0].game_session_data #=> String
+    #   resp.configurations[0].backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeMatchmakingConfigurations AWS API Documentation
@@ -5506,9 +5566,7 @@ module Aws::GameLift
     # that describes all current players in the game session. If successful,
     # a match backfill ticket is created and returned with status set to
     # QUEUED. The ticket is placed in the matchmaker's ticket pool and
-    # processed. Track the status of the ticket to respond as needed. For
-    # more detail how to set up backfilling, see [ Backfill Existing Games
-    # with FlexMatch][1].
+    # processed. Track the status of the ticket to respond as needed.
     #
     # The process of finding backfill matches is essentially identical to
     # the initial matchmaking process. The matchmaker searches the pool and
@@ -5518,7 +5576,15 @@ module Aws::GameLift
     # the match are updated with the game session's connection information,
     # and the GameSession object is updated to include matchmaker data on
     # the new players. For more detail on how match backfill requests are
-    # processed, see [ How Amazon GameLift FlexMatch Works][2].
+    # processed, see [ How Amazon GameLift FlexMatch Works][1].
+    #
+    # **Learn more**
+    #
+    # [ Backfill Existing Games with FlexMatch][2]
+    #
+    # [ How GameLift FlexMatch Works][1]
+    #
+    # **Related operations**
     #
     # * StartMatchmaking
     #
@@ -5532,8 +5598,8 @@ module Aws::GameLift
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
-    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-intro.html
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-match.html
+    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
     #
     # @option params [String] :ticket_id
     #   Unique identifier for a matchmaking ticket. If no ticket ID is
@@ -5644,9 +5710,7 @@ module Aws::GameLift
     # start with a single player or a group of players who want to play
     # together. FlexMatch finds additional players as needed to fill the
     # match. Match type, rules, and the queue used to place a new game
-    # session are defined in a `MatchmakingConfiguration`. For complete
-    # information on setting up and using FlexMatch, see the topic [ Adding
-    # FlexMatch to Your Game][1].
+    # session are defined in a `MatchmakingConfiguration`.
     #
     # To start matchmaking, provide a unique ticket ID, specify a
     # matchmaking configuration, and include the players to be matched. You
@@ -5704,6 +5768,18 @@ module Aws::GameLift
     #     matchmaking tickets. Matched players can use the connection
     #     information to join the game.
     #
+    # **Learn more**
+    #
+    # [ Add FlexMatch to a Game Client][1]
+    #
+    # [ Set Up FlexMatch Event Notification][2]
+    #
+    # [ FlexMatch Integration Roadmap][3]
+    #
+    # [ How GameLift FlexMatch Works][4]
+    #
+    # **Related operations**
+    #
     # * StartMatchmaking
     #
     # * DescribeMatchmaking
@@ -5716,7 +5792,10 @@ module Aws::GameLift
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-intro.html
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
+    # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
+    # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-tasks.html
+    # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-match.html
     #
     # @option params [String] :ticket_id
     #   Unique identifier for a matchmaking ticket. If no ticket ID is
@@ -5950,10 +6029,27 @@ module Aws::GameLift
       req.send_request(options)
     end
 
-    # Cancels a matchmaking ticket that is currently being processed. To
-    # stop the matchmaking operation, specify the ticket ID. If successful,
-    # work on the ticket is stopped, and the ticket status is changed to
-    # `CANCELLED`.
+    # Cancels a matchmaking ticket or match backfill ticket that is
+    # currently being processed. To stop the matchmaking operation, specify
+    # the ticket ID. If successful, work on the ticket is stopped, and the
+    # ticket status is changed to `CANCELLED`.
+    #
+    # This call is also used to turn off automatic backfill for an
+    # individual game session. This is for game sessions that are created
+    # with a matchmaking configuration that has automatic backfill enabled.
+    # The ticket ID is included in the `MatchmakerData` of an updated game
+    # session object, which is provided to the game server.
+    #
+    # <note markdown="1"> If the action is successful, the service sends back an empty JSON
+    # struct with the HTTP 200 response (not an empty HTTP body).
+    #
+    #  </note>
+    #
+    # **Learn more**
+    #
+    # [ Add FlexMatch to a Game Client][1]
+    #
+    # **Related operations**
     #
     # * StartMatchmaking
     #
@@ -5965,6 +6061,10 @@ module Aws::GameLift
     #
     # * StartMatchBackfill
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
+    #
     # @option params [required, String] :ticket_id
     #   Unique identifier for a matchmaking ticket.
     #
@@ -6628,9 +6728,16 @@ module Aws::GameLift
       req.send_request(options)
     end
 
-    # Updates settings for a FlexMatch matchmaking configuration. To update
-    # settings, specify the configuration name to be updated and provide the
-    # new settings.
+    # Updates settings for a FlexMatch matchmaking configuration. These
+    # changes affect all matches and game sessions that are created after
+    # the update. To update settings, specify the configuration name to be
+    # updated and provide the new settings.
+    #
+    # **Learn more**
+    #
+    # [ Design a FlexMatch Matchmaker][1]
+    #
+    # **Related operations**
     #
     # * CreateMatchmakingConfiguration
     #
@@ -6648,6 +6755,10 @@ module Aws::GameLift
     #
     # * DeleteMatchmakingRuleSet
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-configuration.html
+    #
     # @option params [required, String] :name
     #   Unique identifier for a matchmaking configuration to update.
     #
@@ -6657,10 +6768,10 @@ module Aws::GameLift
     # @option params [Array<String>] :game_session_queue_arns
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
-    #   These queues are used when placing game sessions for matches that are
-    #   created with this matchmaking configuration. Queues can be located in
-    #   any region.
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`. These queues are used when placing game sessions for matches
+    #   that are created with this matchmaking configuration. Queues can be
+    #   located in any region.
     #
     #
     #
@@ -6668,8 +6779,8 @@ module Aws::GameLift
     #
     # @option params [Integer] :request_timeout_seconds
     #   Maximum duration, in seconds, that a matchmaking ticket can remain in
-    #   process before timing out. Requests that time out can be resubmitted
-    #   as needed.
+    #   process before timing out. Requests that fail due to timing out can be
+    #   resubmitted as needed.
     #
     # @option params [Integer] :acceptance_timeout_seconds
     #   Length of time (in seconds) to wait for players to accept a proposed
@@ -6677,7 +6788,7 @@ module Aws::GameLift
     #   timeout, the ticket continues to look for an acceptable match.
     #
     # @option params [Boolean] :acceptance_required
-    #   Flag that determines whether or not a match that was created with this
+    #   Flag that determines whether a match that was created with this
     #   configuration must be accepted by the matched players. To require
     #   acceptance, set to TRUE.
     #
@@ -6701,7 +6812,7 @@ module Aws::GameLift
     #   only 10 players are selected for the match.
     #
     # @option params [String] :custom_event_data
-    #   Information to attached to all events related to the matchmaking
+    #   Information to add to all events related to the matchmaking
     #   configuration.
     #
     # @option params [Array<Types::GameProperty>] :game_properties
@@ -6726,6 +6837,18 @@ module Aws::GameLift
     #
     #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
     #
+    # @option params [String] :backfill_mode
+    #   Method used to backfill game sessions created with this matchmaking
+    #   configuration. Specify MANUAL when your game manages backfill requests
+    #   manually or does not use the match backfill feature. Specify AUTOMATIC
+    #   to have GameLift create a StartMatchBackfill request whenever a game
+    #   session has one or more open slots. Learn more about manual and
+    #   automatic backfill in [Backfill Existing Games with FlexMatch][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
+    #
     # @return [Types::UpdateMatchmakingConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateMatchmakingConfigurationOutput#configuration #configuration} => Types::MatchmakingConfiguration
@@ -6750,6 +6873,7 @@ module Aws::GameLift
     #       },
     #     ],
     #     game_session_data: "GameSessionData",
+    #     backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
     #   })
     #
     # @example Response structure
@@ -6770,6 +6894,7 @@ module Aws::GameLift
     #   resp.configuration.game_properties[0].key #=> String
     #   resp.configuration.game_properties[0].value #=> String
     #   resp.configuration.game_session_data #=> String
+    #   resp.configuration.backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateMatchmakingConfiguration AWS API Documentation
     #
@@ -7077,7 +7202,7 @@ module Aws::GameLift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-gamelift'
-      context[:gem_version] = '1.21.0'
+      context[:gem_version] = '1.22.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -20,6 +20,7 @@ module Aws::GameLift
     ArnStringModel = Shapes::StringShape.new(name: 'ArnStringModel')
     AttributeValue = Shapes::StructureShape.new(name: 'AttributeValue')
     AwsCredentials = Shapes::StructureShape.new(name: 'AwsCredentials')
+    BackfillMode = Shapes::StringShape.new(name: 'BackfillMode')
     BooleanModel = Shapes::BooleanShape.new(name: 'BooleanModel')
     Build = Shapes::StructureShape.new(name: 'Build')
     BuildId = Shapes::StringShape.new(name: 'BuildId')
@@ -434,6 +435,7 @@ module Aws::GameLift
     CreateMatchmakingConfigurationInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: CustomEventData, location_name: "CustomEventData"))
     CreateMatchmakingConfigurationInput.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
     CreateMatchmakingConfigurationInput.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
+    CreateMatchmakingConfigurationInput.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
     CreateMatchmakingConfigurationInput.struct_class = Types::CreateMatchmakingConfigurationInput
 
     CreateMatchmakingConfigurationOutput.add_member(:configuration, Shapes::ShapeRef.new(shape: MatchmakingConfiguration, location_name: "Configuration"))
@@ -984,6 +986,7 @@ module Aws::GameLift
     MatchmakingConfiguration.add_member(:creation_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreationTime"))
     MatchmakingConfiguration.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
     MatchmakingConfiguration.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
+    MatchmakingConfiguration.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
     MatchmakingConfiguration.struct_class = Types::MatchmakingConfiguration
 
     MatchmakingConfigurationList.member = Shapes::ShapeRef.new(shape: MatchmakingConfiguration)
@@ -1307,6 +1310,7 @@ module Aws::GameLift
     UpdateMatchmakingConfigurationInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: CustomEventData, location_name: "CustomEventData"))
     UpdateMatchmakingConfigurationInput.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
     UpdateMatchmakingConfigurationInput.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
+    UpdateMatchmakingConfigurationInput.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
     UpdateMatchmakingConfigurationInput.struct_class = Types::UpdateMatchmakingConfigurationInput
 
     UpdateMatchmakingConfigurationOutput.add_member(:configuration, Shapes::ShapeRef.new(shape: MatchmakingConfiguration, location_name: "Configuration"))

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

@@ -111,8 +111,8 @@ module Aws::GameLift
 
     # Values for use in Player attribute key:value pairs. This object lets
     # you specify an attribute value using any of the valid data types:
-    # string, number, string array or data map. Each `AttributeValue` object
-    # can use only one of the available properties.
+    # string, number, string array, or data map. Each `AttributeValue`
+    # object can use only one of the available properties.
     #
     # @note When making an API call, you may pass AttributeValue
     #   data as a hash:
@@ -875,6 +875,7 @@ module Aws::GameLift
     #           },
     #         ],
     #         game_session_data: "GameSessionData",
+    #         backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
     #       }
     #
     # @!attribute [rw] name
@@ -890,9 +891,9 @@ module Aws::GameLift
     # @!attribute [rw] game_session_queue_arns
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
-    #   These queues are used when placing game sessions for matches that
-    #   are created with this matchmaking configuration. Queues can be
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`. These queues are used when placing game sessions for matches
+    #   that are created with this matchmaking configuration. Queues can be
     #   located in any region.
     #
     #
@@ -902,8 +903,8 @@ module Aws::GameLift
     #
     # @!attribute [rw] request_timeout_seconds
     #   Maximum duration, in seconds, that a matchmaking ticket can remain
-    #   in process before timing out. Requests that time out can be
-    #   resubmitted as needed.
+    #   in process before timing out. Requests that fail due to timing out
+    #   can be resubmitted as needed.
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_timeout_seconds
@@ -913,9 +914,9 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_required
-    #   Flag that determines whether or not a match that was created with
-    #   this configuration must be accepted by the matched players. To
-    #   require acceptance, set to TRUE.
+    #   Flag that determines whether a match that was created with this
+    #   configuration must be accepted by the matched players. To require
+    #   acceptance, set to TRUE.
     #   @return [Boolean]
     #
     # @!attribute [rw] rule_set_name
@@ -936,7 +937,7 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] custom_event_data
-    #   Information to attached to all events related to the matchmaking
+    #   Information to be added to all events related to this matchmaking
     #   configuration.
     #   @return [String]
     #
@@ -964,6 +965,20 @@ module Aws::GameLift
     #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
     #   @return [String]
     #
+    # @!attribute [rw] backfill_mode
+    #   Method used to backfill game sessions created with this matchmaking
+    #   configuration. Specify MANUAL when your game manages backfill
+    #   requests manually or does not use the match backfill feature.
+    #   Specify AUTOMATIC to have GameLift create a StartMatchBackfill
+    #   request whenever a game session has one or more open slots. Learn
+    #   more about manual and automatic backfill in [ Backfill Existing
+    #   Games with FlexMatch][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateMatchmakingConfigurationInput AWS API Documentation
     #
     class CreateMatchmakingConfigurationInput < Struct.new(
@@ -978,7 +993,8 @@ module Aws::GameLift
       :additional_player_count,
       :custom_event_data,
       :game_properties,
-      :game_session_data)
+      :game_session_data,
+      :backfill_mode)
       include Aws::Structure
     end
 
@@ -1013,8 +1029,8 @@ module Aws::GameLift
     #   @return [String]
     #
     # @!attribute [rw] rule_set_body
-    #   Collection of matchmaking rules, formatted as a JSON string. Note
-    #   that comments are not allowed in JSON, but most elements support a
+    #   Collection of matchmaking rules, formatted as a JSON string.
+    #   Comments are not allowed in JSON, but most elements support a
     #   description field.
     #   @return [String]
     #
@@ -3904,7 +3920,8 @@ module Aws::GameLift
     # @!attribute [rw] game_session_queue_arn
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`.
     #
     #
     #
@@ -4608,9 +4625,9 @@ module Aws::GameLift
     # @!attribute [rw] game_session_queue_arns
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
-    #   These queues are used when placing game sessions for matches that
-    #   are created with this matchmaking configuration. Queues can be
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`. These queues are used when placing game sessions for matches
+    #   that are created with this matchmaking configuration. Queues can be
     #   located in any region.
     #
     #
@@ -4620,8 +4637,8 @@ module Aws::GameLift
     #
     # @!attribute [rw] request_timeout_seconds
     #   Maximum duration, in seconds, that a matchmaking ticket can remain
-    #   in process before timing out. Requests that time out can be
-    #   resubmitted as needed.
+    #   in process before timing out. Requests that fail due to timing out
+    #   can be resubmitted as needed.
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_timeout_seconds
@@ -4631,9 +4648,9 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_required
-    #   Flag that determines whether or not a match that was created with
-    #   this configuration must be accepted by the matched players. To
-    #   require acceptance, set to TRUE.
+    #   Flag that determines whether a match that was created with this
+    #   configuration must be accepted by the matched players. To require
+    #   acceptance, set to TRUE.
     #   @return [Boolean]
     #
     # @!attribute [rw] rule_set_name
@@ -4654,7 +4671,7 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] custom_event_data
-    #   Information to attached to all events related to the matchmaking
+    #   Information to attach to all events related to the matchmaking
     #   configuration.
     #   @return [String]
     #
@@ -4688,6 +4705,20 @@ module Aws::GameLift
     #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
     #   @return [String]
     #
+    # @!attribute [rw] backfill_mode
+    #   Method used to backfill game sessions created with this matchmaking
+    #   configuration. MANUAL indicates that the game makes backfill
+    #   requests or does not use the match backfill feature. AUTOMATIC
+    #   indicates that GameLift creates StartMatchBackfill requests whenever
+    #   a game session has one or more open slots. Learn more about manual
+    #   and automatic backfill in [Backfill Existing Games with
+    #   FlexMatch][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/MatchmakingConfiguration AWS API Documentation
     #
     class MatchmakingConfiguration < Struct.new(
@@ -4703,15 +4734,15 @@ module Aws::GameLift
       :custom_event_data,
       :creation_time,
       :game_properties,
-      :game_session_data)
+      :game_session_data,
+      :backfill_mode)
       include Aws::Structure
     end
 
     # Set of rule statements, used with FlexMatch, that determine how to
-    # build a certain kind of player match. Each rule set describes a type
-    # of group to be created and defines the parameters for acceptable
-    # player matches. Rule sets are used in MatchmakingConfiguration
-    # objects.
+    # build your player matches. Each rule set describes a type of group to
+    # be created and defines the parameters for acceptable player matches.
+    # Rule sets are used in MatchmakingConfiguration objects.
     #
     # A rule set may define the following elements for a match. For detailed
     # information and examples showing how to construct a rule set, see
@@ -4753,9 +4784,9 @@ module Aws::GameLift
     #   @return [String]
     #
     # @!attribute [rw] rule_set_body
-    #   Collection of matchmaking rules, formatted as a JSON string. (Note
-    #   that comments14 are not allowed in JSON, but most elements support a
-    #   description field.)
+    #   Collection of matchmaking rules, formatted as a JSON string.
+    #   Comments are not allowed in JSON, but most elements support a
+    #   description field.
     #   @return [String]
     #
     # @!attribute [rw] creation_time
@@ -4810,12 +4841,11 @@ module Aws::GameLift
     #     ready to host the players. A ticket in this state contains the
     #     necessary connection information for players.
     #
-    #   * **FAILED** -- The matchmaking request was not completed. Tickets
-    #     with players who fail to accept a proposed match are placed in
-    #     `FAILED` status.
+    #   * **FAILED** -- The matchmaking request was not completed.
     #
-    #   * **CANCELLED** -- The matchmaking request was canceled with a call
-    #     to StopMatchmaking.
+    #   * **CANCELLED** -- The matchmaking request was canceled. This may be
+    #     the result of a call to StopMatchmaking or a proposed match that
+    #     one or more players failed to accept.
     #
     #   * **TIMED\_OUT** -- The matchmaking request was not successful
     #     within the duration specified in the matchmaking configuration.
@@ -5453,43 +5483,17 @@ module Aws::GameLift
 
     # Routing configuration for a fleet alias.
     #
-    # * CreateFleet
-    #
-    # * ListFleets
-    #
-    # * DeleteFleet
-    #
-    # * Describe fleets:
-    #
-    #   * DescribeFleetAttributes
-    #
-    #   * DescribeFleetCapacity
-    #
-    #   * DescribeFleetPortSettings
-    #
-    #   * DescribeFleetUtilization
-    #
-    #   * DescribeRuntimeConfiguration
-    #
-    #   * DescribeEC2InstanceLimits
-    #
-    #   * DescribeFleetEvents
-    #
-    # * Update fleets:
-    #
-    #   * UpdateFleetAttributes
-    #
-    #   * UpdateFleetCapacity
+    # * CreateAlias
     #
-    #   * UpdateFleetPortSettings
+    # * ListAliases
     #
-    #   * UpdateRuntimeConfiguration
+    # * DescribeAlias
     #
-    # * Manage fleet actions:
+    # * UpdateAlias
     #
-    #   * StartFleetActions
+    # * DeleteAlias
     #
-    #   * StopFleetActions
+    # * ResolveAlias
     #
     # @note When making an API call, you may pass RoutingStrategy
     #   data as a hash:
@@ -7044,6 +7048,7 @@ module Aws::GameLift
     #           },
     #         ],
     #         game_session_data: "GameSessionData",
+    #         backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
     #       }
     #
     # @!attribute [rw] name
@@ -7057,9 +7062,9 @@ module Aws::GameLift
     # @!attribute [rw] game_session_queue_arns
     #   Amazon Resource Name ([ARN][1]) that is assigned to a game session
     #   queue and uniquely identifies it. Format is
-    #   `arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912`.
-    #   These queues are used when placing game sessions for matches that
-    #   are created with this matchmaking configuration. Queues can be
+    #   `arn:aws:gamelift:<region>:<aws account>:gamesessionqueue/<queue
+    #   name>`. These queues are used when placing game sessions for matches
+    #   that are created with this matchmaking configuration. Queues can be
     #   located in any region.
     #
     #
@@ -7069,8 +7074,8 @@ module Aws::GameLift
     #
     # @!attribute [rw] request_timeout_seconds
     #   Maximum duration, in seconds, that a matchmaking ticket can remain
-    #   in process before timing out. Requests that time out can be
-    #   resubmitted as needed.
+    #   in process before timing out. Requests that fail due to timing out
+    #   can be resubmitted as needed.
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_timeout_seconds
@@ -7080,9 +7085,9 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] acceptance_required
-    #   Flag that determines whether or not a match that was created with
-    #   this configuration must be accepted by the matched players. To
-    #   require acceptance, set to TRUE.
+    #   Flag that determines whether a match that was created with this
+    #   configuration must be accepted by the matched players. To require
+    #   acceptance, set to TRUE.
     #   @return [Boolean]
     #
     # @!attribute [rw] rule_set_name
@@ -7109,7 +7114,7 @@ module Aws::GameLift
     #   @return [Integer]
     #
     # @!attribute [rw] custom_event_data
-    #   Information to attached to all events related to the matchmaking
+    #   Information to add to all events related to the matchmaking
     #   configuration.
     #   @return [String]
     #
@@ -7137,6 +7142,20 @@ module Aws::GameLift
     #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
     #   @return [String]
     #
+    # @!attribute [rw] backfill_mode
+    #   Method used to backfill game sessions created with this matchmaking
+    #   configuration. Specify MANUAL when your game manages backfill
+    #   requests manually or does not use the match backfill feature.
+    #   Specify AUTOMATIC to have GameLift create a StartMatchBackfill
+    #   request whenever a game session has one or more open slots. Learn
+    #   more about manual and automatic backfill in [Backfill Existing Games
+    #   with FlexMatch][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateMatchmakingConfigurationInput AWS API Documentation
     #
     class UpdateMatchmakingConfigurationInput < Struct.new(
@@ -7151,7 +7170,8 @@ module Aws::GameLift
       :additional_player_count,
       :custom_event_data,
       :game_properties,
-      :game_session_data)
+      :game_session_data,
+      :backfill_mode)
       include Aws::Structure
     end
 
@@ -7331,7 +7351,7 @@ module Aws::GameLift
     # Represents the returned data in response to a request action.
     #
     # @!attribute [rw] valid
-    #   Response indicating whether or not the rule set is valid.
+    #   Response indicating whether the rule set is valid.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ValidateMatchmakingRuleSetOutput AWS API Documentation

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-gamelift
 version: !ruby/object:Gem::Version
-  version: 1.21.0
+  version: 1.22.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-01 00:00:00.000000000 Z
+date: 2019-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core