aws-sdk-gameliftstreams 1.17.0 → 1.18.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: 46b24d9b4ccef50c7aca8efc33f6f187a11b6e4f752584bb6e18ec9c3d9ef8f6
4
- data.tar.gz: a95d4b4c8da200068942ec352bb9fd52dff3279cb422c49449d06ef5057d5719
3
+ metadata.gz: 50e5d2af83206f00a27d4ee0bef21eef86cb58546cd6c6177ad5b58fc430e547
4
+ data.tar.gz: 3494e5f536725d59bcfb6c619a779349fd9e310ccb96aa9af1f474cf7b71a6e7
5
5
  SHA512:
6
- metadata.gz: 1e326baa1f74e191af45cacd901bb41d7c04695e383502d572b83480d3fab4dc85c168757c8cbac0df2e86593d25ed9063199f4922fc719740e5228c6606414c
7
- data.tar.gz: 148015d76f036a3e94f171a3606ccf9e3ee224a7074dcb37e2ff9274abed67bfdaaa55fe0563ed7026be92c991e0c2c0525756f8cc36dd0e3b7850f7e46252f6
6
+ metadata.gz: 3d0a292a306a44aa7187c1f838a979cb391f5a5379db1fe6d006c85ddb62964339cdfab397e423cc91a18c5c3c3ff895dfd833671c780ca6f78695776f336262
7
+ data.tar.gz: 1b280d889a656f256a7bb7bc7e0e5a3b799260ac2181a188a72d78e98794f9df438580b9bd6b12f9fcc41d74abc94edae97de0479677f16a31f19b54f6ee0b93
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.18.0 (2025-12-17)
5
+ ------------------
6
+
7
+ * Feature - Added new stream group operation parameters for scale-on-demand capacity with automatic prewarming. Added new Gen6 stream classes based on the EC2 G6 instance family. Added new StartStreamSession parameter for exposure of real-time performance stats to clients.
8
+
4
9
  1.17.0 (2025-11-21)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.17.0
1
+ 1.18.0
@@ -520,6 +520,8 @@ module Aws::GameLiftStreams
520
520
  # location_name: "LocationName", # required
521
521
  # always_on_capacity: 1,
522
522
  # on_demand_capacity: 1,
523
+ # target_idle_capacity: 1,
524
+ # maximum_capacity: 1,
523
525
  # },
524
526
  # ],
525
527
  # })
@@ -532,6 +534,8 @@ module Aws::GameLiftStreams
532
534
  # resp.locations[0].status #=> String, one of "ACTIVATING", "ACTIVE", "ERROR", "REMOVING"
533
535
  # resp.locations[0].always_on_capacity #=> Integer
534
536
  # resp.locations[0].on_demand_capacity #=> Integer
537
+ # resp.locations[0].target_idle_capacity #=> Integer
538
+ # resp.locations[0].maximum_capacity #=> Integer
535
539
  # resp.locations[0].requested_capacity #=> Integer
536
540
  # resp.locations[0].allocated_capacity #=> Integer
537
541
  # resp.locations[0].idle_capacity #=> Integer
@@ -815,20 +819,24 @@ module Aws::GameLiftStreams
815
819
  #
816
820
  # Stream capacity represents the number of concurrent streams that can
817
821
  # be active at a time. You set stream capacity per location, per stream
818
- # group. There are two types of capacity, always-on and on-demand:
819
- #
820
- # * **Always-on**: The streaming capacity that is allocated and ready to
821
- # handle stream requests without delay. You pay for this capacity
822
- # whether it's in use or not. Best for quickest time from streaming
823
- # request to streaming session. Default is 1 (2 for high stream
824
- # classes) when creating a stream group or adding a location.
825
- #
826
- # * **On-demand**: The streaming capacity that Amazon GameLift Streams
827
- # can allocate in response to stream requests, and then de-allocate
828
- # when the session has terminated. This offers a cost control measure
829
- # at the expense of a greater startup time (typically under 5
830
- # minutes). Default is 0 when creating a stream group or adding a
831
- # location.
822
+ # group. The following capacity settings are available:
823
+ #
824
+ # * **Always-on capacity**: This setting, if non-zero, indicates minimum
825
+ # streaming capacity which is allocated to you and is never released
826
+ # back to the service. You pay for this base level of capacity at all
827
+ # times, whether used or idle.
828
+ #
829
+ # * **Maximum capacity**: This indicates the maximum capacity that the
830
+ # service can allocate for you. Newly created streams may take a few
831
+ # minutes to start. Capacity is released back to the service when
832
+ # idle. You pay for capacity that is allocated to you until it is
833
+ # released.
834
+ #
835
+ # * **Target-idle capacity**: This indicates idle capacity which the
836
+ # service pre-allocates and holds for you in anticipation of future
837
+ # activity. This helps to insulate your users from capacity-allocation
838
+ # delays. You pay for capacity which is held in this intentional idle
839
+ # state.
832
840
  #
833
841
  # Values for capacity must be whole number multiples of the tenancy
834
842
  # value of the stream group's stream class.
@@ -870,12 +878,95 @@ module Aws::GameLiftStreams
870
878
  #
871
879
  # A stream class can be one of the following:
872
880
  #
881
+ # * <b> <code>gen6n_pro_win2022</code> (NVIDIA, pro)</b> Supports
882
+ # applications with extremely high 3D scene complexity which require
883
+ # maximum resources. Runs applications on Microsoft Windows Server
884
+ # 2022 Base and supports DirectX 12. Compatible with Unreal Engine
885
+ # versions up through 5.6, 32 and 64-bit applications, and anti-cheat
886
+ # technology. Uses NVIDIA L4 Tensor Core GPU.
887
+ #
888
+ # * Reference resolution: 1080p
889
+ #
890
+ # * Reference frame rate: 60 fps
891
+ #
892
+ # * Workload specifications: 16 vCPUs, 64 GB RAM, 24 GB VRAM
893
+ #
894
+ # * Tenancy: Supports 1 concurrent stream session
895
+ # * <b> <code>gen6n_pro</code> (NVIDIA, pro)</b> Supports applications
896
+ # with extremely high 3D scene complexity which require maximum
897
+ # resources. Uses dedicated NVIDIA L4 Tensor Core GPU.
898
+ #
899
+ # * Reference resolution: 1080p
900
+ #
901
+ # * Reference frame rate: 60 fps
902
+ #
903
+ # * Workload specifications: 16 vCPUs, 64 GB RAM, 24 GB VRAM
904
+ #
905
+ # * Tenancy: Supports 1 concurrent stream session
906
+ # * <b> <code>gen6n_ultra_win2022</code> (NVIDIA, ultra)</b> Supports
907
+ # applications with high 3D scene complexity. Runs applications on
908
+ # Microsoft Windows Server 2022 Base and supports DirectX 12.
909
+ # Compatible with Unreal Engine versions up through 5.6, 32 and 64-bit
910
+ # applications, and anti-cheat technology. Uses NVIDIA L4 Tensor Core
911
+ # GPU.
912
+ #
913
+ # * Reference resolution: 1080p
914
+ #
915
+ # * Reference frame rate: 60 fps
916
+ #
917
+ # * Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
918
+ #
919
+ # * Tenancy: Supports 1 concurrent stream session
920
+ # * <b> <code>gen6n_ultra</code> (NVIDIA, ultra)</b> Supports
921
+ # applications with high 3D scene complexity. Uses dedicated NVIDIA L4
922
+ # Tensor Core GPU.
923
+ #
924
+ # * Reference resolution: 1080p
925
+ #
926
+ # * Reference frame rate: 60 fps
927
+ #
928
+ # * Workload specifications: 8 vCPUs, 32 GB RAM, 24 GB VRAM
929
+ #
930
+ # * Tenancy: Supports 1 concurrent stream session
931
+ # * <b> <code>gen6n_high</code> (NVIDIA, high)</b> Supports applications
932
+ # with moderate to high 3D scene complexity. Uses NVIDIA L4 Tensor
933
+ # Core GPU.
934
+ #
935
+ # * Reference resolution: 1080p
936
+ #
937
+ # * Reference frame rate: 60 fps
938
+ #
939
+ # * Workload specifications: 4 vCPUs, 16 GB RAM, 12 GB VRAM
940
+ #
941
+ # * Tenancy: Supports up to 2 concurrent stream sessions
942
+ # * <b> <code>gen6n_medium</code> (NVIDIA, medium)</b> Supports
943
+ # applications with moderate 3D scene complexity. Uses NVIDIA L4
944
+ # Tensor Core GPU.
945
+ #
946
+ # * Reference resolution: 1080p
947
+ #
948
+ # * Reference frame rate: 60 fps
949
+ #
950
+ # * Workload specifications: 2 vCPUs, 8 GB RAM, 6 GB VRAM
951
+ #
952
+ # * Tenancy: Supports up to 4 concurrent stream sessions
953
+ # * <b> <code>gen6n_small</code> (NVIDIA, small)</b> Supports
954
+ # applications with lightweight 3D scene complexity and low CPU usage.
955
+ # Uses NVIDIA L4 Tensor Core GPU.
956
+ #
957
+ # * Reference resolution: 1080p
958
+ #
959
+ # * Reference frame rate: 60 fps
960
+ #
961
+ # * Workload specifications: 1 vCPUs, 4 GB RAM, 2 GB VRAM
962
+ #
963
+ # * Tenancy: Supports up to 12 concurrent stream sessions
873
964
  # * <b> <code>gen5n_win2022</code> (NVIDIA, ultra)</b> Supports
874
965
  # applications with extremely high 3D scene complexity. Runs
875
966
  # applications on Microsoft Windows Server 2022 Base and supports
876
- # DirectX 12. Compatible with Unreal Engine versions up through 5.4,
967
+ # DirectX 12. Compatible with Unreal Engine versions up through 5.6,
877
968
  # 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA
878
- # A10G Tensor GPU.
969
+ # A10G Tensor Core GPU.
879
970
  #
880
971
  # * Reference resolution: 1080p
881
972
  #
@@ -886,7 +977,7 @@ module Aws::GameLiftStreams
886
977
  # * Tenancy: Supports 1 concurrent stream session
887
978
  # * <b> <code>gen5n_high</code> (NVIDIA, high)</b> Supports applications
888
979
  # with moderate to high 3D scene complexity. Uses NVIDIA A10G Tensor
889
- # GPU.
980
+ # Core GPU.
890
981
  #
891
982
  # * Reference resolution: 1080p
892
983
  #
@@ -897,7 +988,7 @@ module Aws::GameLiftStreams
897
988
  # * Tenancy: Supports up to 2 concurrent stream sessions
898
989
  # * <b> <code>gen5n_ultra</code> (NVIDIA, ultra)</b> Supports
899
990
  # applications with extremely high 3D scene complexity. Uses dedicated
900
- # NVIDIA A10G Tensor GPU.
991
+ # NVIDIA A10G Tensor Core GPU.
901
992
  #
902
993
  # * Reference resolution: 1080p
903
994
  #
@@ -909,9 +1000,9 @@ module Aws::GameLiftStreams
909
1000
  # * <b> <code>gen4n_win2022</code> (NVIDIA, ultra)</b> Supports
910
1001
  # applications with extremely high 3D scene complexity. Runs
911
1002
  # applications on Microsoft Windows Server 2022 Base and supports
912
- # DirectX 12. Compatible with Unreal Engine versions up through 5.4,
1003
+ # DirectX 12. Compatible with Unreal Engine versions up through 5.6,
913
1004
  # 32 and 64-bit applications, and anti-cheat technology. Uses NVIDIA
914
- # T4 Tensor GPU.
1005
+ # T4 Tensor Core GPU.
915
1006
  #
916
1007
  # * Reference resolution: 1080p
917
1008
  #
@@ -922,7 +1013,7 @@ module Aws::GameLiftStreams
922
1013
  # * Tenancy: Supports 1 concurrent stream session
923
1014
  # * <b> <code>gen4n_high</code> (NVIDIA, high)</b> Supports applications
924
1015
  # with moderate to high 3D scene complexity. Uses NVIDIA T4 Tensor
925
- # GPU.
1016
+ # Core GPU.
926
1017
  #
927
1018
  # * Reference resolution: 1080p
928
1019
  #
@@ -933,7 +1024,7 @@ module Aws::GameLiftStreams
933
1024
  # * Tenancy: Supports up to 2 concurrent stream sessions
934
1025
  # * <b> <code>gen4n_ultra</code> (NVIDIA, ultra)</b> Supports
935
1026
  # applications with high 3D scene complexity. Uses dedicated NVIDIA T4
936
- # Tensor GPU.
1027
+ # Tensor Core GPU.
937
1028
  #
938
1029
  # * Reference resolution: 1080p
939
1030
  #
@@ -1013,13 +1104,15 @@ module Aws::GameLiftStreams
1013
1104
  #
1014
1105
  # resp = client.create_stream_group({
1015
1106
  # description: "Description", # required
1016
- # stream_class: "gen4n_high", # required, accepts gen4n_high, gen4n_ultra, gen4n_win2022, gen5n_high, gen5n_ultra, gen5n_win2022
1107
+ # stream_class: "gen4n_high", # required, accepts gen4n_high, gen4n_ultra, gen4n_win2022, gen5n_high, gen5n_ultra, gen5n_win2022, gen6n_small, gen6n_medium, gen6n_high, gen6n_ultra, gen6n_ultra_win2022, gen6n_pro, gen6n_pro_win2022
1017
1108
  # default_application_identifier: "Identifier",
1018
1109
  # location_configurations: [
1019
1110
  # {
1020
1111
  # location_name: "LocationName", # required
1021
1112
  # always_on_capacity: 1,
1022
1113
  # on_demand_capacity: 1,
1114
+ # target_idle_capacity: 1,
1115
+ # maximum_capacity: 1,
1023
1116
  # },
1024
1117
  # ],
1025
1118
  # tags: {
@@ -1039,10 +1132,12 @@ module Aws::GameLiftStreams
1039
1132
  # resp.location_states[0].status #=> String, one of "ACTIVATING", "ACTIVE", "ERROR", "REMOVING"
1040
1133
  # resp.location_states[0].always_on_capacity #=> Integer
1041
1134
  # resp.location_states[0].on_demand_capacity #=> Integer
1135
+ # resp.location_states[0].target_idle_capacity #=> Integer
1136
+ # resp.location_states[0].maximum_capacity #=> Integer
1042
1137
  # resp.location_states[0].requested_capacity #=> Integer
1043
1138
  # resp.location_states[0].allocated_capacity #=> Integer
1044
1139
  # resp.location_states[0].idle_capacity #=> Integer
1045
- # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022"
1140
+ # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022", "gen6n_small", "gen6n_medium", "gen6n_high", "gen6n_ultra", "gen6n_ultra_win2022", "gen6n_pro", "gen6n_pro_win2022"
1046
1141
  # resp.id #=> String
1047
1142
  # resp.status #=> String, one of "ACTIVATING", "UPDATING_LOCATIONS", "ACTIVE", "ACTIVE_WITH_ERRORS", "ERROR", "DELETING", "EXPIRED"
1048
1143
  # resp.status_reason #=> String, one of "internalError", "noAvailableInstances"
@@ -1562,10 +1657,12 @@ module Aws::GameLiftStreams
1562
1657
  # resp.location_states[0].status #=> String, one of "ACTIVATING", "ACTIVE", "ERROR", "REMOVING"
1563
1658
  # resp.location_states[0].always_on_capacity #=> Integer
1564
1659
  # resp.location_states[0].on_demand_capacity #=> Integer
1660
+ # resp.location_states[0].target_idle_capacity #=> Integer
1661
+ # resp.location_states[0].maximum_capacity #=> Integer
1565
1662
  # resp.location_states[0].requested_capacity #=> Integer
1566
1663
  # resp.location_states[0].allocated_capacity #=> Integer
1567
1664
  # resp.location_states[0].idle_capacity #=> Integer
1568
- # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022"
1665
+ # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022", "gen6n_small", "gen6n_medium", "gen6n_high", "gen6n_ultra", "gen6n_ultra_win2022", "gen6n_pro", "gen6n_pro_win2022"
1569
1666
  # resp.id #=> String
1570
1667
  # resp.status #=> String, one of "ACTIVATING", "UPDATING_LOCATIONS", "ACTIVE", "ACTIVE_WITH_ERRORS", "ERROR", "DELETING", "EXPIRED"
1571
1668
  # resp.status_reason #=> String, one of "internalError", "noAvailableInstances"
@@ -1633,6 +1730,7 @@ module Aws::GameLiftStreams
1633
1730
  # * {Types::GetStreamSessionOutput#session_length_seconds #session_length_seconds} => Integer
1634
1731
  # * {Types::GetStreamSessionOutput#additional_launch_args #additional_launch_args} => Array&lt;String&gt;
1635
1732
  # * {Types::GetStreamSessionOutput#additional_environment_variables #additional_environment_variables} => Hash&lt;String,String&gt;
1733
+ # * {Types::GetStreamSessionOutput#performance_stats_configuration #performance_stats_configuration} => Types::PerformanceStatsConfiguration
1636
1734
  # * {Types::GetStreamSessionOutput#log_file_location_uri #log_file_location_uri} => String
1637
1735
  # * {Types::GetStreamSessionOutput#web_sdk_protocol_url #web_sdk_protocol_url} => String
1638
1736
  # * {Types::GetStreamSessionOutput#last_updated_at #last_updated_at} => Time
@@ -1665,6 +1763,7 @@ module Aws::GameLiftStreams
1665
1763
  # resp.additional_launch_args[0] #=> String
1666
1764
  # resp.additional_environment_variables #=> Hash
1667
1765
  # resp.additional_environment_variables["EnvironmentVariablesKeyString"] #=> String
1766
+ # resp.performance_stats_configuration.shared_with_client #=> Boolean
1668
1767
  # resp.log_file_location_uri #=> String
1669
1768
  # resp.web_sdk_protocol_url #=> String
1670
1769
  # resp.last_updated_at #=> Time
@@ -1776,7 +1875,7 @@ module Aws::GameLiftStreams
1776
1875
  # resp.items[0].description #=> String
1777
1876
  # resp.items[0].default_application.id #=> String
1778
1877
  # resp.items[0].default_application.arn #=> String
1779
- # resp.items[0].stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022"
1878
+ # resp.items[0].stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022", "gen6n_small", "gen6n_medium", "gen6n_high", "gen6n_ultra", "gen6n_ultra_win2022", "gen6n_pro", "gen6n_pro_win2022"
1780
1879
  # resp.items[0].status #=> String, one of "ACTIVATING", "UPDATING_LOCATIONS", "ACTIVE", "ACTIVE_WITH_ERRORS", "ERROR", "DELETING", "EXPIRED"
1781
1880
  # resp.items[0].created_at #=> Time
1782
1881
  # resp.items[0].last_updated_at #=> Time
@@ -1865,6 +1964,7 @@ module Aws::GameLiftStreams
1865
1964
  # resp.items[0].arn #=> String
1866
1965
  # resp.items[0].user_id #=> String
1867
1966
  # resp.items[0].status #=> String, one of "ACTIVATING", "ACTIVE", "CONNECTED", "PENDING_CLIENT_RECONNECTION", "RECONNECTING", "TERMINATING", "TERMINATED", "ERROR"
1967
+ # resp.items[0].status_reason #=> String, one of "internalError", "invalidSignalRequest", "placementTimeout", "applicationLogS3DestinationError", "applicationExit", "connectionTimeout", "reconnectionTimeout", "maxSessionLengthTimeout", "idleTimeout", "apiTerminated"
1868
1968
  # resp.items[0].protocol #=> String, one of "WebRTC"
1869
1969
  # resp.items[0].last_updated_at #=> Time
1870
1970
  # resp.items[0].created_at #=> Time
@@ -1941,6 +2041,7 @@ module Aws::GameLiftStreams
1941
2041
  # resp.items[0].arn #=> String
1942
2042
  # resp.items[0].user_id #=> String
1943
2043
  # resp.items[0].status #=> String, one of "ACTIVATING", "ACTIVE", "CONNECTED", "PENDING_CLIENT_RECONNECTION", "RECONNECTING", "TERMINATING", "TERMINATED", "ERROR"
2044
+ # resp.items[0].status_reason #=> String, one of "internalError", "invalidSignalRequest", "placementTimeout", "applicationLogS3DestinationError", "applicationExit", "connectionTimeout", "reconnectionTimeout", "maxSessionLengthTimeout", "idleTimeout", "apiTerminated"
1944
2045
  # resp.items[0].protocol #=> String, one of "WebRTC"
1945
2046
  # resp.items[0].last_updated_at #=> Time
1946
2047
  # resp.items[0].created_at #=> Time
@@ -2281,6 +2382,10 @@ module Aws::GameLiftStreams
2281
2382
  # environment variables; while `AdditionalLaunchArgs` passes data using
2282
2383
  # command-line arguments.
2283
2384
  #
2385
+ # @option params [Types::PerformanceStatsConfiguration] :performance_stats_configuration
2386
+ # Configuration settings for sharing the stream session's performance
2387
+ # stats with the client
2388
+ #
2284
2389
  # @return [Types::StartStreamSessionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2285
2390
  #
2286
2391
  # * {Types::StartStreamSessionOutput#arn #arn} => String
@@ -2297,6 +2402,7 @@ module Aws::GameLiftStreams
2297
2402
  # * {Types::StartStreamSessionOutput#session_length_seconds #session_length_seconds} => Integer
2298
2403
  # * {Types::StartStreamSessionOutput#additional_launch_args #additional_launch_args} => Array&lt;String&gt;
2299
2404
  # * {Types::StartStreamSessionOutput#additional_environment_variables #additional_environment_variables} => Hash&lt;String,String&gt;
2405
+ # * {Types::StartStreamSessionOutput#performance_stats_configuration #performance_stats_configuration} => Types::PerformanceStatsConfiguration
2300
2406
  # * {Types::StartStreamSessionOutput#log_file_location_uri #log_file_location_uri} => String
2301
2407
  # * {Types::StartStreamSessionOutput#web_sdk_protocol_url #web_sdk_protocol_url} => String
2302
2408
  # * {Types::StartStreamSessionOutput#last_updated_at #last_updated_at} => Time
@@ -2321,6 +2427,9 @@ module Aws::GameLiftStreams
2321
2427
  # additional_environment_variables: {
2322
2428
  # "EnvironmentVariablesKeyString" => "EnvironmentVariablesValueString",
2323
2429
  # },
2430
+ # performance_stats_configuration: {
2431
+ # shared_with_client: false,
2432
+ # },
2324
2433
  # })
2325
2434
  #
2326
2435
  # @example Response structure
@@ -2341,6 +2450,7 @@ module Aws::GameLiftStreams
2341
2450
  # resp.additional_launch_args[0] #=> String
2342
2451
  # resp.additional_environment_variables #=> Hash
2343
2452
  # resp.additional_environment_variables["EnvironmentVariablesKeyString"] #=> String
2453
+ # resp.performance_stats_configuration.shared_with_client #=> Boolean
2344
2454
  # resp.log_file_location_uri #=> String
2345
2455
  # resp.web_sdk_protocol_url #=> String
2346
2456
  # resp.last_updated_at #=> Time
@@ -2606,20 +2716,24 @@ module Aws::GameLiftStreams
2606
2716
  #
2607
2717
  # Stream capacity represents the number of concurrent streams that can
2608
2718
  # be active at a time. You set stream capacity per location, per stream
2609
- # group. There are two types of capacity, always-on and on-demand:
2610
- #
2611
- # * **Always-on**: The streaming capacity that is allocated and ready to
2612
- # handle stream requests without delay. You pay for this capacity
2613
- # whether it's in use or not. Best for quickest time from streaming
2614
- # request to streaming session. Default is 1 (2 for high stream
2615
- # classes) when creating a stream group or adding a location.
2616
- #
2617
- # * **On-demand**: The streaming capacity that Amazon GameLift Streams
2618
- # can allocate in response to stream requests, and then de-allocate
2619
- # when the session has terminated. This offers a cost control measure
2620
- # at the expense of a greater startup time (typically under 5
2621
- # minutes). Default is 0 when creating a stream group or adding a
2622
- # location.
2719
+ # group. The following capacity settings are available:
2720
+ #
2721
+ # * **Always-on capacity**: This setting, if non-zero, indicates minimum
2722
+ # streaming capacity which is allocated to you and is never released
2723
+ # back to the service. You pay for this base level of capacity at all
2724
+ # times, whether used or idle.
2725
+ #
2726
+ # * **Maximum capacity**: This indicates the maximum capacity that the
2727
+ # service can allocate for you. Newly created streams may take a few
2728
+ # minutes to start. Capacity is released back to the service when
2729
+ # idle. You pay for capacity that is allocated to you until it is
2730
+ # released.
2731
+ #
2732
+ # * **Target-idle capacity**: This indicates idle capacity which the
2733
+ # service pre-allocates and holds for you in anticipation of future
2734
+ # activity. This helps to insulate your users from capacity-allocation
2735
+ # delays. You pay for capacity which is held in this intentional idle
2736
+ # state.
2623
2737
  #
2624
2738
  # Values for capacity must be whole number multiples of the tenancy
2625
2739
  # value of the stream group's stream class.
@@ -2695,6 +2809,8 @@ module Aws::GameLiftStreams
2695
2809
  # location_name: "LocationName", # required
2696
2810
  # always_on_capacity: 1,
2697
2811
  # on_demand_capacity: 1,
2812
+ # target_idle_capacity: 1,
2813
+ # maximum_capacity: 1,
2698
2814
  # },
2699
2815
  # ],
2700
2816
  # description: "Description",
@@ -2712,10 +2828,12 @@ module Aws::GameLiftStreams
2712
2828
  # resp.location_states[0].status #=> String, one of "ACTIVATING", "ACTIVE", "ERROR", "REMOVING"
2713
2829
  # resp.location_states[0].always_on_capacity #=> Integer
2714
2830
  # resp.location_states[0].on_demand_capacity #=> Integer
2831
+ # resp.location_states[0].target_idle_capacity #=> Integer
2832
+ # resp.location_states[0].maximum_capacity #=> Integer
2715
2833
  # resp.location_states[0].requested_capacity #=> Integer
2716
2834
  # resp.location_states[0].allocated_capacity #=> Integer
2717
2835
  # resp.location_states[0].idle_capacity #=> Integer
2718
- # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022"
2836
+ # resp.stream_class #=> String, one of "gen4n_high", "gen4n_ultra", "gen4n_win2022", "gen5n_high", "gen5n_ultra", "gen5n_win2022", "gen6n_small", "gen6n_medium", "gen6n_high", "gen6n_ultra", "gen6n_ultra_win2022", "gen6n_pro", "gen6n_pro_win2022"
2719
2837
  # resp.id #=> String
2720
2838
  # resp.status #=> String, one of "ACTIVATING", "UPDATING_LOCATIONS", "ACTIVE", "ACTIVE_WITH_ERRORS", "ERROR", "DELETING", "EXPIRED"
2721
2839
  # resp.status_reason #=> String, one of "internalError", "noAvailableInstances"
@@ -2752,7 +2870,7 @@ module Aws::GameLiftStreams
2752
2870
  tracer: tracer
2753
2871
  )
2754
2872
  context[:gem_name] = 'aws-sdk-gameliftstreams'
2755
- context[:gem_version] = '1.17.0'
2873
+ context[:gem_version] = '1.18.0'
2756
2874
  Seahorse::Client::Request.new(handlers, context)
2757
2875
  end
2758
2876
 
@@ -28,6 +28,7 @@ module Aws::GameLiftStreams
28
28
  ArnList = Shapes::ListShape.new(name: 'ArnList')
29
29
  AssociateApplicationsInput = Shapes::StructureShape.new(name: 'AssociateApplicationsInput')
30
30
  AssociateApplicationsOutput = Shapes::StructureShape.new(name: 'AssociateApplicationsOutput')
31
+ Boolean = Shapes::BooleanShape.new(name: 'Boolean')
31
32
  CapacityValue = Shapes::IntegerShape.new(name: 'CapacityValue')
32
33
  ClientToken = Shapes::StringShape.new(name: 'ClientToken')
33
34
  ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
@@ -85,9 +86,11 @@ module Aws::GameLiftStreams
85
86
  LocationStates = Shapes::ListShape.new(name: 'LocationStates')
86
87
  LocationsList = Shapes::ListShape.new(name: 'LocationsList')
87
88
  MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
89
+ MaximumCapacity = Shapes::IntegerShape.new(name: 'MaximumCapacity')
88
90
  NextToken = Shapes::StringShape.new(name: 'NextToken')
89
91
  OnDemandCapacity = Shapes::IntegerShape.new(name: 'OnDemandCapacity')
90
92
  OutputUri = Shapes::StringShape.new(name: 'OutputUri')
93
+ PerformanceStatsConfiguration = Shapes::StructureShape.new(name: 'PerformanceStatsConfiguration')
91
94
  Protocol = Shapes::StringShape.new(name: 'Protocol')
92
95
  RemoveStreamGroupLocationsInput = Shapes::StructureShape.new(name: 'RemoveStreamGroupLocationsInput')
93
96
  ReplicationStatus = Shapes::StructureShape.new(name: 'ReplicationStatus')
@@ -120,6 +123,7 @@ module Aws::GameLiftStreams
120
123
  TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse')
121
124
  TagValue = Shapes::StringShape.new(name: 'TagValue')
122
125
  Tags = Shapes::MapShape.new(name: 'Tags')
126
+ TargetIdleCapacity = Shapes::IntegerShape.new(name: 'TargetIdleCapacity')
123
127
  TerminateStreamSessionInput = Shapes::StructureShape.new(name: 'TerminateStreamSessionInput')
124
128
  ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
125
129
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
@@ -316,6 +320,7 @@ module Aws::GameLiftStreams
316
320
  GetStreamSessionOutput.add_member(:session_length_seconds, Shapes::ShapeRef.new(shape: SessionLengthSeconds, location_name: "SessionLengthSeconds"))
317
321
  GetStreamSessionOutput.add_member(:additional_launch_args, Shapes::ShapeRef.new(shape: GameLaunchArgList, location_name: "AdditionalLaunchArgs"))
318
322
  GetStreamSessionOutput.add_member(:additional_environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariables, location_name: "AdditionalEnvironmentVariables"))
323
+ GetStreamSessionOutput.add_member(:performance_stats_configuration, Shapes::ShapeRef.new(shape: PerformanceStatsConfiguration, location_name: "PerformanceStatsConfiguration"))
319
324
  GetStreamSessionOutput.add_member(:log_file_location_uri, Shapes::ShapeRef.new(shape: FileLocationUri, location_name: "LogFileLocationUri"))
320
325
  GetStreamSessionOutput.add_member(:web_sdk_protocol_url, Shapes::ShapeRef.new(shape: WebSdkProtocolUrl, location_name: "WebSdkProtocolUrl"))
321
326
  GetStreamSessionOutput.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdatedAt"))
@@ -374,7 +379,9 @@ module Aws::GameLiftStreams
374
379
 
375
380
  LocationConfiguration.add_member(:location_name, Shapes::ShapeRef.new(shape: LocationName, required: true, location_name: "LocationName"))
376
381
  LocationConfiguration.add_member(:always_on_capacity, Shapes::ShapeRef.new(shape: AlwaysOnCapacity, location_name: "AlwaysOnCapacity"))
377
- LocationConfiguration.add_member(:on_demand_capacity, Shapes::ShapeRef.new(shape: OnDemandCapacity, location_name: "OnDemandCapacity"))
382
+ LocationConfiguration.add_member(:on_demand_capacity, Shapes::ShapeRef.new(shape: OnDemandCapacity, deprecated: true, location_name: "OnDemandCapacity", metadata: {"deprecatedMessage" => "This input field is deprecated in favor of explicit MaximumCapacity values.", "deprecatedSince" => "2025-12-17"}))
383
+ LocationConfiguration.add_member(:target_idle_capacity, Shapes::ShapeRef.new(shape: TargetIdleCapacity, location_name: "TargetIdleCapacity"))
384
+ LocationConfiguration.add_member(:maximum_capacity, Shapes::ShapeRef.new(shape: MaximumCapacity, location_name: "MaximumCapacity"))
378
385
  LocationConfiguration.struct_class = Types::LocationConfiguration
379
386
 
380
387
  LocationConfigurations.member = Shapes::ShapeRef.new(shape: LocationConfiguration)
@@ -385,6 +392,8 @@ module Aws::GameLiftStreams
385
392
  LocationState.add_member(:status, Shapes::ShapeRef.new(shape: StreamGroupLocationStatus, location_name: "Status"))
386
393
  LocationState.add_member(:always_on_capacity, Shapes::ShapeRef.new(shape: AlwaysOnCapacity, location_name: "AlwaysOnCapacity"))
387
394
  LocationState.add_member(:on_demand_capacity, Shapes::ShapeRef.new(shape: OnDemandCapacity, location_name: "OnDemandCapacity"))
395
+ LocationState.add_member(:target_idle_capacity, Shapes::ShapeRef.new(shape: TargetIdleCapacity, location_name: "TargetIdleCapacity"))
396
+ LocationState.add_member(:maximum_capacity, Shapes::ShapeRef.new(shape: MaximumCapacity, location_name: "MaximumCapacity"))
388
397
  LocationState.add_member(:requested_capacity, Shapes::ShapeRef.new(shape: CapacityValue, location_name: "RequestedCapacity"))
389
398
  LocationState.add_member(:allocated_capacity, Shapes::ShapeRef.new(shape: CapacityValue, location_name: "AllocatedCapacity"))
390
399
  LocationState.add_member(:idle_capacity, Shapes::ShapeRef.new(shape: CapacityValue, location_name: "IdleCapacity"))
@@ -394,6 +403,9 @@ module Aws::GameLiftStreams
394
403
 
395
404
  LocationsList.member = Shapes::ShapeRef.new(shape: String)
396
405
 
406
+ PerformanceStatsConfiguration.add_member(:shared_with_client, Shapes::ShapeRef.new(shape: Boolean, location_name: "SharedWithClient"))
407
+ PerformanceStatsConfiguration.struct_class = Types::PerformanceStatsConfiguration
408
+
397
409
  RemoveStreamGroupLocationsInput.add_member(:identifier, Shapes::ShapeRef.new(shape: Identifier, required: true, location: "uri", location_name: "Identifier"))
398
410
  RemoveStreamGroupLocationsInput.add_member(:locations, Shapes::ShapeRef.new(shape: LocationsList, required: true, location: "querystring", location_name: "locations"))
399
411
  RemoveStreamGroupLocationsInput.struct_class = Types::RemoveStreamGroupLocationsInput
@@ -426,6 +438,7 @@ module Aws::GameLiftStreams
426
438
  StartStreamSessionInput.add_member(:session_length_seconds, Shapes::ShapeRef.new(shape: SessionLengthSeconds, location_name: "SessionLengthSeconds"))
427
439
  StartStreamSessionInput.add_member(:additional_launch_args, Shapes::ShapeRef.new(shape: GameLaunchArgList, location_name: "AdditionalLaunchArgs"))
428
440
  StartStreamSessionInput.add_member(:additional_environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariables, location_name: "AdditionalEnvironmentVariables"))
441
+ StartStreamSessionInput.add_member(:performance_stats_configuration, Shapes::ShapeRef.new(shape: PerformanceStatsConfiguration, location_name: "PerformanceStatsConfiguration"))
429
442
  StartStreamSessionInput.struct_class = Types::StartStreamSessionInput
430
443
 
431
444
  StartStreamSessionOutput.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "Arn"))
@@ -442,6 +455,7 @@ module Aws::GameLiftStreams
442
455
  StartStreamSessionOutput.add_member(:session_length_seconds, Shapes::ShapeRef.new(shape: SessionLengthSeconds, location_name: "SessionLengthSeconds"))
443
456
  StartStreamSessionOutput.add_member(:additional_launch_args, Shapes::ShapeRef.new(shape: GameLaunchArgList, location_name: "AdditionalLaunchArgs"))
444
457
  StartStreamSessionOutput.add_member(:additional_environment_variables, Shapes::ShapeRef.new(shape: EnvironmentVariables, location_name: "AdditionalEnvironmentVariables"))
458
+ StartStreamSessionOutput.add_member(:performance_stats_configuration, Shapes::ShapeRef.new(shape: PerformanceStatsConfiguration, location_name: "PerformanceStatsConfiguration"))
445
459
  StartStreamSessionOutput.add_member(:log_file_location_uri, Shapes::ShapeRef.new(shape: FileLocationUri, location_name: "LogFileLocationUri"))
446
460
  StartStreamSessionOutput.add_member(:web_sdk_protocol_url, Shapes::ShapeRef.new(shape: WebSdkProtocolUrl, location_name: "WebSdkProtocolUrl"))
447
461
  StartStreamSessionOutput.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdatedAt"))
@@ -466,6 +480,7 @@ module Aws::GameLiftStreams
466
480
  StreamSessionSummary.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "Arn"))
467
481
  StreamSessionSummary.add_member(:user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "UserId"))
468
482
  StreamSessionSummary.add_member(:status, Shapes::ShapeRef.new(shape: StreamSessionStatus, location_name: "Status"))
483
+ StreamSessionSummary.add_member(:status_reason, Shapes::ShapeRef.new(shape: StreamSessionStatusReason, location_name: "StatusReason"))
469
484
  StreamSessionSummary.add_member(:protocol, Shapes::ShapeRef.new(shape: Protocol, location_name: "Protocol"))
470
485
  StreamSessionSummary.add_member(:last_updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastUpdatedAt"))
471
486
  StreamSessionSummary.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))