aws-sdk-gamelift 1.0.0.rc2 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be7ce9fdbd8e0dcb8fdc9fbabd7822088ea8a834
-  data.tar.gz: 0a95207599c67cca0aa24c07adb0f95762a5fe82
+  metadata.gz: 9ec5f43c52a6d58361e22ccf1b13bcc92dd110c3
+  data.tar.gz: 610d460a1949a4ce307e0d4f682f0dceac77e1a1
 SHA512:
-  metadata.gz: 12a7cf6ee6632bf40038551f381dbc480e34574550e2bd4c79b558aa59e35dd1a416e567cae49f38157abe90316c25fedc98c4d65c7c46fccf61cb2190a0b913
-  data.tar.gz: 157eb13d15744f4911a8561c3fafb6bc0fc5200a8a45c8e88999d15d1a3fd2b21033d90d44ac993d4ecd05592c5f2b94489113b37f2868c21a3d3162865e3d94
+  metadata.gz: 7546d02e30486f47f053d31eb74c8bda5c998aa4fc8fbbc6dc3ef3842789cff1ceb59e7ac07f8c1719b47ab6cd0adecac01977ebbf3e2f84cf876f8d013c7b0f
+  data.tar.gz: 1fb0d9686b4da3ba9d9625536de7d45dc8f0fc3e57ed81c830582233500ecfd73017c5911912134cb053e9cbb6af1c75d7292b0b172f61953d1347b0a499e8b7

data/lib/aws-sdk-gamelift.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-gamelift/customizations'
 # @service
 module Aws::GameLift
 
-  GEM_VERSION = '1.0.0.rc2'
+  GEM_VERSION = '1.0.0.rc3'
 
 end

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

@@ -18,6 +18,7 @@ require 'aws-sdk-core/plugins/regional_endpoint.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -45,6 +46,7 @@ module Aws::GameLift
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -532,18 +534,30 @@ module Aws::GameLift
     # specified fleet to host the game session. A fleet must have an
     # `ACTIVE` status before a game session can be created in it.
     #
-    # To create a game session, specify either fleet ID or alias ID, and
+    # To create a game session, specify either fleet ID or alias ID and
     # indicate a maximum number of players to allow in the game session. You
     # can also provide a name and game-specific properties for this game
     # session. If successful, a GameSession object is returned containing
-    # session properties, including an IP address. By default, newly created
-    # game sessions allow new players to join. Use UpdateGameSession to
-    # change the game session's player session creation policy.
+    # game session properties, including a game session ID with the custom
+    # string you provided.
     #
-    # When creating a game session on a fleet with a resource limit creation
-    # policy, the request should include a creator ID. If none is provided,
-    # Amazon GameLift does not evaluate the fleet's resource limit creation
-    # policy.
+    # **Idempotency tokens.** You can add a token that uniquely identifies
+    # game session requests. This is useful for ensuring that game session
+    # requests are idempotent. Multiple requests with the same idempotency
+    # token are processed only once; subsequent requests return the original
+    # result. All response values are the same with the exception of game
+    # session status, which may change.
+    #
+    # **Resource creation limits.** If you are creating a game session on a
+    # fleet with a resource creation limit policy in force, then you must
+    # specify a creator ID. Without this ID, Amazon GameLift has no way to
+    # evaluate the policy for this new game session request.
+    #
+    # By default, newly created game sessions allow new players to join. Use
+    # UpdateGameSession to change the game session's player session
+    # creation policy.
+    #
+    # *Available in Amazon GameLift Local.*
     #
     # @option params [String] :fleet_id
     #   Unique identifier for a fleet to create a game session in. Each
@@ -567,17 +581,27 @@ module Aws::GameLift
     #   properties are passed to the server process hosting the game session.
     #
     # @option params [String] :creator_id
-    #   $player-id; or entity creating the game session. This ID is used to
-    #   enforce a resource protection policy (if one exists) that limits the
-    #   number of concurrent active game sessions one player can have.
+    #   Unique identifier for a player or entity creating the game session.
+    #   This ID is used to enforce a resource protection policy (if one
+    #   exists) that limits the number of concurrent active game sessions one
+    #   player can have.
     #
     # @option params [String] :game_session_id
-    #   Custom string to include in the game session ID, with a maximum length
-    #   of 48 characters. A game session ID has the following format:
-    #   "arn:aws:gamelift:<region>\::gamesession/<fleet
-    #   ID>/<game session ID>". If provided, the custom string is
-    #   used for the game session ID string. This value cannot be updated once
-    #   a game session is created.
+    #   *This parameter is no longer preferred. Please use `IdempotencyToken`
+    #   instead.* Custom string that uniquely identifies a request for a new
+    #   game session. Maximum token length is 48 characters. If provided, this
+    #   string is included in the new game session's ID. (A game session ID
+    #   has the following format:
+    #   `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string
+    #   or idempotency token>`.)
+    #
+    # @option params [String] :idempotency_token
+    #   Custom string that uniquely identifies a request for a new game
+    #   session. Maximum token length is 48 characters. If provided, this
+    #   string is included in the new game session's ID. (A game session ID
+    #   has the following format:
+    #   `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string
+    #   or idempotency token>`.)
     #
     # @return [Types::CreateGameSessionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -598,6 +622,7 @@ module Aws::GameLift
     #     ],
     #     creator_id: "NonZeroAndMaxString",
     #     game_session_id: "IdStringModel",
+    #     idempotency_token: "IdStringModel",
     #   })
     #
     # @example Response structure
@@ -627,21 +652,40 @@ module Aws::GameLift
       req.send_request(options)
     end
 
-    # Establishes a new queue for processing requests for new game sessions.
-    # A queue identifies where new game sessions can be hosted--by
-    # specifying a list of fleet destinations--and how long a request can
-    # remain in the queue waiting to be placed before timing out. Requests
-    # for new game sessions are added to a queue by calling
-    # StartGameSessionPlacement and referencing the queue name.
-    #
-    # When processing a request for a game session, Amazon GameLift tries
-    # each destination in order until it finds one with available resources
-    # to host the new game session. A queue's default order is determined
-    # by how destinations are listed. This default order can be overridden
-    # in a game session placement request.
-    #
-    # To create a new queue, provide a name, timeout value, and a list of
-    # destinations. If successful, a new queue object is returned.
+    # Establishes a new queue for processing requests to place new game
+    # sessions. A queue identifies where new game sessions can be hosted --
+    # by specifying a list of destinations (fleets or aliases) -- and how
+    # long requests can wait in the queue before timing out. You can set up
+    # a queue to try to place game sessions on fleets in multiple regions.
+    # To add placement requests to a queue, call StartGameSessionPlacement
+    # and reference the queue name.
+    #
+    # **Destination order.** When processing a request for a game session,
+    # Amazon GameLift tries each destination in order until it finds one
+    # with available resources to host the new game session. A queue's
+    # default order is determined by how destinations are listed. The
+    # default order is overridden when a game session placement request
+    # provides player latency information. Player latency information
+    # enables Amazon GameLift to prioritize destinations where players
+    # report the lowest average latency, as a result placing the new game
+    # session where the majority of players will have the best possible
+    # gameplay experience.
+    #
+    # **Player latency policies.** For placement requests containing player
+    # latency information, use player latency policies to protect individual
+    # players from very high latencies. With a latency cap, even when a
+    # destination can deliver a low latency for most players, the game is
+    # not placed where any individual player is reporting latency higher
+    # than a policy's maximum. A queue can have multiple latency policies,
+    # which are enforced consecutively starting with the policy with the
+    # lowest latency cap. Use multiple policies to gradually relax latency
+    # controls; for example, you might set a policy with a low latency cap
+    # for the first 60 seconds, a second policy with a higher cap for the
+    # next 60 seconds, etc.
+    #
+    # To create a new queue, provide a name, timeout value, a list of
+    # destinations and, if desired, a set of latency policies. If
+    # successful, a new queue object is returned.
     #
     # @option params [required, String] :name
     #   Descriptive label that is associated with queue. Queue names must be
@@ -652,6 +696,19 @@ module Aws::GameLift
     #   remains in the queue. When a request exceeds this time, the game
     #   session placement changes to a TIMED\_OUT status.
     #
+    # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
+    #   Collection of latency policies to apply when processing game sessions
+    #   placement requests with player latency information. Multiple policies
+    #   are evaluated in order of the maximum latency value, starting with the
+    #   lowest latency values. With just one policy, it is enforced at the
+    #   start of the game session placement for the duration period. With
+    #   multiple policies, each policy is enforced consecutively for its
+    #   duration period. For example, a queue might enforce a 60-second policy
+    #   followed by a 120-second policy, and then no policy for the remainder
+    #   of the placement. A player latency policy must set a value for
+    #   MaximumIndividualPlayerLatencyMilliseconds; if none is set, this API
+    #   requests will fail.
+    #
     # @option params [Array<Types::GameSessionQueueDestination>] :destinations
     #   List of fleets that can be used to fulfill game session placement
     #   requests in the queue. Fleets are identified by either a fleet ARN or
@@ -667,6 +724,12 @@ module Aws::GameLift
     #   resp = client.create_game_session_queue({
     #     name: "GameSessionQueueName", # required
     #     timeout_in_seconds: 1,
+    #     player_latency_policies: [
+    #       {
+    #         maximum_individual_player_latency_milliseconds: 1,
+    #         policy_duration_seconds: 1,
+    #       },
+    #     ],
     #     destinations: [
     #       {
     #         destination_arn: "ArnStringModel",
@@ -677,7 +740,11 @@ module Aws::GameLift
     # @example Response structure
     #
     #   resp.game_session_queue.name #=> String
+    #   resp.game_session_queue.game_session_queue_arn #=> String
     #   resp.game_session_queue.timeout_in_seconds #=> Integer
+    #   resp.game_session_queue.player_latency_policies #=> Array
+    #   resp.game_session_queue.player_latency_policies[0].maximum_individual_player_latency_milliseconds #=> Integer
+    #   resp.game_session_queue.player_latency_policies[0].policy_duration_seconds #=> Integer
     #   resp.game_session_queue.destinations #=> Array
     #   resp.game_session_queue.destinations[0].destination_arn #=> String
     #
@@ -701,6 +768,8 @@ module Aws::GameLift
     # to the game session and a new PlayerSession object is returned. Player
     # sessions cannot be updated.
     #
+    # *Available in Amazon GameLift Local.*
+    #
     # @option params [required, String] :game_session_id
     #   Unique identifier for the game session to add a player to.
     #
@@ -757,6 +826,8 @@ module Aws::GameLift
     # players are added to the game session and a set of new PlayerSession
     # objects is returned. Player sessions cannot be updated.
     #
+    # *Available in Amazon GameLift Local.*
+    #
     # @option params [required, String] :game_session_id
     #   Unique identifier for the game session to add players to.
     #
@@ -1381,9 +1452,10 @@ module Aws::GameLift
 
     # Retrieves properties, including the protection policy in force, for
     # one or more game sessions. This action can be used in several ways:
-    # (1) provide a `GameSessionId` to request details for a specific game
-    # session; (2) provide either a `FleetId` or an `AliasId` to request
-    # properties for all game sessions running on a fleet.
+    # (1) provide a `GameSessionId` or `GameSessionArn` to request details
+    # for a specific game session; (2) provide either a `FleetId` or an
+    # `AliasId` to request properties for all game sessions running on a
+    # fleet.
     #
     # To get game session record(s), specify just one of the following: game
     # session ID, fleet ID, or alias ID. You can filter this request by game
@@ -1489,6 +1561,7 @@ module Aws::GameLift
     #   resp.game_session_placement.game_properties[0].value #=> String
     #   resp.game_session_placement.maximum_player_session_count #=> Integer
     #   resp.game_session_placement.game_session_name #=> String
+    #   resp.game_session_placement.game_session_id #=> String
     #   resp.game_session_placement.game_session_arn #=> String
     #   resp.game_session_placement.game_session_region #=> String
     #   resp.game_session_placement.player_latencies #=> Array
@@ -1497,6 +1570,11 @@ module Aws::GameLift
     #   resp.game_session_placement.player_latencies[0].latency_in_milliseconds #=> Float
     #   resp.game_session_placement.start_time #=> Time
     #   resp.game_session_placement.end_time #=> Time
+    #   resp.game_session_placement.ip_address #=> String
+    #   resp.game_session_placement.port #=> Integer
+    #   resp.game_session_placement.placed_player_sessions #=> Array
+    #   resp.game_session_placement.placed_player_sessions[0].player_id #=> String
+    #   resp.game_session_placement.placed_player_sessions[0].player_session_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionPlacement AWS API Documentation
     #
@@ -1544,7 +1622,11 @@ module Aws::GameLift
     #
     #   resp.game_session_queues #=> Array
     #   resp.game_session_queues[0].name #=> String
+    #   resp.game_session_queues[0].game_session_queue_arn #=> String
     #   resp.game_session_queues[0].timeout_in_seconds #=> Integer
+    #   resp.game_session_queues[0].player_latency_policies #=> Array
+    #   resp.game_session_queues[0].player_latency_policies[0].maximum_individual_player_latency_milliseconds #=> Integer
+    #   resp.game_session_queues[0].player_latency_policies[0].policy_duration_seconds #=> Integer
     #   resp.game_session_queues[0].destinations #=> Array
     #   resp.game_session_queues[0].destinations[0].destination_arn #=> String
     #   resp.next_token #=> String
@@ -1570,11 +1652,14 @@ module Aws::GameLift
     # sequential pages. If successful, a GameSession object is returned for
     # each game session matching the request.
     #
+    # *Available in Amazon GameLift Local.*
+    #
     # @option params [String] :fleet_id
     #   Unique identifier for a fleet to retrieve all game sessions for.
     #
     # @option params [String] :game_session_id
-    #   Unique identifier for the game session to retrieve.
+    #   Unique identifier for the game session to retrieve. You can use either
+    #   a `GameSessionId` or `GameSessionArn` value.
     #
     # @option params [String] :alias_id
     #   Unique identifier for an alias associated with the fleet to retrieve
@@ -1700,12 +1785,11 @@ module Aws::GameLift
     end
 
     # Retrieves properties for one or more player sessions. This action can
-    # be used in several ways: (1) provide a `PlayerSessionId` parameter to
-    # request properties for a specific player session; (2) provide a
-    # `GameSessionId` parameter to request properties for all player
-    # sessions in the specified game session; (3) provide a `PlayerId`
-    # parameter to request properties for all player sessions of a specified
-    # player.
+    # be used in several ways: (1) provide a `PlayerSessionId` to request
+    # properties for a specific player session; (2) provide a
+    # `GameSessionId` to request properties for all player sessions in the
+    # specified game session; (3) provide a `PlayerId` to request properties
+    # for all player sessions of a specified player.
     #
     # To get game session record(s), specify only one of the following: a
     # player session ID, a game session ID, or a player ID. You can filter
@@ -1714,6 +1798,8 @@ module Aws::GameLift
     # PlayerSession object is returned for each session matching the
     # request.
     #
+    # *Available in Amazon GameLift Local.*
+    #
     # @option params [String] :game_session_id
     #   Unique identifier for the game session to retrieve player sessions
     #   for.
@@ -2394,9 +2480,8 @@ module Aws::GameLift
     #
     # You can search or sort by the following game session attributes:
     #
-    # * **gameSessionId** -- ID value assigned to a game session. This
-    #   unique value is returned in a GameSession object when a new game
-    #   session is created.
+    # * **gameSessionId** -- Unique identifier for the game session. You can
+    #   use either a `GameSessionId` or `GameSessionArn` value.
     #
     # * **gameSessionName** -- Name assigned to a game session. This value
     #   is set when requesting a new game session with CreateGameSession or
@@ -2435,6 +2520,8 @@ module Aws::GameLift
     #
     #  </note>
     #
+    # *Available in Amazon GameLift Local.*
+    #
     # @option params [String] :fleet_id
     #   Unique identifier for a fleet to search for active game sessions. Each
     #   request must reference either a fleet ID or alias ID, but not both.
@@ -2564,13 +2651,12 @@ module Aws::GameLift
 
     # Places a request for a new game session in a queue (see
     # CreateGameSessionQueue). When processing a placement request, Amazon
-    # GameLift attempts to create a new game session on one of the fleets
-    # associated with the queue. If no resources are available, Amazon
-    # GameLift tries again with another and so on until resources are found
-    # or the placement request times out. 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.
+    # GameLift searches for available resources on the queue's
+    # destinations, scanning each until it finds resources or the placement
+    # request times out. 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.
     #
     # When placing a game session, by default Amazon GameLift tries each
     # fleet in the order they are listed in the queue configuration.
@@ -2601,8 +2687,8 @@ module Aws::GameLift
     # @option params [required, String] :placement_id
     #   Unique identifier to assign to the new game session placement. This
     #   value is developer-defined. The value must be unique across all
-    #   regions and cannot be reused unless you are resubmitting a cancelled
-    #   or timed-out placement request.
+    #   regions and cannot be reused unless you are resubmitting a canceled or
+    #   timed-out placement request.
     #
     # @option params [required, String] :game_session_queue_name
     #   Name of the queue to use to place the new game session.
@@ -2621,10 +2707,9 @@ module Aws::GameLift
     #
     # @option params [Array<Types::PlayerLatency>] :player_latencies
     #   Set of values, expressed in milliseconds, indicating the amount of
-    #   latency that players experience when connected to AWS regions. This
-    #   information is relevant when requesting player sessions. Latency
-    #   information provided for player IDs not included in
-    #   *DesiredPlayerSessions* are ignored.
+    #   latency that players are experiencing when connected to AWS regions.
+    #   This information is used to try to place the new game session where it
+    #   can offer the best possible gameplay experience for the players.
     #
     # @option params [Array<Types::DesiredPlayerSession>] :desired_player_sessions
     #   Set of information on each player to create a player session for.
@@ -2671,6 +2756,7 @@ module Aws::GameLift
     #   resp.game_session_placement.game_properties[0].value #=> String
     #   resp.game_session_placement.maximum_player_session_count #=> Integer
     #   resp.game_session_placement.game_session_name #=> String
+    #   resp.game_session_placement.game_session_id #=> String
     #   resp.game_session_placement.game_session_arn #=> String
     #   resp.game_session_placement.game_session_region #=> String
     #   resp.game_session_placement.player_latencies #=> Array
@@ -2679,6 +2765,11 @@ module Aws::GameLift
     #   resp.game_session_placement.player_latencies[0].latency_in_milliseconds #=> Float
     #   resp.game_session_placement.start_time #=> Time
     #   resp.game_session_placement.end_time #=> Time
+    #   resp.game_session_placement.ip_address #=> String
+    #   resp.game_session_placement.port #=> Integer
+    #   resp.game_session_placement.placed_player_sessions #=> Array
+    #   resp.game_session_placement.placed_player_sessions[0].player_id #=> String
+    #   resp.game_session_placement.placed_player_sessions[0].player_session_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/StartGameSessionPlacement AWS API Documentation
     #
@@ -2716,6 +2807,7 @@ module Aws::GameLift
     #   resp.game_session_placement.game_properties[0].value #=> String
     #   resp.game_session_placement.maximum_player_session_count #=> Integer
     #   resp.game_session_placement.game_session_name #=> String
+    #   resp.game_session_placement.game_session_id #=> String
     #   resp.game_session_placement.game_session_arn #=> String
     #   resp.game_session_placement.game_session_region #=> String
     #   resp.game_session_placement.player_latencies #=> Array
@@ -2724,6 +2816,11 @@ module Aws::GameLift
     #   resp.game_session_placement.player_latencies[0].latency_in_milliseconds #=> Float
     #   resp.game_session_placement.start_time #=> Time
     #   resp.game_session_placement.end_time #=> Time
+    #   resp.game_session_placement.ip_address #=> String
+    #   resp.game_session_placement.port #=> Integer
+    #   resp.game_session_placement.placed_player_sessions #=> Array
+    #   resp.game_session_placement.placed_player_sessions[0].player_id #=> String
+    #   resp.game_session_placement.placed_player_sessions[0].player_session_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/StopGameSessionPlacement AWS API Documentation
     #
@@ -3104,11 +3201,24 @@ module Aws::GameLift
     #   remains in the queue. When a request exceeds this time, the game
     #   session placement changes to a TIMED\_OUT status.
     #
+    # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
+    #   Collection of latency policies to apply when processing game sessions
+    #   placement requests with player latency information. Multiple policies
+    #   are evaluated in order of the maximum latency value, starting with the
+    #   lowest latency values. With just one policy, it is enforced at the
+    #   start of the game session placement for the duration period. With
+    #   multiple policies, each policy is enforced consecutively for its
+    #   duration period. For example, a queue might enforce a 60-second policy
+    #   followed by a 120-second policy, and then no policy for the remainder
+    #   of the placement. When updating policies, provide a complete
+    #   collection of policies.
+    #
     # @option params [Array<Types::GameSessionQueueDestination>] :destinations
     #   List of fleets that can be used to fulfill game session placement
     #   requests in the queue. Fleets are identified by either a fleet ARN or
     #   a fleet alias ARN. Destinations are listed in default preference
-    #   order.
+    #   order. When updating this list, provide a complete list of
+    #   destinations.
     #
     # @return [Types::UpdateGameSessionQueueOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3119,6 +3229,12 @@ module Aws::GameLift
     #   resp = client.update_game_session_queue({
     #     name: "GameSessionQueueName", # required
     #     timeout_in_seconds: 1,
+    #     player_latency_policies: [
+    #       {
+    #         maximum_individual_player_latency_milliseconds: 1,
+    #         policy_duration_seconds: 1,
+    #       },
+    #     ],
     #     destinations: [
     #       {
     #         destination_arn: "ArnStringModel",
@@ -3129,7 +3245,11 @@ module Aws::GameLift
     # @example Response structure
     #
     #   resp.game_session_queue.name #=> String
+    #   resp.game_session_queue.game_session_queue_arn #=> String
     #   resp.game_session_queue.timeout_in_seconds #=> Integer
+    #   resp.game_session_queue.player_latency_policies #=> Array
+    #   resp.game_session_queue.player_latency_policies[0].maximum_individual_player_latency_milliseconds #=> Integer
+    #   resp.game_session_queue.player_latency_policies[0].policy_duration_seconds #=> Integer
     #   resp.game_session_queue.destinations #=> Array
     #   resp.game_session_queue.destinations[0].destination_arn #=> String
     #
@@ -3222,7 +3342,7 @@ module Aws::GameLift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-gamelift'
-      context[:gem_version] = '1.0.0.rc2'
+      context[:gem_version] = '1.0.0.rc3'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -149,11 +149,15 @@ module Aws::GameLift
     NonZeroAndMaxString = Shapes::StringShape.new(name: 'NonZeroAndMaxString')
     NotFoundException = Shapes::StructureShape.new(name: 'NotFoundException')
     OperatingSystem = Shapes::StringShape.new(name: 'OperatingSystem')
+    PlacedPlayerSession = Shapes::StructureShape.new(name: 'PlacedPlayerSession')
+    PlacedPlayerSessionList = Shapes::ListShape.new(name: 'PlacedPlayerSessionList')
     PlayerData = Shapes::StringShape.new(name: 'PlayerData')
     PlayerDataMap = Shapes::MapShape.new(name: 'PlayerDataMap')
     PlayerIdList = Shapes::ListShape.new(name: 'PlayerIdList')
     PlayerLatency = Shapes::StructureShape.new(name: 'PlayerLatency')
     PlayerLatencyList = Shapes::ListShape.new(name: 'PlayerLatencyList')
+    PlayerLatencyPolicy = Shapes::StructureShape.new(name: 'PlayerLatencyPolicy')
+    PlayerLatencyPolicyList = Shapes::ListShape.new(name: 'PlayerLatencyPolicyList')
     PlayerSession = Shapes::StructureShape.new(name: 'PlayerSession')
     PlayerSessionCreationPolicy = Shapes::StringShape.new(name: 'PlayerSessionCreationPolicy')
     PlayerSessionId = Shapes::StringShape.new(name: 'PlayerSessionId')
@@ -277,6 +281,7 @@ module Aws::GameLift
     CreateGameSessionInput.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
     CreateGameSessionInput.add_member(:creator_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "CreatorId"))
     CreateGameSessionInput.add_member(:game_session_id, Shapes::ShapeRef.new(shape: IdStringModel, location_name: "GameSessionId"))
+    CreateGameSessionInput.add_member(:idempotency_token, Shapes::ShapeRef.new(shape: IdStringModel, location_name: "IdempotencyToken"))
     CreateGameSessionInput.struct_class = Types::CreateGameSessionInput
 
     CreateGameSessionOutput.add_member(:game_session, Shapes::ShapeRef.new(shape: GameSession, location_name: "GameSession"))
@@ -284,6 +289,7 @@ module Aws::GameLift
 
     CreateGameSessionQueueInput.add_member(:name, Shapes::ShapeRef.new(shape: GameSessionQueueName, required: true, location_name: "Name"))
     CreateGameSessionQueueInput.add_member(:timeout_in_seconds, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "TimeoutInSeconds"))
+    CreateGameSessionQueueInput.add_member(:player_latency_policies, Shapes::ShapeRef.new(shape: PlayerLatencyPolicyList, location_name: "PlayerLatencyPolicies"))
     CreateGameSessionQueueInput.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     CreateGameSessionQueueInput.struct_class = Types::CreateGameSessionQueueInput
 
@@ -565,15 +571,21 @@ module Aws::GameLift
     GameSessionPlacement.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
     GameSessionPlacement.add_member(:maximum_player_session_count, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "MaximumPlayerSessionCount"))
     GameSessionPlacement.add_member(:game_session_name, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionName"))
+    GameSessionPlacement.add_member(:game_session_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionId"))
     GameSessionPlacement.add_member(:game_session_arn, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionArn"))
     GameSessionPlacement.add_member(:game_session_region, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionRegion"))
     GameSessionPlacement.add_member(:player_latencies, Shapes::ShapeRef.new(shape: PlayerLatencyList, location_name: "PlayerLatencies"))
     GameSessionPlacement.add_member(:start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StartTime"))
     GameSessionPlacement.add_member(:end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "EndTime"))
+    GameSessionPlacement.add_member(:ip_address, Shapes::ShapeRef.new(shape: IpAddress, location_name: "IpAddress"))
+    GameSessionPlacement.add_member(:port, Shapes::ShapeRef.new(shape: PortNumber, location_name: "Port"))
+    GameSessionPlacement.add_member(:placed_player_sessions, Shapes::ShapeRef.new(shape: PlacedPlayerSessionList, location_name: "PlacedPlayerSessions"))
     GameSessionPlacement.struct_class = Types::GameSessionPlacement
 
     GameSessionQueue.add_member(:name, Shapes::ShapeRef.new(shape: GameSessionQueueName, location_name: "Name"))
+    GameSessionQueue.add_member(:game_session_queue_arn, Shapes::ShapeRef.new(shape: ArnStringModel, location_name: "GameSessionQueueArn"))
     GameSessionQueue.add_member(:timeout_in_seconds, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "TimeoutInSeconds"))
+    GameSessionQueue.add_member(:player_latency_policies, Shapes::ShapeRef.new(shape: PlayerLatencyPolicyList, location_name: "PlayerLatencyPolicies"))
     GameSessionQueue.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     GameSessionQueue.struct_class = Types::GameSessionQueue
 
@@ -657,6 +669,12 @@ module Aws::GameLift
     ListFleetsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "NextToken"))
     ListFleetsOutput.struct_class = Types::ListFleetsOutput
 
+    PlacedPlayerSession.add_member(:player_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "PlayerId"))
+    PlacedPlayerSession.add_member(:player_session_id, Shapes::ShapeRef.new(shape: PlayerSessionId, location_name: "PlayerSessionId"))
+    PlacedPlayerSession.struct_class = Types::PlacedPlayerSession
+
+    PlacedPlayerSessionList.member = Shapes::ShapeRef.new(shape: PlacedPlayerSession)
+
     PlayerDataMap.key = Shapes::ShapeRef.new(shape: NonZeroAndMaxString)
     PlayerDataMap.value = Shapes::ShapeRef.new(shape: PlayerData)
 
@@ -669,6 +687,12 @@ module Aws::GameLift
 
     PlayerLatencyList.member = Shapes::ShapeRef.new(shape: PlayerLatency)
 
+    PlayerLatencyPolicy.add_member(:maximum_individual_player_latency_milliseconds, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "MaximumIndividualPlayerLatencyMilliseconds"))
+    PlayerLatencyPolicy.add_member(:policy_duration_seconds, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "PolicyDurationSeconds"))
+    PlayerLatencyPolicy.struct_class = Types::PlayerLatencyPolicy
+
+    PlayerLatencyPolicyList.member = Shapes::ShapeRef.new(shape: PlayerLatencyPolicy)
+
     PlayerSession.add_member(:player_session_id, Shapes::ShapeRef.new(shape: PlayerSessionId, location_name: "PlayerSessionId"))
     PlayerSession.add_member(:player_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "PlayerId"))
     PlayerSession.add_member(:game_session_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionId"))
@@ -834,6 +858,7 @@ module Aws::GameLift
 
     UpdateGameSessionQueueInput.add_member(:name, Shapes::ShapeRef.new(shape: GameSessionQueueName, required: true, location_name: "Name"))
     UpdateGameSessionQueueInput.add_member(:timeout_in_seconds, Shapes::ShapeRef.new(shape: WholeNumber, location_name: "TimeoutInSeconds"))
+    UpdateGameSessionQueueInput.add_member(:player_latency_policies, Shapes::ShapeRef.new(shape: PlayerLatencyPolicyList, location_name: "PlayerLatencyPolicies"))
     UpdateGameSessionQueueInput.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     UpdateGameSessionQueueInput.struct_class = Types::UpdateGameSessionQueueInput
 

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

@@ -491,6 +491,7 @@ module Aws::GameLift
     #         ],
     #         creator_id: "NonZeroAndMaxString",
     #         game_session_id: "IdStringModel",
+    #         idempotency_token: "IdStringModel",
     #       }
     #
     # @!attribute [rw] fleet_id
@@ -521,18 +522,29 @@ module Aws::GameLift
     #   @return [Array<Types::GameProperty>]
     #
     # @!attribute [rw] creator_id
-    #   $player-id; or entity creating the game session. This ID is used to
-    #   enforce a resource protection policy (if one exists) that limits the
-    #   number of concurrent active game sessions one player can have.
+    #   Unique identifier for a player or entity creating the game session.
+    #   This ID is used to enforce a resource protection policy (if one
+    #   exists) that limits the number of concurrent active game sessions
+    #   one player can have.
     #   @return [String]
     #
     # @!attribute [rw] game_session_id
-    #   Custom string to include in the game session ID, with a maximum
-    #   length of 48 characters. A game session ID has the following format:
-    #   "arn:aws:gamelift:&lt;region&gt;\::gamesession/&lt;fleet
-    #   ID&gt;/&lt;game session ID&gt;". If provided, the custom string is
-    #   used for the game session ID string. This value cannot be updated
-    #   once a game session is created.
+    #   *This parameter is no longer preferred. Please use
+    #   `IdempotencyToken` instead.* Custom string that uniquely identifies
+    #   a request for a new game session. Maximum token length is 48
+    #   characters. If provided, this string is included in the new game
+    #   session's ID. (A game session ID has the following format:
+    #   `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string
+    #   or idempotency token>`.)
+    #   @return [String]
+    #
+    # @!attribute [rw] idempotency_token
+    #   Custom string that uniquely identifies a request for a new game
+    #   session. Maximum token length is 48 characters. If provided, this
+    #   string is included in the new game session's ID. (A game session ID
+    #   has the following format:
+    #   `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string
+    #   or idempotency token>`.)
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionInput AWS API Documentation
@@ -544,7 +556,8 @@ module Aws::GameLift
       :name,
       :game_properties,
       :creator_id,
-      :game_session_id)
+      :game_session_id,
+      :idempotency_token)
       include Aws::Structure
     end
 
@@ -561,12 +574,20 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass CreateGameSessionQueueInput
     #   data as a hash:
     #
     #       {
     #         name: "GameSessionQueueName", # required
     #         timeout_in_seconds: 1,
+    #         player_latency_policies: [
+    #           {
+    #             maximum_individual_player_latency_milliseconds: 1,
+    #             policy_duration_seconds: 1,
+    #           },
+    #         ],
     #         destinations: [
     #           {
     #             destination_arn: "ArnStringModel",
@@ -585,6 +606,21 @@ module Aws::GameLift
     #   session placement changes to a TIMED\_OUT status.
     #   @return [Integer]
     #
+    # @!attribute [rw] player_latency_policies
+    #   Collection of latency policies to apply when processing game
+    #   sessions placement requests with player latency information.
+    #   Multiple policies are evaluated in order of the maximum latency
+    #   value, starting with the lowest latency values. With just one
+    #   policy, it is enforced at the start of the game session placement
+    #   for the duration period. With multiple policies, each policy is
+    #   enforced consecutively for its duration period. For example, a queue
+    #   might enforce a 60-second policy followed by a 120-second policy,
+    #   and then no policy for the remainder of the placement. A player
+    #   latency policy must set a value for
+    #   MaximumIndividualPlayerLatencyMilliseconds; if none is set, this API
+    #   requests will fail.
+    #   @return [Array<Types::PlayerLatencyPolicy>]
+    #
     # @!attribute [rw] destinations
     #   List of fleets that can be used to fulfill game session placement
     #   requests in the queue. Fleets are identified by either a fleet ARN
@@ -597,10 +633,13 @@ module Aws::GameLift
     class CreateGameSessionQueueInput < Struct.new(
       :name,
       :timeout_in_seconds,
+      :player_latency_policies,
       :destinations)
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_queue
     #   Object that describes the newly created game session queue.
     #   @return [Types::GameSessionQueue]
@@ -771,6 +810,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass DeleteGameSessionQueueInput
     #   data as a hash:
     #
@@ -1306,6 +1347,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass DescribeGameSessionPlacementInput
     #   data as a hash:
     #
@@ -1324,6 +1367,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_placement
     #   Object that describes the requested game session placement.
     #   @return [Types::GameSessionPlacement]
@@ -1335,6 +1380,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass DescribeGameSessionQueuesInput
     #   data as a hash:
     #
@@ -1370,6 +1417,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_queues
     #   Collection of objects that describes the requested game session
     #   queues.
@@ -1408,7 +1457,8 @@ module Aws::GameLift
     #   @return [String]
     #
     # @!attribute [rw] game_session_id
-    #   Unique identifier for the game session to retrieve.
+    #   Unique identifier for the game session to retrieve. You can use
+    #   either a `GameSessionId` or `GameSessionArn` value.
     #   @return [String]
     #
     # @!attribute [rw] alias_id
@@ -2129,9 +2179,8 @@ module Aws::GameLift
     #
     # @!attribute [rw] game_session_id
     #   Unique identifier for the game session. A game session ID has the
-    #   following format:
-    #   "arn:aws:gamelift:&lt;region&gt;\::gamesession/&lt;fleet
-    #   ID&gt;/&lt;game session ID&gt;".
+    #   following format: `arn:aws:gamelift:<region>::gamesession/<fleet
+    #   ID>/<custom ID string or idempotency token>`.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -2176,13 +2225,13 @@ module Aws::GameLift
     #   @return [Array<Types::GameProperty>]
     #
     # @!attribute [rw] ip_address
-    #   IP address of the game session. To connect to a Amazon GameLift
-    #   server process, an app needs both the IP address and port number.
+    #   IP address of the game session. To connect to a Amazon GameLift game
+    #   server, an app needs both the IP address and port number.
     #   @return [String]
     #
     # @!attribute [rw] port
     #   Port number for the game session. To connect to a Amazon GameLift
-    #   server process, an app needs both the IP address and port number.
+    #   game server, an app needs both the IP address and port number.
     #   @return [Integer]
     #
     # @!attribute [rw] player_session_creation_policy
@@ -2270,7 +2319,7 @@ module Aws::GameLift
     #     requested) have been successfully created. Values for
     #     *GameSessionArn* and *GameSessionRegion* are available.
     #
-    #   * **CANCELLED** – The placement request was cancelled with a call to
+    #   * **CANCELLED** – The placement request was canceled with a call to
     #     StopGameSessionPlacement.
     #
     #   * **TIMED\_OUT** – A new game session was not successfully created
@@ -2294,21 +2343,27 @@ module Aws::GameLift
     #   names do not need to be unique.
     #   @return [String]
     #
+    # @!attribute [rw] game_session_id
+    #   Unique identifier for the game session. This value is set once the
+    #   new game session is placed (placement status is Fulfilled).
+    #   @return [String]
+    #
     # @!attribute [rw] game_session_arn
     #   Identifier for the game session created by this placement request.
-    #   This value exists only if the game session placement status is
-    #   Completed. This identifier is unique across all regions.
+    #   This value is set once the new game session is placed (placement
+    #   status is Fulfilled). This identifier is unique across all regions.
+    #   You can use this value as a `GameSessionId` value as needed.
     #   @return [String]
     #
     # @!attribute [rw] game_session_region
     #   Name of the region where the game session created by this placement
-    #   request is running. This value exists only if the game session
-    #   placement status is Completed.
+    #   request is running. This value is set once the new game session is
+    #   placed (placement status is Fulfilled).
     #   @return [String]
     #
     # @!attribute [rw] player_latencies
     #   Set of values, expressed in milliseconds, indicating the amount of
-    #   latency that players experience when connected to AWS regions.
+    #   latency that players are experiencing when connected to AWS regions.
     #   @return [Array<Types::PlayerLatency>]
     #
     # @!attribute [rw] start_time
@@ -2318,10 +2373,34 @@ module Aws::GameLift
     #   @return [Time]
     #
     # @!attribute [rw] end_time
-    #   Time stamp indicating when this request was completed, cancelled, or
+    #   Time stamp indicating when this request was completed, canceled, or
     #   timed out.
     #   @return [Time]
     #
+    # @!attribute [rw] ip_address
+    #   IP address of the game session. To connect to a Amazon GameLift game
+    #   server, an app needs both the IP address and port number. This value
+    #   is set once the new game session is placed (placement status is
+    #   Fulfilled).
+    #   @return [String]
+    #
+    # @!attribute [rw] port
+    #   Port number for the game session. To connect to a Amazon GameLift
+    #   game server, an app needs both the IP address and port number. This
+    #   value is set once the new game session is placed (placement status
+    #   is Fulfilled).
+    #   @return [Integer]
+    #
+    # @!attribute [rw] placed_player_sessions
+    #   Collection of information on player sessions created in response to
+    #   the game session placement request. These player sessions are
+    #   created only once a new game session is successfully placed
+    #   (placement status is Fulfilled). This information includes the
+    #   player ID (as provided in the placement request) and the
+    #   corresponding player session ID. Retrieve full player sessions by
+    #   calling DescribePlayerSessions with the player session ID.
+    #   @return [Array<Types::PlacedPlayerSession>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSessionPlacement AWS API Documentation
     #
     class GameSessionPlacement < Struct.new(
@@ -2331,20 +2410,38 @@ module Aws::GameLift
       :game_properties,
       :maximum_player_session_count,
       :game_session_name,
+      :game_session_id,
       :game_session_arn,
       :game_session_region,
       :player_latencies,
       :start_time,
-      :end_time)
+      :end_time,
+      :ip_address,
+      :port,
+      :placed_player_sessions)
       include Aws::Structure
     end
 
-    # Configuration of a queue used to process game session placement
-    # requests. The queue configuration identifies the fleets that new game
-    # session can be placed on, given available resources, and the length of
-    # time a request can remain in the queue waiting for placement.
+    # Configuration of a queue that is used to process game session
+    # placement requests. The queue configuration identifies several game
+    # features:
     #
-    # Queue-related operations include:
+    # * The destinations where a new game session can potentially be hosted.
+    #   Amazon GameLift tries these destinations in an order based on either
+    #   the queue's default order or player latency information, if
+    #   provided in a placement request. With latency information, Amazon
+    #   GameLift can place game sessions where the majority of players are
+    #   reporting the lowest possible latency.
+    #
+    # * The length of time that placement requests can wait in the queue
+    #   before timing out.
+    #
+    # * A set of optional latency policies that protect individual players
+    #   from high latencies, preventing game sessions from being placed
+    #   where any individual player is reporting latency higher than a
+    #   policy's maximum.
+    #
+    # Queue-related operations include the following:
     #
     # * CreateGameSessionQueue
     #
@@ -2359,12 +2456,34 @@ module Aws::GameLift
     #   unique within each region.
     #   @return [String]
     #
+    # @!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`.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
+    #   @return [String]
+    #
     # @!attribute [rw] timeout_in_seconds
     #   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.
     #   @return [Integer]
     #
+    # @!attribute [rw] player_latency_policies
+    #   Collection of latency policies to apply when processing game
+    #   sessions placement requests with player latency information.
+    #   Multiple policies are evaluated in order of the maximum latency
+    #   value, starting with the lowest latency values. With just one
+    #   policy, it is enforced at the start of the game session placement
+    #   for the duration period. With multiple policies, each policy is
+    #   enforced consecutively for its duration period. For example, a queue
+    #   might enforce a 60-second policy followed by a 120-second policy,
+    #   and then no policy for the remainder of the placement.
+    #   @return [Array<Types::PlayerLatencyPolicy>]
+    #
     # @!attribute [rw] destinations
     #   List of fleets that can be used to fulfill game session placement
     #   requests in the queue. Fleets are identified by either a fleet ARN
@@ -2376,14 +2495,16 @@ module Aws::GameLift
     #
     class GameSessionQueue < Struct.new(
       :name,
+      :game_session_queue_arn,
       :timeout_in_seconds,
+      :player_latency_policies,
       :destinations)
       include Aws::Structure
     end
 
     # Fleet designated in a game session queue. Requests for new game
     # sessions in the queue are fulfilled by starting a new game session on
-    # any destination listed for a queue.
+    # any destination configured for a queue.
     #
     # @note When making an API call, you may pass GameSessionQueueDestination
     #   data as a hash:
@@ -2438,6 +2559,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass GetInstanceAccessInput
     #   data as a hash:
     #
@@ -2466,6 +2589,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] instance_access
     #   Object that contains connection information for a fleet instance,
     #   including IP address and access credentials.
@@ -2848,6 +2973,28 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Information about a player session that was created as part of a
+    # StartGameSessionPlacement request. This object contains only the
+    # player ID and player session ID. To retrieve full details on a player
+    # session, call DescribePlayerSessions with the player session ID.
+    #
+    # @!attribute [rw] player_id
+    #   Unique identifier for a player that is associated with this player
+    #   session.
+    #   @return [String]
+    #
+    # @!attribute [rw] player_session_id
+    #   Unique identifier for a player session.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/PlacedPlayerSession AWS API Documentation
+    #
+    class PlacedPlayerSession < Struct.new(
+      :player_id,
+      :player_session_id)
+      include Aws::Structure
+    end
+
     # Regional latency information for a player, used when requesting a new
     # game session with StartGameSessionPlacement. This value indicates the
     # amount of time lag that exists when the player is connected to a fleet
@@ -2886,6 +3033,48 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Queue setting that determines the highest latency allowed for
+    # individual players when placing a game session. When a latency policy
+    # is in force, a game session cannot be placed at any destination in a
+    # region where a player is reporting latency higher than the cap.
+    # Latency policies are only enforced when the placement request contains
+    # player latency information.
+    #
+    # Latency policy-related operations include:
+    #
+    # * CreateGameSessionQueue
+    #
+    # * UpdateGameSessionQueue
+    #
+    # * StartGameSessionPlacement
+    #
+    # @note When making an API call, you may pass PlayerLatencyPolicy
+    #   data as a hash:
+    #
+    #       {
+    #         maximum_individual_player_latency_milliseconds: 1,
+    #         policy_duration_seconds: 1,
+    #       }
+    #
+    # @!attribute [rw] maximum_individual_player_latency_milliseconds
+    #   The maximum latency value that is allowed for any player, in
+    #   milliseconds. All policies must have a value set for this property.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] policy_duration_seconds
+    #   The length of time, in seconds, that the policy is enforced while
+    #   placing a new game session. A null value for this property means
+    #   that the policy is enforced until the queue times out.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/PlayerLatencyPolicy AWS API Documentation
+    #
+    class PlayerLatencyPolicy < Struct.new(
+      :maximum_individual_player_latency_milliseconds,
+      :policy_duration_seconds)
+      include Aws::Structure
+    end
+
     # Properties describing a player session. A player session represents
     # either a player reservation for a game session or actual player
     # activity in a game session. A player session object (including player
@@ -2951,8 +3140,8 @@ module Aws::GameLift
     #   @return [String]
     #
     # @!attribute [rw] ip_address
-    #   Game session IP address. All player sessions reference the game
-    #   session location.
+    #   IP address of the game session. To connect to a Amazon GameLift game
+    #   server, an app needs both the IP address and port number.
     #   @return [String]
     #
     # @!attribute [rw] port
@@ -3637,6 +3826,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass StartGameSessionPlacementInput
     #   data as a hash:
     #
@@ -3669,7 +3860,7 @@ module Aws::GameLift
     # @!attribute [rw] placement_id
     #   Unique identifier to assign to the new game session placement. This
     #   value is developer-defined. The value must be unique across all
-    #   regions and cannot be reused unless you are resubmitting a cancelled
+    #   regions and cannot be reused unless you are resubmitting a canceled
     #   or timed-out placement request.
     #   @return [String]
     #
@@ -3695,10 +3886,9 @@ module Aws::GameLift
     #
     # @!attribute [rw] player_latencies
     #   Set of values, expressed in milliseconds, indicating the amount of
-    #   latency that players experience when connected to AWS regions. This
-    #   information is relevant when requesting player sessions. Latency
-    #   information provided for player IDs not included in
-    #   *DesiredPlayerSessions* are ignored.
+    #   latency that players are experiencing when connected to AWS regions.
+    #   This information is used to try to place the new game session where
+    #   it can offer the best possible gameplay experience for the players.
     #   @return [Array<Types::PlayerLatency>]
     #
     # @!attribute [rw] desired_player_sessions
@@ -3718,6 +3908,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_placement
     #   Object that describes the newly created game session placement. This
     #   object includes all the information provided in the request, as well
@@ -3731,6 +3923,8 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass StopGameSessionPlacementInput
     #   data as a hash:
     #
@@ -3749,9 +3943,11 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_placement
-    #   Object that describes the cancelled game session placement, with
-    #   cancelled status and an end time stamp.
+    #   Object that describes the canceled game session placement, with
+    #   Cancelled status and an end time stamp.
     #   @return [Types::GameSessionPlacement]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/StopGameSessionPlacementOutput AWS API Documentation
@@ -4114,12 +4310,20 @@ module Aws::GameLift
       include Aws::Structure
     end
 
+    # Represents the input for a request action.
+    #
     # @note When making an API call, you may pass UpdateGameSessionQueueInput
     #   data as a hash:
     #
     #       {
     #         name: "GameSessionQueueName", # required
     #         timeout_in_seconds: 1,
+    #         player_latency_policies: [
+    #           {
+    #             maximum_individual_player_latency_milliseconds: 1,
+    #             policy_duration_seconds: 1,
+    #           },
+    #         ],
     #         destinations: [
     #           {
     #             destination_arn: "ArnStringModel",
@@ -4138,11 +4342,25 @@ module Aws::GameLift
     #   session placement changes to a TIMED\_OUT status.
     #   @return [Integer]
     #
+    # @!attribute [rw] player_latency_policies
+    #   Collection of latency policies to apply when processing game
+    #   sessions placement requests with player latency information.
+    #   Multiple policies are evaluated in order of the maximum latency
+    #   value, starting with the lowest latency values. With just one
+    #   policy, it is enforced at the start of the game session placement
+    #   for the duration period. With multiple policies, each policy is
+    #   enforced consecutively for its duration period. For example, a queue
+    #   might enforce a 60-second policy followed by a 120-second policy,
+    #   and then no policy for the remainder of the placement. When updating
+    #   policies, provide a complete collection of policies.
+    #   @return [Array<Types::PlayerLatencyPolicy>]
+    #
     # @!attribute [rw] destinations
     #   List of fleets that can be used to fulfill game session placement
     #   requests in the queue. Fleets are identified by either a fleet ARN
     #   or a fleet alias ARN. Destinations are listed in default preference
-    #   order.
+    #   order. When updating this list, provide a complete list of
+    #   destinations.
     #   @return [Array<Types::GameSessionQueueDestination>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameSessionQueueInput AWS API Documentation
@@ -4150,10 +4368,13 @@ module Aws::GameLift
     class UpdateGameSessionQueueInput < Struct.new(
       :name,
       :timeout_in_seconds,
+      :player_latency_policies,
       :destinations)
       include Aws::Structure
     end
 
+    # Represents the returned data in response to a request action.
+    #
     # @!attribute [rw] game_session_queue
     #   Object that describes the newly updated game session queue.
     #   @return [Types::GameSessionQueue]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-gamelift
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc2
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-03-07 00:00:00.000000000 Z
+date: 2017-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core