aws-sdk-gamelift 1.146.0 → 1.148.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 6fe87480b2c10a5dbc57f1b22c567e1cf5abce4631ffaf89d164665462853331
4
- data.tar.gz: 93c31b411dde700e71dafd5e83eca6b5883c92de3f973c099e7d3b8e3dac4742
3
+ metadata.gz: c1a56275ff618e3a6869aee024bed4713b1373e532cfaaefeb19c2d67a78ef94
4
+ data.tar.gz: 14da8730d7c640e0e1fdcc65757555a4c8f659cb32d77e903a6f38c6388faa66
5
5
  SHA512:
6
- metadata.gz: c57528dbda9b9ca98a5a82f3622d1886c96452bf4a62e60ad5fce73c43823382b20bcc2ce611e56f971409ebab759da18c2d07239cd5c8c038e299af5408cfcd
7
- data.tar.gz: d878d208467488fe9bda8e22e85ed55e596a64b5de230f44735add6d29176a6eecd17cfdb688d24ebc8cf7317733f56f3e33deb3810cd3e3224bd677d257638a
6
+ metadata.gz: e555b283193e288e9b4114967a7ae1ba6bf3105dc423953ac2593b480821ffd3f5146900e931e00529a7a92b4bca92cfc79b2db86a0ca3d2dda0b0085d0f5979
7
+ data.tar.gz: 464e2298d80bb8dfb977d11b5479434bc524ebdf233f08c0a0db9ff12c40d88bb22e3f82a710f871b8fce126670f8611e4e513d9378a543499870fabfc05fe27
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.148.0 (2026-11-11)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.147.0 (2026-11-10)
10
+ ------------------
11
+
12
+ * Feature - Amazon GameLift Servers adds game session placement insights. Logs show how the queue's priority configuration, along with player latency and cost data, are applied to each placement request. Use game session placement insights to diagnose why game session placements succeed, fail, or time out.
13
+
4
14
  1.146.0 (2026-11-09)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.146.0
1
+ 1.148.0
@@ -264,7 +264,8 @@ module Aws::GameLift
264
264
  # An integer representing the maximum number attempts that will be made for
265
265
  # a single request, including the initial attempt. For example,
266
266
  # setting this value to 5 will result in a request being retried up to
267
- # 4 times. Used in `standard` and `adaptive` retry modes.
267
+ # 4 times. Used in `standard` and `adaptive` retry modes. Defaults to 3,
268
+ # except for DynamoDB and DynamoDB Streams, which default to 4.
268
269
  #
269
270
  # @option options [String] :profile ("default")
270
271
  # Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
@@ -327,15 +328,15 @@ module Aws::GameLift
327
328
  # used by the default backoff function. This option is only used in the
328
329
  # `legacy` retry mode.
329
330
  #
330
- # @option options [String] :retry_mode ("legacy")
331
+ # @option options [String] :retry_mode ("standard")
331
332
  # Specifies which retry algorithm to use. Values are:
332
333
  #
333
- # * `legacy` - The pre-existing retry behavior. This is the default
334
- # value if no retry mode is provided.
334
+ # * `legacy` - The pre-existing retry behavior.
335
335
  #
336
336
  # * `standard` - A standardized set of retry rules across the AWS SDKs.
337
337
  # This includes support for retry quotas, which limit the number of
338
- # unsuccessful retries a client can make.
338
+ # unsuccessful retries a client can make. This is the default value
339
+ # if no retry mode is provided.
339
340
  #
340
341
  # * `adaptive` - A retry mode that includes all the functionality of
341
342
  # `standard` mode along with automatic client side throttling.
@@ -2811,9 +2812,8 @@ module Aws::GameLift
2811
2812
  # Container
2812
2813
  #
2813
2814
  # Creates a placement queue that processes requests for new game
2814
- # sessions. A queue uses FleetIQ algorithms to locate the best available
2815
- # placement locations for a new game session, and then prompts the game
2816
- # server process to start a new game session.
2815
+ # sessions. A queue finds the best available game server, then prompts
2816
+ # it to start a new game session.
2817
2817
  #
2818
2818
  # A game session queue is configured with a set of destinations (Amazon
2819
2819
  # GameLift Servers fleets or aliases) that determine where the queue can
@@ -2861,6 +2861,12 @@ module Aws::GameLift
2861
2861
  # * Required parameters `Name` and `Destinations`
2862
2862
  #
2863
2863
  # * `PlayerLatencyPolicies`
2864
+ # * Create a queue that delivers game session placement insight logs to
2865
+ # one or more log destinations.
2866
+ #
2867
+ # * Required parameters `Name` and `Destinations`
2868
+ #
2869
+ # * `LogConfiguration`
2864
2870
  #
2865
2871
  # **Results**
2866
2872
  #
@@ -2928,9 +2934,9 @@ module Aws::GameLift
2928
2934
  #
2929
2935
  # @option params [Types::PriorityConfiguration] :priority_configuration
2930
2936
  # Custom settings to use when prioritizing destinations and locations
2931
- # for game session placements. This configuration replaces the FleetIQ
2932
- # default prioritization process. Priority types that are not explicitly
2933
- # named will be automatically applied at the end of the prioritization
2937
+ # for game session placements. This configuration replaces the default
2938
+ # prioritization process. Priority types that are not explicitly named
2939
+ # will be automatically applied at the end of the prioritization
2934
2940
  # process.
2935
2941
  #
2936
2942
  # @option params [String] :custom_event_data
@@ -2958,6 +2964,13 @@ module Aws::GameLift
2958
2964
  #
2959
2965
  # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
2960
2966
  #
2967
+ # @option params [Types::GameSessionQueueLogConfiguration] :log_configuration
2968
+ # An optional configuration that delivers game session placement insight
2969
+ # logs to one or more destinations of your choice. Use these logs to
2970
+ # diagnose why a game session placement is `FULFILLED`, `CANCELLED`,
2971
+ # `TIMED_OUT`, or `FAILED`, which locations were evaluated, and the
2972
+ # latency and cost factors that influenced each decision.
2973
+ #
2961
2974
  # @return [Types::CreateGameSessionQueueOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2962
2975
  #
2963
2976
  # * {Types::CreateGameSessionQueueOutput#game_session_queue #game_session_queue} => Types::GameSessionQueue
@@ -2993,6 +3006,14 @@ module Aws::GameLift
2993
3006
  # value: "TagValue", # required
2994
3007
  # },
2995
3008
  # ],
3009
+ # log_configuration: {
3010
+ # delivery_destinations: [ # required
3011
+ # {
3012
+ # log_destination: "CLOUDWATCH", # required, accepts CLOUDWATCH, S3, FIREHOSE
3013
+ # destination_arn: "DeliveryDestinationArnStringModel",
3014
+ # },
3015
+ # ],
3016
+ # },
2996
3017
  # })
2997
3018
  #
2998
3019
  # @example Response structure
@@ -3013,6 +3034,9 @@ module Aws::GameLift
3013
3034
  # resp.game_session_queue.priority_configuration.location_order[0] #=> String
3014
3035
  # resp.game_session_queue.custom_event_data #=> String
3015
3036
  # resp.game_session_queue.notification_target #=> String
3037
+ # resp.game_session_queue.log_configuration.delivery_destinations #=> Array
3038
+ # resp.game_session_queue.log_configuration.delivery_destinations[0].log_destination #=> String, one of "CLOUDWATCH", "S3", "FIREHOSE"
3039
+ # resp.game_session_queue.log_configuration.delivery_destinations[0].destination_arn #=> String
3016
3040
  #
3017
3041
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionQueue AWS API Documentation
3018
3042
  #
@@ -6650,6 +6674,9 @@ module Aws::GameLift
6650
6674
  # resp.game_session_queues[0].priority_configuration.location_order[0] #=> String
6651
6675
  # resp.game_session_queues[0].custom_event_data #=> String
6652
6676
  # resp.game_session_queues[0].notification_target #=> String
6677
+ # resp.game_session_queues[0].log_configuration.delivery_destinations #=> Array
6678
+ # resp.game_session_queues[0].log_configuration.delivery_destinations[0].log_destination #=> String, one of "CLOUDWATCH", "S3", "FIREHOSE"
6679
+ # resp.game_session_queues[0].log_configuration.delivery_destinations[0].destination_arn #=> String
6653
6680
  # resp.next_token #=> String
6654
6681
  #
6655
6682
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionQueues AWS API Documentation
@@ -12550,9 +12577,9 @@ module Aws::GameLift
12550
12577
  #
12551
12578
  # @option params [Types::PriorityConfiguration] :priority_configuration
12552
12579
  # Custom settings to use when prioritizing destinations and locations
12553
- # for game session placements. This configuration replaces the FleetIQ
12554
- # default prioritization process. Priority types that are not explicitly
12555
- # named will be automatically applied at the end of the prioritization
12580
+ # for game session placements. This configuration replaces the default
12581
+ # prioritization process. Priority types that are not explicitly named
12582
+ # will be automatically applied at the end of the prioritization
12556
12583
  # process. To remove an existing priority configuration, pass in an
12557
12584
  # empty set.
12558
12585
  #
@@ -12569,6 +12596,14 @@ module Aws::GameLift
12569
12596
  #
12570
12597
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
12571
12598
  #
12599
+ # @option params [Array<Types::LogDeliveryDestination>] :add_log_delivery_destinations
12600
+ # Log delivery destinations to add to the queue's log configuration
12601
+ # (`LogConfiguration`).
12602
+ #
12603
+ # @option params [Array<Types::LogDeliveryDestination>] :remove_log_delivery_destinations
12604
+ # Log delivery destinations to remove from the queue's log
12605
+ # configuration (`LogConfiguration`).
12606
+ #
12572
12607
  # @return [Types::UpdateGameSessionQueueOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12573
12608
  #
12574
12609
  # * {Types::UpdateGameSessionQueueOutput#game_session_queue #game_session_queue} => Types::GameSessionQueue
@@ -12598,6 +12633,18 @@ module Aws::GameLift
12598
12633
  # },
12599
12634
  # custom_event_data: "QueueCustomEventData",
12600
12635
  # notification_target: "QueueSnsArnStringModel",
12636
+ # add_log_delivery_destinations: [
12637
+ # {
12638
+ # log_destination: "CLOUDWATCH", # required, accepts CLOUDWATCH, S3, FIREHOSE
12639
+ # destination_arn: "DeliveryDestinationArnStringModel",
12640
+ # },
12641
+ # ],
12642
+ # remove_log_delivery_destinations: [
12643
+ # {
12644
+ # log_destination: "CLOUDWATCH", # required, accepts CLOUDWATCH, S3, FIREHOSE
12645
+ # destination_arn: "DeliveryDestinationArnStringModel",
12646
+ # },
12647
+ # ],
12601
12648
  # })
12602
12649
  #
12603
12650
  # @example Response structure
@@ -12618,6 +12665,9 @@ module Aws::GameLift
12618
12665
  # resp.game_session_queue.priority_configuration.location_order[0] #=> String
12619
12666
  # resp.game_session_queue.custom_event_data #=> String
12620
12667
  # resp.game_session_queue.notification_target #=> String
12668
+ # resp.game_session_queue.log_configuration.delivery_destinations #=> Array
12669
+ # resp.game_session_queue.log_configuration.delivery_destinations[0].log_destination #=> String, one of "CLOUDWATCH", "S3", "FIREHOSE"
12670
+ # resp.game_session_queue.log_configuration.delivery_destinations[0].destination_arn #=> String
12621
12671
  #
12622
12672
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameSessionQueue AWS API Documentation
12623
12673
  #
@@ -13076,7 +13126,7 @@ module Aws::GameLift
13076
13126
  tracer: tracer
13077
13127
  )
13078
13128
  context[:gem_name] = 'aws-sdk-gamelift'
13079
- context[:gem_version] = '1.146.0'
13129
+ context[:gem_version] = '1.148.0'
13080
13130
  Seahorse::Client::Request.new(handlers, context)
13081
13131
  end
13082
13132
 
@@ -165,6 +165,7 @@ module Aws::GameLift
165
165
  DeleteVpcPeeringAuthorizationOutput = Shapes::StructureShape.new(name: 'DeleteVpcPeeringAuthorizationOutput')
166
166
  DeleteVpcPeeringConnectionInput = Shapes::StructureShape.new(name: 'DeleteVpcPeeringConnectionInput')
167
167
  DeleteVpcPeeringConnectionOutput = Shapes::StructureShape.new(name: 'DeleteVpcPeeringConnectionOutput')
168
+ DeliveryDestinationArnStringModel = Shapes::StringShape.new(name: 'DeliveryDestinationArnStringModel')
168
169
  DeploymentConfiguration = Shapes::StructureShape.new(name: 'DeploymentConfiguration')
169
170
  DeploymentDetails = Shapes::StructureShape.new(name: 'DeploymentDetails')
170
171
  DeploymentId = Shapes::StringShape.new(name: 'DeploymentId')
@@ -331,6 +332,7 @@ module Aws::GameLift
331
332
  GameSessionQueueDestination = Shapes::StructureShape.new(name: 'GameSessionQueueDestination')
332
333
  GameSessionQueueDestinationList = Shapes::ListShape.new(name: 'GameSessionQueueDestinationList')
333
334
  GameSessionQueueList = Shapes::ListShape.new(name: 'GameSessionQueueList')
335
+ GameSessionQueueLogConfiguration = Shapes::StructureShape.new(name: 'GameSessionQueueLogConfiguration')
334
336
  GameSessionQueueName = Shapes::StringShape.new(name: 'GameSessionQueueName')
335
337
  GameSessionQueueNameOrArn = Shapes::StringShape.new(name: 'GameSessionQueueNameOrArn')
336
338
  GameSessionQueueNameOrArnList = Shapes::ListShape.new(name: 'GameSessionQueueNameOrArnList')
@@ -430,6 +432,9 @@ module Aws::GameLift
430
432
  LocationalDeployment = Shapes::StructureShape.new(name: 'LocationalDeployment')
431
433
  LocationalDeployments = Shapes::MapShape.new(name: 'LocationalDeployments')
432
434
  LogConfiguration = Shapes::StructureShape.new(name: 'LogConfiguration')
435
+ LogDeliveryDestination = Shapes::StructureShape.new(name: 'LogDeliveryDestination')
436
+ LogDeliveryDestinationList = Shapes::ListShape.new(name: 'LogDeliveryDestinationList')
437
+ LogDeliveryDestinationType = Shapes::StringShape.new(name: 'LogDeliveryDestinationType')
433
438
  LogDestination = Shapes::StringShape.new(name: 'LogDestination')
434
439
  LogGroupArnStringModel = Shapes::StringShape.new(name: 'LogGroupArnStringModel')
435
440
  ManagedCapacityConfiguration = Shapes::StructureShape.new(name: 'ManagedCapacityConfiguration')
@@ -980,6 +985,7 @@ module Aws::GameLift
980
985
  CreateGameSessionQueueInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
981
986
  CreateGameSessionQueueInput.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
982
987
  CreateGameSessionQueueInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
988
+ CreateGameSessionQueueInput.add_member(:log_configuration, Shapes::ShapeRef.new(shape: GameSessionQueueLogConfiguration, location_name: "LogConfiguration"))
983
989
  CreateGameSessionQueueInput.struct_class = Types::CreateGameSessionQueueInput
984
990
 
985
991
  CreateGameSessionQueueOutput.add_member(:game_session_queue, Shapes::ShapeRef.new(shape: GameSessionQueue, location_name: "GameSessionQueue"))
@@ -1714,6 +1720,7 @@ module Aws::GameLift
1714
1720
  GameSessionQueue.add_member(:priority_configuration, Shapes::ShapeRef.new(shape: PriorityConfiguration, location_name: "PriorityConfiguration"))
1715
1721
  GameSessionQueue.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
1716
1722
  GameSessionQueue.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
1723
+ GameSessionQueue.add_member(:log_configuration, Shapes::ShapeRef.new(shape: GameSessionQueueLogConfiguration, location_name: "LogConfiguration"))
1717
1724
  GameSessionQueue.struct_class = Types::GameSessionQueue
1718
1725
 
1719
1726
  GameSessionQueueDestination.add_member(:destination_arn, Shapes::ShapeRef.new(shape: ArnStringModel, location_name: "DestinationArn"))
@@ -1723,6 +1730,9 @@ module Aws::GameLift
1723
1730
 
1724
1731
  GameSessionQueueList.member = Shapes::ShapeRef.new(shape: GameSessionQueue)
1725
1732
 
1733
+ GameSessionQueueLogConfiguration.add_member(:delivery_destinations, Shapes::ShapeRef.new(shape: LogDeliveryDestinationList, required: true, location_name: "DeliveryDestinations"))
1734
+ GameSessionQueueLogConfiguration.struct_class = Types::GameSessionQueueLogConfiguration
1735
+
1726
1736
  GameSessionQueueNameOrArnList.member = Shapes::ShapeRef.new(shape: GameSessionQueueNameOrArn)
1727
1737
 
1728
1738
  GetComputeAccessInput.add_member(:fleet_id, Shapes::ShapeRef.new(shape: FleetIdOrArn, required: true, location_name: "FleetId"))
@@ -2002,6 +2012,12 @@ module Aws::GameLift
2002
2012
  LogConfiguration.add_member(:log_group_arn, Shapes::ShapeRef.new(shape: LogGroupArnStringModel, location_name: "LogGroupArn"))
2003
2013
  LogConfiguration.struct_class = Types::LogConfiguration
2004
2014
 
2015
+ LogDeliveryDestination.add_member(:log_destination, Shapes::ShapeRef.new(shape: LogDeliveryDestinationType, required: true, location_name: "LogDestination"))
2016
+ LogDeliveryDestination.add_member(:destination_arn, Shapes::ShapeRef.new(shape: DeliveryDestinationArnStringModel, location_name: "DestinationArn"))
2017
+ LogDeliveryDestination.struct_class = Types::LogDeliveryDestination
2018
+
2019
+ LogDeliveryDestinationList.member = Shapes::ShapeRef.new(shape: LogDeliveryDestination)
2020
+
2005
2021
  ManagedCapacityConfiguration.add_member(:zero_capacity_strategy, Shapes::ShapeRef.new(shape: ZeroCapacityStrategy, location_name: "ZeroCapacityStrategy"))
2006
2022
  ManagedCapacityConfiguration.add_member(:scale_in_after_inactivity_minutes, Shapes::ShapeRef.new(shape: ScaleInAfterInactivityMinutes, location_name: "ScaleInAfterInactivityMinutes"))
2007
2023
  ManagedCapacityConfiguration.struct_class = Types::ManagedCapacityConfiguration
@@ -2564,6 +2580,8 @@ module Aws::GameLift
2564
2580
  UpdateGameSessionQueueInput.add_member(:priority_configuration, Shapes::ShapeRef.new(shape: PriorityConfiguration, location_name: "PriorityConfiguration"))
2565
2581
  UpdateGameSessionQueueInput.add_member(:custom_event_data, Shapes::ShapeRef.new(shape: QueueCustomEventData, location_name: "CustomEventData"))
2566
2582
  UpdateGameSessionQueueInput.add_member(:notification_target, Shapes::ShapeRef.new(shape: QueueSnsArnStringModel, location_name: "NotificationTarget"))
2583
+ UpdateGameSessionQueueInput.add_member(:add_log_delivery_destinations, Shapes::ShapeRef.new(shape: LogDeliveryDestinationList, location_name: "AddLogDeliveryDestinations"))
2584
+ UpdateGameSessionQueueInput.add_member(:remove_log_delivery_destinations, Shapes::ShapeRef.new(shape: LogDeliveryDestinationList, location_name: "RemoveLogDeliveryDestinations"))
2567
2585
  UpdateGameSessionQueueInput.struct_class = Types::UpdateGameSessionQueueInput
2568
2586
 
2569
2587
  UpdateGameSessionQueueOutput.add_member(:game_session_queue, Shapes::ShapeRef.new(shape: GameSessionQueue, location_name: "GameSessionQueue"))
@@ -2870,10 +2870,10 @@ module Aws::GameLift
2870
2870
  #
2871
2871
  # @!attribute [rw] priority_configuration
2872
2872
  # Custom settings to use when prioritizing destinations and locations
2873
- # for game session placements. This configuration replaces the FleetIQ
2874
- # default prioritization process. Priority types that are not
2875
- # explicitly named will be automatically applied at the end of the
2876
- # prioritization process.
2873
+ # for game session placements. This configuration replaces the default
2874
+ # prioritization process. Priority types that are not explicitly named
2875
+ # will be automatically applied at the end of the prioritization
2876
+ # process.
2877
2877
  # @return [Types::PriorityConfiguration]
2878
2878
  #
2879
2879
  # @!attribute [rw] custom_event_data
@@ -2904,6 +2904,15 @@ module Aws::GameLift
2904
2904
  # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
2905
2905
  # @return [Array<Types::Tag>]
2906
2906
  #
2907
+ # @!attribute [rw] log_configuration
2908
+ # An optional configuration that delivers game session placement
2909
+ # insight logs to one or more destinations of your choice. Use these
2910
+ # logs to diagnose why a game session placement is `FULFILLED`,
2911
+ # `CANCELLED`, `TIMED_OUT`, or `FAILED`, which locations were
2912
+ # evaluated, and the latency and cost factors that influenced each
2913
+ # decision.
2914
+ # @return [Types::GameSessionQueueLogConfiguration]
2915
+ #
2907
2916
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameSessionQueueInput AWS API Documentation
2908
2917
  #
2909
2918
  class CreateGameSessionQueueInput < Struct.new(
@@ -2915,7 +2924,8 @@ module Aws::GameLift
2915
2924
  :priority_configuration,
2916
2925
  :custom_event_data,
2917
2926
  :notification_target,
2918
- :tags)
2927
+ :tags,
2928
+ :log_configuration)
2919
2929
  SENSITIVE = [:custom_event_data]
2920
2930
  include Aws::Structure
2921
2931
  end
@@ -3822,29 +3832,62 @@ module Aws::GameLift
3822
3832
  class DeleteVpcPeeringConnectionOutput < Aws::EmptyStructure; end
3823
3833
 
3824
3834
  # Set of rules for processing a deployment for a container fleet update.
3835
+ # For how Amazon GameLift Servers validates and rolls out a deployment,
3836
+ # see [Container fleet deployments][1].
3837
+ #
3838
+ #
3839
+ #
3840
+ # [1]: https://docs.aws.amazon.com/gameliftservers/latest/developerguide/containers-deployment-validation.html
3825
3841
  #
3826
3842
  # @!attribute [rw] protection_strategy
3827
3843
  # Determines how fleet deployment activity affects active game
3828
- # sessions on the fleet. With protection, a deployment honors game
3829
- # session protection, and delays actions that would interrupt a
3830
- # protected active game session until the game session ends. Without
3831
- # protection, deployment activity can shut down all running tasks,
3832
- # including active game sessions, regardless of game session
3833
- # protection.
3844
+ # sessions on the fleet. A protected game session can't be terminated
3845
+ # while it's active; a fleet sets the default protection for its new
3846
+ # game sessions with `NewGameSessionProtectionPolicy`.
3847
+ #
3848
+ # * `WITH_PROTECTION` -- The deployment honors game session
3849
+ # protection, and delays actions that would interrupt a protected
3850
+ # active game session until the game session ends.
3851
+ #
3852
+ # * `IGNORE_PROTECTION` -- The deployment replaces containers
3853
+ # regardless of game session activity, including active game
3854
+ # sessions. This option is useful during development and testing.
3855
+ #
3856
+ # This setting also affects how long deployment validation can take.
3857
+ # When the fleet's `NewGameSessionProtectionPolicy` is
3858
+ # `FullProtection` and the deployment uses `WITH_PROTECTION`,
3859
+ # validation waits for protected game sessions to end.
3860
+ #
3861
+ # Default value: `WITH_PROTECTION`
3834
3862
  # @return [String]
3835
3863
  #
3836
3864
  # @!attribute [rw] minimum_healthy_percentage
3837
- # Sets a minimum level of healthy tasks to maintain during deployment
3838
- # activity.
3865
+ # Sets the minimum percentage of the fleet's game server container
3866
+ # groups to keep healthy during deployment activity. A low value
3867
+ # favors deployment speed; a high value favors game server
3868
+ # availability. For example, if the fleet runs 20 game server
3869
+ # container groups and this value is 75, Amazon GameLift Servers keeps
3870
+ # at least 15 of them healthy, so it replaces no more than 5 at a
3871
+ # time.
3872
+ #
3873
+ # Default value: 75
3839
3874
  # @return [Integer]
3840
3875
  #
3841
3876
  # @!attribute [rw] impairment_strategy
3842
- # Determines what actions to take if a deployment fails. If the fleet
3843
- # is multi-location, this strategy applies across all fleet locations.
3844
- # With a rollback strategy, updated fleet instances are rolled back to
3845
- # the last successful deployment. Alternatively, you can maintain a
3846
- # few impaired containers for the purpose of debugging, while all
3847
- # other tasks return to the last successful deployment.
3877
+ # Determines what actions to take if a deployment fails validation. If
3878
+ # the fleet is multi-location, this strategy applies across all fleet
3879
+ # locations.
3880
+ #
3881
+ # * `ROLLBACK` -- Returns all of the fleet's containers to the last
3882
+ # successful deployment.
3883
+ #
3884
+ # * `MAINTAIN` -- Keeps the containers that failed validation in place
3885
+ # so that you can inspect them, and returns all other containers to
3886
+ # the last successful deployment. Use this option when you're
3887
+ # deploying a container image that you want to be able to debug on
3888
+ # failure.
3889
+ #
3890
+ # Default value: `MAINTAIN`
3848
3891
  # @return [String]
3849
3892
  #
3850
3893
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeploymentConfiguration AWS API Documentation
@@ -6322,22 +6365,40 @@ module Aws::GameLift
6322
6365
  # @return [String]
6323
6366
  #
6324
6367
  # @!attribute [rw] deployment_status
6325
- # The status of fleet deployment activity in the location.
6368
+ # The status of the fleet deployment. For per-location status, see
6369
+ # `LocationalDeployment`.
6326
6370
  #
6327
- # * `IN_PROGRESS` -- The deployment is in progress.
6371
+ # * `PENDING` -- Amazon GameLift Servers has accepted the deployment
6372
+ # and hasn't started it yet.
6328
6373
  #
6329
- # * `IMPAIRED` -- The deployment failed and the fleet has some
6330
- # impaired containers.
6374
+ # * `IN_PROGRESS` -- The deployment is in progress. This status covers
6375
+ # validation as well as the replacement of the fleet's containers.
6331
6376
  #
6332
- # * `COMPLETE` -- The deployment has completed successfully.
6377
+ # * `IMPAIRED` -- The deployment failed validation, and the fleet kept
6378
+ # the containers that failed validation so that you can inspect
6379
+ # them. A deployment reaches this status when its impairment
6380
+ # strategy is `MAINTAIN`.
6381
+ #
6382
+ # * `COMPLETE` -- The deployment has completed successfully in every
6383
+ # fleet location.
6333
6384
  #
6334
6385
  # * `ROLLBACK_IN_PROGRESS` -- The deployment failed and rollback has
6335
- # been initiated.
6386
+ # been initiated. A deployment reaches this status when its
6387
+ # impairment strategy is `ROLLBACK`.
6388
+ #
6389
+ # * `ROLLBACK_COMPLETE` -- The deployment failed and rollback has been
6390
+ # completed. The fleet is running the configuration from the last
6391
+ # successful deployment.
6392
+ #
6393
+ # * `CANCELLED` -- The deployment was cancelled because a new
6394
+ # deployment started for the same fleet.
6395
+ #
6396
+ # For how to debug an impaired deployment or cancel one, see
6397
+ # [Container fleet deployments][1].
6398
+ #
6336
6399
  #
6337
- # * `ROLLBACK_IN_COMPLETE` -- The deployment failed and rollback has
6338
- # been completed.
6339
6400
  #
6340
- # * `CANCELLED` -- The deployment was cancelled.
6401
+ # [1]: https://docs.aws.amazon.com/gameliftservers/latest/developerguide/containers-deployment-validation.html
6341
6402
  # @return [String]
6342
6403
  #
6343
6404
  # @!attribute [rw] deployment_configuration
@@ -7818,10 +7879,10 @@ module Aws::GameLift
7818
7879
  #
7819
7880
  # @!attribute [rw] priority_configuration
7820
7881
  # Custom settings to use when prioritizing destinations and locations
7821
- # for game session placements. This configuration replaces the FleetIQ
7822
- # default prioritization process. Priority types that are not
7823
- # explicitly named will be automatically applied at the end of the
7824
- # prioritization process.
7882
+ # for game session placements. This configuration replaces the default
7883
+ # prioritization process. Priority types that are not explicitly named
7884
+ # will be automatically applied at the end of the prioritization
7885
+ # process.
7825
7886
  # @return [Types::PriorityConfiguration]
7826
7887
  #
7827
7888
  # @!attribute [rw] custom_event_data
@@ -7839,6 +7900,15 @@ module Aws::GameLift
7839
7900
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
7840
7901
  # @return [String]
7841
7902
  #
7903
+ # @!attribute [rw] log_configuration
7904
+ # An optional configuration that delivers game session placement
7905
+ # insight logs to one or more destinations of your choice. Use these
7906
+ # logs to diagnose why a game session placement is `FULFILLED`,
7907
+ # `CANCELLED`, `TIMED_OUT`, or `FAILED`, which locations were
7908
+ # evaluated, and the latency and cost factors that influenced each
7909
+ # decision.
7910
+ # @return [Types::GameSessionQueueLogConfiguration]
7911
+ #
7842
7912
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSessionQueue AWS API Documentation
7843
7913
  #
7844
7914
  class GameSessionQueue < Struct.new(
@@ -7850,7 +7920,8 @@ module Aws::GameLift
7850
7920
  :filter_configuration,
7851
7921
  :priority_configuration,
7852
7922
  :custom_event_data,
7853
- :notification_target)
7923
+ :notification_target,
7924
+ :log_configuration)
7854
7925
  SENSITIVE = [:custom_event_data]
7855
7926
  include Aws::Structure
7856
7927
  end
@@ -7873,6 +7944,23 @@ module Aws::GameLift
7873
7944
  include Aws::Structure
7874
7945
  end
7875
7946
 
7947
+ # A configuration that delivers game session placement insight logs to
7948
+ # one or more destinations of your choice.
7949
+ #
7950
+ # @!attribute [rw] delivery_destinations
7951
+ # The destinations that receive game session placement insight logs
7952
+ # for the queue. You can specify up to 3 destinations. Each
7953
+ # destination must have a unique ARN.
7954
+ # @return [Array<Types::LogDeliveryDestination>]
7955
+ #
7956
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSessionQueueLogConfiguration AWS API Documentation
7957
+ #
7958
+ class GameSessionQueueLogConfiguration < Struct.new(
7959
+ :delivery_destinations)
7960
+ SENSITIVE = []
7961
+ include Aws::Structure
7962
+ end
7963
+
7876
7964
  # @!attribute [rw] fleet_id
7877
7965
  # A unique identifier for the fleet that holds the compute resource
7878
7966
  # that you want to connect to. You can use either the fleet ID or ARN
@@ -9402,20 +9490,28 @@ module Aws::GameLift
9402
9490
  # @!attribute [rw] deployment_status
9403
9491
  # The status of fleet deployment activity in the location.
9404
9492
  #
9405
- # * `IN_PROGRESS` -- The deployment is in progress.
9493
+ # * `IN_PROGRESS` -- The deployment is in progress in the location.
9494
+ # This status covers validation as well as the replacement of the
9495
+ # location's containers.
9406
9496
  #
9407
- # * `IMPAIRED` -- The deployment failed and the fleet has some
9408
- # impaired containers.
9497
+ # * `IMPAIRED` -- The deployment failed validation in the location,
9498
+ # and the location kept the containers that failed validation so
9499
+ # that you can inspect them. A location reaches this status when the
9500
+ # deployment's impairment strategy is `MAINTAIN`.
9409
9501
  #
9410
- # * `COMPLETE` -- The deployment has completed successfully.
9502
+ # * `COMPLETE` -- The deployment has completed successfully in the
9503
+ # location.
9411
9504
  #
9412
9505
  # * `ROLLBACK_IN_PROGRESS` -- The deployment failed and rollback has
9413
- # been initiated.
9506
+ # been initiated in the location. A location reaches this status
9507
+ # when the deployment's impairment strategy is `ROLLBACK`.
9414
9508
  #
9415
- # * `ROLLBACK_IN_COMPLETE` -- The deployment failed and rollback has
9416
- # been completed.
9509
+ # * `ROLLBACK_COMPLETE` -- The deployment failed and rollback has been
9510
+ # completed in the location. The location is running the
9511
+ # configuration from the last successful deployment.
9417
9512
  #
9418
- # * `CANCELLED` -- The deployment was cancelled.
9513
+ # * `CANCELLED` -- The deployment was cancelled because a new
9514
+ # deployment started for the same fleet.
9419
9515
  # @return [String]
9420
9516
  #
9421
9517
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/LocationalDeployment AWS API Documentation
@@ -9465,6 +9561,50 @@ module Aws::GameLift
9465
9561
  include Aws::Structure
9466
9562
  end
9467
9563
 
9564
+ # A single destination that receives game session placement insight logs
9565
+ # for a game session queue.
9566
+ #
9567
+ # <note markdown="1"> Amazon CloudWatch Logs vended log charges apply to each destination.
9568
+ # Amazon S3 and Amazon Data Firehose destinations also incur their own
9569
+ # service charges. For more information, see [Amazon CloudWatch
9570
+ # Pricing][1].
9571
+ #
9572
+ # </note>
9573
+ #
9574
+ #
9575
+ #
9576
+ # [1]: http://aws.amazon.com/cloudwatch/pricing/
9577
+ #
9578
+ # @!attribute [rw] log_destination
9579
+ # The type of Amazon Web Services resource that receives the game
9580
+ # session placement insight logs. This value is required. Valid values
9581
+ # are:
9582
+ #
9583
+ # * `CLOUDWATCH` -- an Amazon CloudWatch Logs log group.
9584
+ #
9585
+ # * `S3` -- an Amazon S3 bucket.
9586
+ #
9587
+ # * `FIREHOSE` -- an Amazon Data Firehose delivery stream.
9588
+ # @return [String]
9589
+ #
9590
+ # @!attribute [rw] destination_arn
9591
+ # The Amazon Resource Name (ARN) of the resource that receives the
9592
+ # game session placement insight logs. This resource must match the
9593
+ # type that you specify in `LogDestination`. This value is required
9594
+ # for `FIREHOSE` destinations. For `CLOUDWATCH` and `S3`, you can omit
9595
+ # this value; Amazon GameLift Servers then creates a destination
9596
+ # resource of the specified type on your behalf.
9597
+ # @return [String]
9598
+ #
9599
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/LogDeliveryDestination AWS API Documentation
9600
+ #
9601
+ class LogDeliveryDestination < Struct.new(
9602
+ :log_destination,
9603
+ :destination_arn)
9604
+ SENSITIVE = []
9605
+ include Aws::Structure
9606
+ end
9607
+
9468
9608
  # Use ManagedCapacityConfiguration with the
9469
9609
  # "SCALE\_TO\_AND\_FROM\_ZERO" ZeroCapacityStrategy to enable Amazon
9470
9610
  # GameLift Servers to fully manage the MinSize value, switching between
@@ -13316,11 +13456,11 @@ module Aws::GameLift
13316
13456
  #
13317
13457
  # @!attribute [rw] priority_configuration
13318
13458
  # Custom settings to use when prioritizing destinations and locations
13319
- # for game session placements. This configuration replaces the FleetIQ
13320
- # default prioritization process. Priority types that are not
13321
- # explicitly named will be automatically applied at the end of the
13322
- # prioritization process. To remove an existing priority
13323
- # configuration, pass in an empty set.
13459
+ # for game session placements. This configuration replaces the default
13460
+ # prioritization process. Priority types that are not explicitly named
13461
+ # will be automatically applied at the end of the prioritization
13462
+ # process. To remove an existing priority configuration, pass in an
13463
+ # empty set.
13324
13464
  # @return [Types::PriorityConfiguration]
13325
13465
  #
13326
13466
  # @!attribute [rw] custom_event_data
@@ -13338,6 +13478,16 @@ module Aws::GameLift
13338
13478
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queue-notification.html
13339
13479
  # @return [String]
13340
13480
  #
13481
+ # @!attribute [rw] add_log_delivery_destinations
13482
+ # Log delivery destinations to add to the queue's log configuration
13483
+ # (`LogConfiguration`).
13484
+ # @return [Array<Types::LogDeliveryDestination>]
13485
+ #
13486
+ # @!attribute [rw] remove_log_delivery_destinations
13487
+ # Log delivery destinations to remove from the queue's log
13488
+ # configuration (`LogConfiguration`).
13489
+ # @return [Array<Types::LogDeliveryDestination>]
13490
+ #
13341
13491
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameSessionQueueInput AWS API Documentation
13342
13492
  #
13343
13493
  class UpdateGameSessionQueueInput < Struct.new(
@@ -13348,7 +13498,9 @@ module Aws::GameLift
13348
13498
  :filter_configuration,
13349
13499
  :priority_configuration,
13350
13500
  :custom_event_data,
13351
- :notification_target)
13501
+ :notification_target,
13502
+ :add_log_delivery_destinations,
13503
+ :remove_log_delivery_destinations)
13352
13504
  SENSITIVE = [:custom_event_data]
13353
13505
  include Aws::Structure
13354
13506
  end
@@ -54,7 +54,7 @@ module Aws::GameLift
54
54
  autoload :EndpointProvider, 'aws-sdk-gamelift/endpoint_provider'
55
55
  autoload :Endpoints, 'aws-sdk-gamelift/endpoints'
56
56
 
57
- GEM_VERSION = '1.146.0'
57
+ GEM_VERSION = '1.148.0'
58
58
 
59
59
  end
60
60
 
data/sig/client.rbs CHANGED
@@ -404,7 +404,15 @@ module Aws
404
404
  key: ::String,
405
405
  value: ::String
406
406
  }
407
- ]
407
+ ],
408
+ ?log_configuration: {
409
+ delivery_destinations: Array[
410
+ {
411
+ log_destination: ("CLOUDWATCH" | "S3" | "FIREHOSE"),
412
+ destination_arn: ::String?
413
+ }
414
+ ]
415
+ }
408
416
  ) -> _CreateGameSessionQueueResponseSuccess
409
417
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateGameSessionQueueResponseSuccess
410
418
 
@@ -1855,7 +1863,19 @@ module Aws
1855
1863
  location_order: Array[::String]?
1856
1864
  },
1857
1865
  ?custom_event_data: ::String,
1858
- ?notification_target: ::String
1866
+ ?notification_target: ::String,
1867
+ ?add_log_delivery_destinations: Array[
1868
+ {
1869
+ log_destination: ("CLOUDWATCH" | "S3" | "FIREHOSE"),
1870
+ destination_arn: ::String?
1871
+ }
1872
+ ],
1873
+ ?remove_log_delivery_destinations: Array[
1874
+ {
1875
+ log_destination: ("CLOUDWATCH" | "S3" | "FIREHOSE"),
1876
+ destination_arn: ::String?
1877
+ }
1878
+ ]
1859
1879
  ) -> _UpdateGameSessionQueueResponseSuccess
1860
1880
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateGameSessionQueueResponseSuccess
1861
1881
 
data/sig/types.rbs CHANGED
@@ -403,6 +403,7 @@ module Aws::GameLift
403
403
  attr_accessor custom_event_data: ::String
404
404
  attr_accessor notification_target: ::String
405
405
  attr_accessor tags: ::Array[Types::Tag]
406
+ attr_accessor log_configuration: Types::GameSessionQueueLogConfiguration
406
407
  SENSITIVE: [:custom_event_data]
407
408
  end
408
409
 
@@ -1364,6 +1365,7 @@ module Aws::GameLift
1364
1365
  attr_accessor priority_configuration: Types::PriorityConfiguration
1365
1366
  attr_accessor custom_event_data: ::String
1366
1367
  attr_accessor notification_target: ::String
1368
+ attr_accessor log_configuration: Types::GameSessionQueueLogConfiguration
1367
1369
  SENSITIVE: [:custom_event_data]
1368
1370
  end
1369
1371
 
@@ -1372,6 +1374,11 @@ module Aws::GameLift
1372
1374
  SENSITIVE: []
1373
1375
  end
1374
1376
 
1377
+ class GameSessionQueueLogConfiguration
1378
+ attr_accessor delivery_destinations: ::Array[Types::LogDeliveryDestination]
1379
+ SENSITIVE: []
1380
+ end
1381
+
1375
1382
  class GetComputeAccessInput
1376
1383
  attr_accessor fleet_id: ::String
1377
1384
  attr_accessor compute_name: ::String
@@ -1731,6 +1738,12 @@ module Aws::GameLift
1731
1738
  SENSITIVE: []
1732
1739
  end
1733
1740
 
1741
+ class LogDeliveryDestination
1742
+ attr_accessor log_destination: ("CLOUDWATCH" | "S3" | "FIREHOSE")
1743
+ attr_accessor destination_arn: ::String
1744
+ SENSITIVE: []
1745
+ end
1746
+
1734
1747
  class ManagedCapacityConfiguration
1735
1748
  attr_accessor zero_capacity_strategy: ("MANUAL" | "SCALE_TO_AND_FROM_ZERO")
1736
1749
  attr_accessor scale_in_after_inactivity_minutes: ::Integer
@@ -2410,6 +2423,8 @@ module Aws::GameLift
2410
2423
  attr_accessor priority_configuration: Types::PriorityConfiguration
2411
2424
  attr_accessor custom_event_data: ::String
2412
2425
  attr_accessor notification_target: ::String
2426
+ attr_accessor add_log_delivery_destinations: ::Array[Types::LogDeliveryDestination]
2427
+ attr_accessor remove_log_delivery_destinations: ::Array[Types::LogDeliveryDestination]
2413
2428
  SENSITIVE: [:custom_event_data]
2414
2429
  end
2415
2430
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-gamelift
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.146.0
4
+ version: 1.148.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
@@ -18,7 +18,7 @@ dependencies:
18
18
  version: '3'
19
19
  - - ">="
20
20
  - !ruby/object:Gem::Version
21
- version: 3.266.0
21
+ version: 3.268.0
22
22
  type: :runtime
23
23
  prerelease: false
24
24
  version_requirements: !ruby/object:Gem::Requirement
@@ -28,7 +28,7 @@ dependencies:
28
28
  version: '3'
29
29
  - - ">="
30
30
  - !ruby/object:Gem::Version
31
- version: 3.266.0
31
+ version: 3.268.0
32
32
  - !ruby/object:Gem::Dependency
33
33
  name: aws-sigv4
34
34
  requirement: !ruby/object:Gem::Requirement