aws-sdk-gamelift 1.43.0 → 1.44.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfddd9b3f6bac01d322e12a4d004c767d844749922898f19efcd06630763fa67
-  data.tar.gz: 1724bb94e9fd39735fa0b65da7da849364d7cd643e07a0c54cd96d01d423e7dc
+  metadata.gz: 408fa346d4c27e4cb352b0effbef993bbcd0a0cd272af3fbbccf1575133ab402
+  data.tar.gz: 2b04b0a357b37a9b82bb4a9a27ec2333c7250c4fce6f6a711d172f5ad6197a33
 SHA512:
-  metadata.gz: 358596d9499eca17dc6dfb9e837ffb12be36e0e8031bb8ce79f4c64d648adf6763fc401c967d0ba5d9478db566d5b72263f78149957d4efa8c96ae3fc37e13b2
-  data.tar.gz: 9afb512013e47a856d24a44c42ed495b065dfd5b39f8c90efca9996a30dd497617d8e920fee7979d8df2c0997eb5f5ad5cf347561a0528b52cf402c74efc60bf
+  metadata.gz: c28a8efc093e0e3685f3a9216c8e979f40c0c7f095c903e3b8b68d40fb437da45a7dfe15fb9ee923f0daf9ebf83c4414aebd4cdfb4c882756faad4a32ecf6898
+  data.tar.gz: 73b3371fc8ef06ee8085622ee1abad1669afec32b2d91cba52f717c33f6e0b262fdcccedc9582d9d6616809f806c6cf0fd5f9c818c5df2e85f0dc35ef8f7102b

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.44.0 (2021-03-23)
+------------------
+
+* Feature - GameLift adds support for using event notifications to monitor game session placements. Specify an SNS topic or use CloudWatch Events to track activity for a game session queue.
+
 1.43.0 (2021-03-16)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.43.0
+1.44.0

data/lib/aws-sdk-gamelift.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-gamelift/customizations'
 # @!group service
 module Aws::GameLift
 
-  GEM_VERSION = '1.43.0'
+  GEM_VERSION = '1.44.0'
 
 end

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

@@ -769,9 +769,10 @@ module Aws::GameLift
     # Regions support multiple locations: us-east-1 (N. Virginia), us-west-2
     # (Oregon), eu-central-1 (Frankfurt), eu-west-1 (Ireland),
     # ap-southeast-2 (Sydney), ap-northeast-1 (Tokyo), and ap-northeast-2
-    # (Seoul). Fleets that created in other GameLift Regions can have
-    # instances in the fleet Region only. All instances deployed to fleet
-    # locations use the same configuration.
+    # (Seoul). Fleets that are created in other GameLift Regions can deploy
+    # instances in the fleet's home Region only. All fleet instances use
+    # the same configuration regardless of location; however, you can adjust
+    # capacity settings and turn auto-scaling on/off for each location.
     #
     # To create a fleet, choose the hardware for your instances, specify a
     # game server build or Realtime script to deploy, and provide a runtime
@@ -1633,12 +1634,16 @@ module Aws::GameLift
     #
     # To create a new queue, provide a name, timeout value, and a list of
     # destinations. Optionally, specify a sort configuration and/or a
-    # filter, and define a set of latency cap policies.
+    # filter, and define a set of latency cap policies. You can also include
+    # the ARN for an Amazon Simple Notification Service (SNS) topic to
+    # receive notifications of game session placement activity.
+    # Notifications using SNS or CloudWatch events is the preferred way to
+    # track placement activity.
     #
     # If successful, a new `GameSessionQueue` object is returned with an
     # assigned queue ARN. New game session requests, which are submitted to
-    # queue with StartGameSessionPlacement or StartMatchmaking, reference a
-    # queue's name or ARN.
+    # the queue with StartGameSessionPlacement or StartMatchmaking,
+    # reference a queue's name or ARN.
     #
     # **Learn more**
     #
@@ -1695,6 +1700,19 @@ module Aws::GameLift
     #   named will be automatically applied at the end of the prioritization
     #   process.
     #
+    # @option params [String] :custom_event_data
+    #   Information to be added to all events that are related to this game
+    #   session queue.
+    #
+    # @option params [String] :notification_target
+    #   An SNS topic ARN that is set up to receive game session placement
+    #   notifications. See [ Setting up notifications for game session
+    #   placement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
+    #
     # @option params [Array<Types::Tag>] :tags
     #   A list of labels to assign to the new game session queue resource.
     #   Tags are developer-defined key-value pairs. Tagging AWS resources are
@@ -1736,6 +1754,8 @@ module Aws::GameLift
     #       priority_order: ["LATENCY"], # accepts LATENCY, COST, DESTINATION, LOCATION
     #       location_order: ["LocationStringModel"],
     #     },
+    #     custom_event_data: "QueueCustomEventData",
+    #     notification_target: "QueueSnsArnStringModel",
     #     tags: [
     #       {
     #         key: "TagKey", # required
@@ -1760,6 +1780,8 @@ module Aws::GameLift
     #   resp.game_session_queue.priority_configuration.priority_order[0] #=> String, one of "LATENCY", "COST", "DESTINATION", "LOCATION"
     #   resp.game_session_queue.priority_configuration.location_order #=> Array
     #   resp.game_session_queue.priority_configuration.location_order[0] #=> String
+    #   resp.game_session_queue.custom_event_data #=> String
+    #   resp.game_session_queue.notification_target #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionQueue AWS API Documentation
     #
@@ -1790,10 +1812,10 @@ module Aws::GameLift
     # queue to use when starting a game session for the match.
     #
     # In addition, you must set up an Amazon Simple Notification Service
-    # (SNS) to receive matchmaking notifications, and provide the topic ARN
-    # in the matchmaking configuration. An alternative method, continuously
-    # polling ticket status with DescribeMatchmaking, is only suitable for
-    # games in development with low matchmaking usage.
+    # (SNS) topic to receive matchmaking notifications. Provide the topic
+    # ARN in the matchmaking configuration. An alternative method,
+    # continuously polling ticket status with DescribeMatchmaking, is only
+    # suitable for games in development with low matchmaking usage.
     #
     # **Learn more**
     #
@@ -1861,6 +1883,12 @@ module Aws::GameLift
     #
     # @option params [String] :notification_target
     #   An SNS topic ARN that is set up to receive matchmaking notifications.
+    #   See [ Setting up notifications for matchmaking][1] for more
+    #   information.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
     #
     # @option params [Integer] :additional_player_count
     #   The number of player slots in a match to keep open for future players.
@@ -4670,6 +4698,8 @@ module Aws::GameLift
     #   resp.game_session_queues[0].priority_configuration.priority_order[0] #=> String, one of "LATENCY", "COST", "DESTINATION", "LOCATION"
     #   resp.game_session_queues[0].priority_configuration.location_order #=> Array
     #   resp.game_session_queues[0].priority_configuration.location_order[0] #=> String
+    #   resp.game_session_queues[0].custom_event_data #=> String
+    #   resp.game_session_queues[0].notification_target #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionQueues AWS API Documentation
@@ -8804,6 +8834,19 @@ module Aws::GameLift
     #   process. To remove an existing priority configuration, pass in an
     #   empty set.
     #
+    # @option params [String] :custom_event_data
+    #   Information to be added to all events that are related to this game
+    #   session queue.
+    #
+    # @option params [String] :notification_target
+    #   An SNS topic ARN that is set up to receive game session placement
+    #   notifications. See [ Setting up notifications for game session
+    #   placement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
+    #
     # @return [Types::UpdateGameSessionQueueOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateGameSessionQueueOutput#game_session_queue #game_session_queue} => Types::GameSessionQueue
@@ -8831,6 +8874,8 @@ module Aws::GameLift
     #       priority_order: ["LATENCY"], # accepts LATENCY, COST, DESTINATION, LOCATION
     #       location_order: ["LocationStringModel"],
     #     },
+    #     custom_event_data: "QueueCustomEventData",
+    #     notification_target: "QueueSnsArnStringModel",
     #   })
     #
     # @example Response structure
@@ -8849,6 +8894,8 @@ module Aws::GameLift
     #   resp.game_session_queue.priority_configuration.priority_order[0] #=> String, one of "LATENCY", "COST", "DESTINATION", "LOCATION"
     #   resp.game_session_queue.priority_configuration.location_order #=> Array
     #   resp.game_session_queue.priority_configuration.location_order[0] #=> String
+    #   resp.game_session_queue.custom_event_data #=> String
+    #   resp.game_session_queue.notification_target #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameSessionQueue AWS API Documentation
     #
@@ -9307,7 +9354,7 @@ module Aws::GameLift
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-gamelift'
-      context[:gem_version] = '1.43.0'
+      context[:gem_version] = '1.44.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -341,6 +341,8 @@ module Aws::GameLift
     PutScalingPolicyInput = Shapes::StructureShape.new(name: 'PutScalingPolicyInput')
     PutScalingPolicyOutput = Shapes::StructureShape.new(name: 'PutScalingPolicyOutput')
     QueueArnsList = Shapes::ListShape.new(name: 'QueueArnsList')
+    QueueCustomEventData = Shapes::StringShape.new(name: 'QueueCustomEventData')
+    QueueSnsArnStringModel = Shapes::StringShape.new(name: 'QueueSnsArnStringModel')
     RegisterGameServerInput = Shapes::StructureShape.new(name: 'RegisterGameServerInput')
     RegisterGameServerOutput = Shapes::StructureShape.new(name: 'RegisterGameServerOutput')
     RequestUploadCredentialsInput = Shapes::StructureShape.new(name: 'RequestUploadCredentialsInput')
@@ -591,6 +593,8 @@ module Aws::GameLift
     CreateGameSessionQueueInput.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     CreateGameSessionQueueInput.add_member(:filter_configuration, Shapes::ShapeRef.new(shape: FilterConfiguration, location_name: "FilterConfiguration"))
     CreateGameSessionQueueInput.add_member(:priority_configuration, Shapes::ShapeRef.new(shape: PriorityConfiguration, location_name: "PriorityConfiguration"))
+    CreateGameSessionQueueInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
+    CreateGameSessionQueueInput.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
     CreateGameSessionQueueInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateGameSessionQueueInput.struct_class = Types::CreateGameSessionQueueInput
 
@@ -1179,6 +1183,8 @@ module Aws::GameLift
     GameSessionQueue.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     GameSessionQueue.add_member(:filter_configuration, Shapes::ShapeRef.new(shape: FilterConfiguration, location_name: "FilterConfiguration"))
     GameSessionQueue.add_member(:priority_configuration, Shapes::ShapeRef.new(shape: PriorityConfiguration, location_name: "PriorityConfiguration"))
+    GameSessionQueue.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
+    GameSessionQueue.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
     GameSessionQueue.struct_class = Types::GameSessionQueue
 
     GameSessionQueueDestination.add_member(:destination_arn, Shapes::ShapeRef.new(shape: ArnStringModel, location_name: "DestinationArn"))
@@ -1780,6 +1786,8 @@ module Aws::GameLift
     UpdateGameSessionQueueInput.add_member(:destinations, Shapes::ShapeRef.new(shape: GameSessionQueueDestinationList, location_name: "Destinations"))
     UpdateGameSessionQueueInput.add_member(:filter_configuration, Shapes::ShapeRef.new(shape: FilterConfiguration, location_name: "FilterConfiguration"))
     UpdateGameSessionQueueInput.add_member(:priority_configuration, Shapes::ShapeRef.new(shape: PriorityConfiguration, location_name: "PriorityConfiguration"))
+    UpdateGameSessionQueueInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
+    UpdateGameSessionQueueInput.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
     UpdateGameSessionQueueInput.struct_class = Types::UpdateGameSessionQueueInput
 
     UpdateGameSessionQueueOutput.add_member(:game_session_queue, Shapes::ShapeRef.new(shape: GameSessionQueue, location_name: "GameSessionQueue"))
@@ -1993,6 +2001,7 @@ module Aws::GameLift
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
         o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
         o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: TaggingFailedException)
       end)
 

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

@@ -2,7 +2,7 @@
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing for info on making contributions:
-# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
+# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
 #
 # WARNING ABOUT GENERATED CODE
 

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

@@ -1325,6 +1325,8 @@ module Aws::GameLift
     #           priority_order: ["LATENCY"], # accepts LATENCY, COST, DESTINATION, LOCATION
     #           location_order: ["LocationStringModel"],
     #         },
+    #         custom_event_data: "QueueCustomEventData",
+    #         notification_target: "QueueSnsArnStringModel",
     #         tags: [
     #           {
     #             key: "TagKey", # required
@@ -1376,6 +1378,21 @@ module Aws::GameLift
     #   prioritization process.
     #   @return [Types::PriorityConfiguration]
     #
+    # @!attribute [rw] custom_event_data
+    #   Information to be added to all events that are related to this game
+    #   session queue.
+    #   @return [String]
+    #
+    # @!attribute [rw] notification_target
+    #   An SNS topic ARN that is set up to receive game session placement
+    #   notifications. See [ Setting up notifications for game session
+    #   placement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
+    #   @return [String]
+    #
     # @!attribute [rw] tags
     #   A list of labels to assign to the new game session queue resource.
     #   Tags are developer-defined key-value pairs. Tagging AWS resources
@@ -1400,6 +1417,8 @@ module Aws::GameLift
       :destinations,
       :filter_configuration,
       :priority_configuration,
+      :custom_event_data,
+      :notification_target,
       :tags)
       SENSITIVE = []
       include Aws::Structure
@@ -1505,7 +1524,12 @@ module Aws::GameLift
     #
     # @!attribute [rw] notification_target
     #   An SNS topic ARN that is set up to receive matchmaking
-    #   notifications.
+    #   notifications. See [ Setting up notifications for matchmaking][1]
+    #   for more information.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
     #   @return [String]
     #
     # @!attribute [rw] additional_player_count
@@ -5657,6 +5681,21 @@ module Aws::GameLift
     #   prioritization process.
     #   @return [Types::PriorityConfiguration]
     #
+    # @!attribute [rw] custom_event_data
+    #   Information that is added to all events that are related to this
+    #   game session queue.
+    #   @return [String]
+    #
+    # @!attribute [rw] notification_target
+    #   An SNS topic ARN that is set up to receive game session placement
+    #   notifications. See [ Setting up notifications for game session
+    #   placement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSessionQueue AWS API Documentation
     #
     class GameSessionQueue < Struct.new(
@@ -5666,7 +5705,9 @@ module Aws::GameLift
       :player_latency_policies,
       :destinations,
       :filter_configuration,
-      :priority_configuration)
+      :priority_configuration,
+      :custom_event_data,
+      :notification_target)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -9879,6 +9920,8 @@ module Aws::GameLift
     #           priority_order: ["LATENCY"], # accepts LATENCY, COST, DESTINATION, LOCATION
     #           location_order: ["LocationStringModel"],
     #         },
+    #         custom_event_data: "QueueCustomEventData",
+    #         notification_target: "QueueSnsArnStringModel",
     #       }
     #
     # @!attribute [rw] name
@@ -9929,6 +9972,21 @@ module Aws::GameLift
     #   configuration, pass in an empty set.
     #   @return [Types::PriorityConfiguration]
     #
+    # @!attribute [rw] custom_event_data
+    #   Information to be added to all events that are related to this game
+    #   session queue.
+    #   @return [String]
+    #
+    # @!attribute [rw] notification_target
+    #   An SNS topic ARN that is set up to receive game session placement
+    #   notifications. See [ Setting up notifications for game session
+    #   placement][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameSessionQueueInput AWS API Documentation
     #
     class UpdateGameSessionQueueInput < Struct.new(
@@ -9937,7 +9995,9 @@ module Aws::GameLift
       :player_latency_policies,
       :destinations,
       :filter_configuration,
-      :priority_configuration)
+      :priority_configuration,
+      :custom_event_data,
+      :notification_target)
       SENSITIVE = []
       include Aws::Structure
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-gamelift
 version: !ruby/object:Gem::Version
-  version: 1.43.0
+  version: 1.44.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-16 00:00:00.000000000 Z
+date: 2021-03-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -66,8 +66,8 @@ homepage: https://github.com/aws/aws-sdk-ruby
 licenses:
 - Apache-2.0
 metadata:
-  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-gamelift
-  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/master/gems/aws-sdk-gamelift/CHANGELOG.md
+  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-gamelift
+  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-gamelift/CHANGELOG.md
 post_install_message: 
 rdoc_options: []
 require_paths: