aws-sdk-gamelift 1.35.0 → 1.40.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -105,6 +105,8 @@ module Aws::GameLift
105
105
  DescribeGameServerGroupInput = Shapes::StructureShape.new(name: 'DescribeGameServerGroupInput')
106
106
  DescribeGameServerGroupOutput = Shapes::StructureShape.new(name: 'DescribeGameServerGroupOutput')
107
107
  DescribeGameServerInput = Shapes::StructureShape.new(name: 'DescribeGameServerInput')
108
+ DescribeGameServerInstancesInput = Shapes::StructureShape.new(name: 'DescribeGameServerInstancesInput')
109
+ DescribeGameServerInstancesOutput = Shapes::StructureShape.new(name: 'DescribeGameServerInstancesOutput')
108
110
  DescribeGameServerOutput = Shapes::StructureShape.new(name: 'DescribeGameServerOutput')
109
111
  DescribeGameSessionDetailsInput = Shapes::StructureShape.new(name: 'DescribeGameSessionDetailsInput')
110
112
  DescribeGameSessionDetailsOutput = Shapes::StructureShape.new(name: 'DescribeGameSessionDetailsOutput')
@@ -162,6 +164,7 @@ module Aws::GameLift
162
164
  FleetType = Shapes::StringShape.new(name: 'FleetType')
163
165
  FleetUtilization = Shapes::StructureShape.new(name: 'FleetUtilization')
164
166
  FleetUtilizationList = Shapes::ListShape.new(name: 'FleetUtilizationList')
167
+ FlexMatchMode = Shapes::StringShape.new(name: 'FlexMatchMode')
165
168
  Float = Shapes::FloatShape.new(name: 'Float')
166
169
  FreeText = Shapes::StringShape.new(name: 'FreeText')
167
170
  GameProperty = Shapes::StructureShape.new(name: 'GameProperty')
@@ -185,9 +188,12 @@ module Aws::GameLift
185
188
  GameServerGroups = Shapes::ListShape.new(name: 'GameServerGroups')
186
189
  GameServerHealthCheck = Shapes::StringShape.new(name: 'GameServerHealthCheck')
187
190
  GameServerId = Shapes::StringShape.new(name: 'GameServerId')
191
+ GameServerInstance = Shapes::StructureShape.new(name: 'GameServerInstance')
188
192
  GameServerInstanceId = Shapes::StringShape.new(name: 'GameServerInstanceId')
193
+ GameServerInstanceIds = Shapes::ListShape.new(name: 'GameServerInstanceIds')
194
+ GameServerInstanceStatus = Shapes::StringShape.new(name: 'GameServerInstanceStatus')
195
+ GameServerInstances = Shapes::ListShape.new(name: 'GameServerInstances')
189
196
  GameServerProtectionPolicy = Shapes::StringShape.new(name: 'GameServerProtectionPolicy')
190
- GameServerSortKey = Shapes::StringShape.new(name: 'GameServerSortKey')
191
197
  GameServerUtilizationStatus = Shapes::StringShape.new(name: 'GameServerUtilizationStatus')
192
198
  GameServers = Shapes::ListShape.new(name: 'GameServers')
193
199
  GameSession = Shapes::StructureShape.new(name: 'GameSession')
@@ -555,7 +561,7 @@ module Aws::GameLift
555
561
 
556
562
  CreateMatchmakingConfigurationInput.add_member(:name, Shapes::ShapeRef.new(shape: MatchmakingIdStringModel, required: true, location_name: "Name"))
557
563
  CreateMatchmakingConfigurationInput.add_member(:description, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "Description"))
558
- CreateMatchmakingConfigurationInput.add_member(:game_session_queue_arns, Shapes::ShapeRef.new(shape: QueueArnsList, required: true, location_name: "GameSessionQueueArns"))
564
+ CreateMatchmakingConfigurationInput.add_member(:game_session_queue_arns, Shapes::ShapeRef.new(shape: QueueArnsList, location_name: "GameSessionQueueArns"))
559
565
  CreateMatchmakingConfigurationInput.add_member(:request_timeout_seconds, Shapes::ShapeRef.new(shape: MatchmakingRequestTimeoutInteger, required: true, location_name: "RequestTimeoutSeconds"))
560
566
  CreateMatchmakingConfigurationInput.add_member(:acceptance_timeout_seconds, Shapes::ShapeRef.new(shape: MatchmakingAcceptanceTimeoutInteger, location_name: "AcceptanceTimeoutSeconds"))
561
567
  CreateMatchmakingConfigurationInput.add_member(:acceptance_required, Shapes::ShapeRef.new(shape: BooleanModel, required: true, location_name: "AcceptanceRequired"))
@@ -566,6 +572,7 @@ module Aws::GameLift
566
572
  CreateMatchmakingConfigurationInput.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
567
573
  CreateMatchmakingConfigurationInput.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
568
574
  CreateMatchmakingConfigurationInput.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
575
+ CreateMatchmakingConfigurationInput.add_member(:flex_match_mode, Shapes::ShapeRef.new(shape: FlexMatchMode, location_name: "FlexMatchMode"))
569
576
  CreateMatchmakingConfigurationInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
570
577
  CreateMatchmakingConfigurationInput.struct_class = Types::CreateMatchmakingConfigurationInput
571
578
 
@@ -746,6 +753,16 @@ module Aws::GameLift
746
753
  DescribeGameServerInput.add_member(:game_server_id, Shapes::ShapeRef.new(shape: GameServerId, required: true, location_name: "GameServerId"))
747
754
  DescribeGameServerInput.struct_class = Types::DescribeGameServerInput
748
755
 
756
+ DescribeGameServerInstancesInput.add_member(:game_server_group_name, Shapes::ShapeRef.new(shape: GameServerGroupNameOrArn, required: true, location_name: "GameServerGroupName"))
757
+ DescribeGameServerInstancesInput.add_member(:instance_ids, Shapes::ShapeRef.new(shape: GameServerInstanceIds, location_name: "InstanceIds"))
758
+ DescribeGameServerInstancesInput.add_member(:limit, Shapes::ShapeRef.new(shape: PositiveInteger, location_name: "Limit"))
759
+ DescribeGameServerInstancesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "NextToken"))
760
+ DescribeGameServerInstancesInput.struct_class = Types::DescribeGameServerInstancesInput
761
+
762
+ DescribeGameServerInstancesOutput.add_member(:game_server_instances, Shapes::ShapeRef.new(shape: GameServerInstances, location_name: "GameServerInstances"))
763
+ DescribeGameServerInstancesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "NextToken"))
764
+ DescribeGameServerInstancesOutput.struct_class = Types::DescribeGameServerInstancesOutput
765
+
749
766
  DescribeGameServerOutput.add_member(:game_server, Shapes::ShapeRef.new(shape: GameServer, location_name: "GameServer"))
750
767
  DescribeGameServerOutput.struct_class = Types::DescribeGameServerOutput
751
768
 
@@ -964,7 +981,6 @@ module Aws::GameLift
964
981
  GameServer.add_member(:instance_id, Shapes::ShapeRef.new(shape: GameServerInstanceId, location_name: "InstanceId"))
965
982
  GameServer.add_member(:connection_info, Shapes::ShapeRef.new(shape: GameServerConnectionInfo, location_name: "ConnectionInfo"))
966
983
  GameServer.add_member(:game_server_data, Shapes::ShapeRef.new(shape: GameServerData, location_name: "GameServerData"))
967
- GameServer.add_member(:custom_sort_key, Shapes::ShapeRef.new(shape: GameServerSortKey, location_name: "CustomSortKey"))
968
984
  GameServer.add_member(:claim_status, Shapes::ShapeRef.new(shape: GameServerClaimStatus, location_name: "ClaimStatus"))
969
985
  GameServer.add_member(:utilization_status, Shapes::ShapeRef.new(shape: GameServerUtilizationStatus, location_name: "UtilizationStatus"))
970
986
  GameServer.add_member(:registration_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "RegistrationTime"))
@@ -994,6 +1010,16 @@ module Aws::GameLift
994
1010
 
995
1011
  GameServerGroups.member = Shapes::ShapeRef.new(shape: GameServerGroup)
996
1012
 
1013
+ GameServerInstance.add_member(:game_server_group_name, Shapes::ShapeRef.new(shape: GameServerGroupName, location_name: "GameServerGroupName"))
1014
+ GameServerInstance.add_member(:game_server_group_arn, Shapes::ShapeRef.new(shape: GameServerGroupArn, location_name: "GameServerGroupArn"))
1015
+ GameServerInstance.add_member(:instance_id, Shapes::ShapeRef.new(shape: GameServerInstanceId, location_name: "InstanceId"))
1016
+ GameServerInstance.add_member(:instance_status, Shapes::ShapeRef.new(shape: GameServerInstanceStatus, location_name: "InstanceStatus"))
1017
+ GameServerInstance.struct_class = Types::GameServerInstance
1018
+
1019
+ GameServerInstanceIds.member = Shapes::ShapeRef.new(shape: GameServerInstanceId)
1020
+
1021
+ GameServerInstances.member = Shapes::ShapeRef.new(shape: GameServerInstance)
1022
+
997
1023
  GameServers.member = Shapes::ShapeRef.new(shape: GameServer)
998
1024
 
999
1025
  GameSession.add_member(:game_session_id, Shapes::ShapeRef.new(shape: NonZeroAndMaxString, location_name: "GameSessionId"))
@@ -1229,6 +1255,7 @@ module Aws::GameLift
1229
1255
  MatchmakingConfiguration.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
1230
1256
  MatchmakingConfiguration.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
1231
1257
  MatchmakingConfiguration.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
1258
+ MatchmakingConfiguration.add_member(:flex_match_mode, Shapes::ShapeRef.new(shape: FlexMatchMode, location_name: "FlexMatchMode"))
1232
1259
  MatchmakingConfiguration.struct_class = Types::MatchmakingConfiguration
1233
1260
 
1234
1261
  MatchmakingConfigurationList.member = Shapes::ShapeRef.new(shape: MatchmakingConfiguration)
@@ -1343,8 +1370,6 @@ module Aws::GameLift
1343
1370
  RegisterGameServerInput.add_member(:instance_id, Shapes::ShapeRef.new(shape: GameServerInstanceId, required: true, location_name: "InstanceId"))
1344
1371
  RegisterGameServerInput.add_member(:connection_info, Shapes::ShapeRef.new(shape: GameServerConnectionInfo, location_name: "ConnectionInfo"))
1345
1372
  RegisterGameServerInput.add_member(:game_server_data, Shapes::ShapeRef.new(shape: GameServerData, location_name: "GameServerData"))
1346
- RegisterGameServerInput.add_member(:custom_sort_key, Shapes::ShapeRef.new(shape: GameServerSortKey, location_name: "CustomSortKey"))
1347
- RegisterGameServerInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
1348
1373
  RegisterGameServerInput.struct_class = Types::RegisterGameServerInput
1349
1374
 
1350
1375
  RegisterGameServerOutput.add_member(:game_server, Shapes::ShapeRef.new(shape: GameServer, location_name: "GameServer"))
@@ -1457,7 +1482,7 @@ module Aws::GameLift
1457
1482
 
1458
1483
  StartMatchBackfillInput.add_member(:ticket_id, Shapes::ShapeRef.new(shape: MatchmakingIdStringModel, location_name: "TicketId"))
1459
1484
  StartMatchBackfillInput.add_member(:configuration_name, Shapes::ShapeRef.new(shape: MatchmakingConfigurationName, required: true, location_name: "ConfigurationName"))
1460
- StartMatchBackfillInput.add_member(:game_session_arn, Shapes::ShapeRef.new(shape: ArnStringModel, required: true, location_name: "GameSessionArn"))
1485
+ StartMatchBackfillInput.add_member(:game_session_arn, Shapes::ShapeRef.new(shape: ArnStringModel, location_name: "GameSessionArn"))
1461
1486
  StartMatchBackfillInput.add_member(:players, Shapes::ShapeRef.new(shape: PlayerList, required: true, location_name: "Players"))
1462
1487
  StartMatchBackfillInput.struct_class = Types::StartMatchBackfillInput
1463
1488
 
@@ -1597,7 +1622,6 @@ module Aws::GameLift
1597
1622
  UpdateGameServerInput.add_member(:game_server_group_name, Shapes::ShapeRef.new(shape: GameServerGroupNameOrArn, required: true, location_name: "GameServerGroupName"))
1598
1623
  UpdateGameServerInput.add_member(:game_server_id, Shapes::ShapeRef.new(shape: GameServerId, required: true, location_name: "GameServerId"))
1599
1624
  UpdateGameServerInput.add_member(:game_server_data, Shapes::ShapeRef.new(shape: GameServerData, location_name: "GameServerData"))
1600
- UpdateGameServerInput.add_member(:custom_sort_key, Shapes::ShapeRef.new(shape: GameServerSortKey, location_name: "CustomSortKey"))
1601
1625
  UpdateGameServerInput.add_member(:utilization_status, Shapes::ShapeRef.new(shape: GameServerUtilizationStatus, location_name: "UtilizationStatus"))
1602
1626
  UpdateGameServerInput.add_member(:health_check, Shapes::ShapeRef.new(shape: GameServerHealthCheck, location_name: "HealthCheck"))
1603
1627
  UpdateGameServerInput.struct_class = Types::UpdateGameServerInput
@@ -1637,6 +1661,7 @@ module Aws::GameLift
1637
1661
  UpdateMatchmakingConfigurationInput.add_member(:game_properties, Shapes::ShapeRef.new(shape: GamePropertyList, location_name: "GameProperties"))
1638
1662
  UpdateMatchmakingConfigurationInput.add_member(:game_session_data, Shapes::ShapeRef.new(shape: GameSessionData, location_name: "GameSessionData"))
1639
1663
  UpdateMatchmakingConfigurationInput.add_member(:backfill_mode, Shapes::ShapeRef.new(shape: BackfillMode, location_name: "BackfillMode"))
1664
+ UpdateMatchmakingConfigurationInput.add_member(:flex_match_mode, Shapes::ShapeRef.new(shape: FlexMatchMode, location_name: "FlexMatchMode"))
1640
1665
  UpdateMatchmakingConfigurationInput.struct_class = Types::UpdateMatchmakingConfigurationInput
1641
1666
 
1642
1667
  UpdateMatchmakingConfigurationOutput.add_member(:configuration, Shapes::ShapeRef.new(shape: MatchmakingConfiguration, location_name: "Configuration"))
@@ -2111,6 +2136,12 @@ module Aws::GameLift
2111
2136
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2112
2137
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2113
2138
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2139
+ o[:pager] = Aws::Pager.new(
2140
+ limit_key: "limit",
2141
+ tokens: {
2142
+ "next_token" => "next_token"
2143
+ }
2144
+ )
2114
2145
  end)
2115
2146
 
2116
2147
  api.add_operation(:describe_fleet_capacity, Seahorse::Model::Operation.new.tap do |o|
@@ -2123,6 +2154,12 @@ module Aws::GameLift
2123
2154
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2124
2155
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2125
2156
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2157
+ o[:pager] = Aws::Pager.new(
2158
+ limit_key: "limit",
2159
+ tokens: {
2160
+ "next_token" => "next_token"
2161
+ }
2162
+ )
2126
2163
  end)
2127
2164
 
2128
2165
  api.add_operation(:describe_fleet_events, Seahorse::Model::Operation.new.tap do |o|
@@ -2135,6 +2172,12 @@ module Aws::GameLift
2135
2172
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2136
2173
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2137
2174
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2175
+ o[:pager] = Aws::Pager.new(
2176
+ limit_key: "limit",
2177
+ tokens: {
2178
+ "next_token" => "next_token"
2179
+ }
2180
+ )
2138
2181
  end)
2139
2182
 
2140
2183
  api.add_operation(:describe_fleet_port_settings, Seahorse::Model::Operation.new.tap do |o|
@@ -2159,6 +2202,12 @@ module Aws::GameLift
2159
2202
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2160
2203
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2161
2204
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2205
+ o[:pager] = Aws::Pager.new(
2206
+ limit_key: "limit",
2207
+ tokens: {
2208
+ "next_token" => "next_token"
2209
+ }
2210
+ )
2162
2211
  end)
2163
2212
 
2164
2213
  api.add_operation(:describe_game_server, Seahorse::Model::Operation.new.tap do |o|
@@ -2185,6 +2234,24 @@ module Aws::GameLift
2185
2234
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2186
2235
  end)
2187
2236
 
2237
+ api.add_operation(:describe_game_server_instances, Seahorse::Model::Operation.new.tap do |o|
2238
+ o.name = "DescribeGameServerInstances"
2239
+ o.http_method = "POST"
2240
+ o.http_request_uri = "/"
2241
+ o.input = Shapes::ShapeRef.new(shape: DescribeGameServerInstancesInput)
2242
+ o.output = Shapes::ShapeRef.new(shape: DescribeGameServerInstancesOutput)
2243
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2244
+ o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2245
+ o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2246
+ o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2247
+ o[:pager] = Aws::Pager.new(
2248
+ limit_key: "limit",
2249
+ tokens: {
2250
+ "next_token" => "next_token"
2251
+ }
2252
+ )
2253
+ end)
2254
+
2188
2255
  api.add_operation(:describe_game_session_details, Seahorse::Model::Operation.new.tap do |o|
2189
2256
  o.name = "DescribeGameSessionDetails"
2190
2257
  o.http_method = "POST"
@@ -2196,6 +2263,12 @@ module Aws::GameLift
2196
2263
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2197
2264
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2198
2265
  o.errors << Shapes::ShapeRef.new(shape: TerminalRoutingStrategyException)
2266
+ o[:pager] = Aws::Pager.new(
2267
+ limit_key: "limit",
2268
+ tokens: {
2269
+ "next_token" => "next_token"
2270
+ }
2271
+ )
2199
2272
  end)
2200
2273
 
2201
2274
  api.add_operation(:describe_game_session_placement, Seahorse::Model::Operation.new.tap do |o|
@@ -2220,6 +2293,12 @@ module Aws::GameLift
2220
2293
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2221
2294
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2222
2295
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2296
+ o[:pager] = Aws::Pager.new(
2297
+ limit_key: "limit",
2298
+ tokens: {
2299
+ "next_token" => "next_token"
2300
+ }
2301
+ )
2223
2302
  end)
2224
2303
 
2225
2304
  api.add_operation(:describe_game_sessions, Seahorse::Model::Operation.new.tap do |o|
@@ -2233,6 +2312,12 @@ module Aws::GameLift
2233
2312
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2234
2313
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2235
2314
  o.errors << Shapes::ShapeRef.new(shape: TerminalRoutingStrategyException)
2315
+ o[:pager] = Aws::Pager.new(
2316
+ limit_key: "limit",
2317
+ tokens: {
2318
+ "next_token" => "next_token"
2319
+ }
2320
+ )
2236
2321
  end)
2237
2322
 
2238
2323
  api.add_operation(:describe_instances, Seahorse::Model::Operation.new.tap do |o|
@@ -2245,6 +2330,12 @@ module Aws::GameLift
2245
2330
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2246
2331
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2247
2332
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2333
+ o[:pager] = Aws::Pager.new(
2334
+ limit_key: "limit",
2335
+ tokens: {
2336
+ "next_token" => "next_token"
2337
+ }
2338
+ )
2248
2339
  end)
2249
2340
 
2250
2341
  api.add_operation(:describe_matchmaking, Seahorse::Model::Operation.new.tap do |o|
@@ -2267,6 +2358,12 @@ module Aws::GameLift
2267
2358
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2268
2359
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2269
2360
  o.errors << Shapes::ShapeRef.new(shape: UnsupportedRegionException)
2361
+ o[:pager] = Aws::Pager.new(
2362
+ limit_key: "limit",
2363
+ tokens: {
2364
+ "next_token" => "next_token"
2365
+ }
2366
+ )
2270
2367
  end)
2271
2368
 
2272
2369
  api.add_operation(:describe_matchmaking_rule_sets, Seahorse::Model::Operation.new.tap do |o|
@@ -2279,6 +2376,12 @@ module Aws::GameLift
2279
2376
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2280
2377
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2281
2378
  o.errors << Shapes::ShapeRef.new(shape: UnsupportedRegionException)
2379
+ o[:pager] = Aws::Pager.new(
2380
+ limit_key: "limit",
2381
+ tokens: {
2382
+ "next_token" => "next_token"
2383
+ }
2384
+ )
2282
2385
  end)
2283
2386
 
2284
2387
  api.add_operation(:describe_player_sessions, Seahorse::Model::Operation.new.tap do |o|
@@ -2291,6 +2394,12 @@ module Aws::GameLift
2291
2394
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2292
2395
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2293
2396
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2397
+ o[:pager] = Aws::Pager.new(
2398
+ limit_key: "limit",
2399
+ tokens: {
2400
+ "next_token" => "next_token"
2401
+ }
2402
+ )
2294
2403
  end)
2295
2404
 
2296
2405
  api.add_operation(:describe_runtime_configuration, Seahorse::Model::Operation.new.tap do |o|
@@ -2315,6 +2424,12 @@ module Aws::GameLift
2315
2424
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2316
2425
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2317
2426
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2427
+ o[:pager] = Aws::Pager.new(
2428
+ limit_key: "limit",
2429
+ tokens: {
2430
+ "next_token" => "next_token"
2431
+ }
2432
+ )
2318
2433
  end)
2319
2434
 
2320
2435
  api.add_operation(:describe_script, Seahorse::Model::Operation.new.tap do |o|
@@ -2385,6 +2500,12 @@ module Aws::GameLift
2385
2500
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2386
2501
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2387
2502
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2503
+ o[:pager] = Aws::Pager.new(
2504
+ limit_key: "limit",
2505
+ tokens: {
2506
+ "next_token" => "next_token"
2507
+ }
2508
+ )
2388
2509
  end)
2389
2510
 
2390
2511
  api.add_operation(:list_builds, Seahorse::Model::Operation.new.tap do |o|
@@ -2396,6 +2517,12 @@ module Aws::GameLift
2396
2517
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2397
2518
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2398
2519
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2520
+ o[:pager] = Aws::Pager.new(
2521
+ limit_key: "limit",
2522
+ tokens: {
2523
+ "next_token" => "next_token"
2524
+ }
2525
+ )
2399
2526
  end)
2400
2527
 
2401
2528
  api.add_operation(:list_fleets, Seahorse::Model::Operation.new.tap do |o|
@@ -2408,6 +2535,12 @@ module Aws::GameLift
2408
2535
  o.errors << Shapes::ShapeRef.new(shape: NotFoundException)
2409
2536
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2410
2537
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2538
+ o[:pager] = Aws::Pager.new(
2539
+ limit_key: "limit",
2540
+ tokens: {
2541
+ "next_token" => "next_token"
2542
+ }
2543
+ )
2411
2544
  end)
2412
2545
 
2413
2546
  api.add_operation(:list_game_server_groups, Seahorse::Model::Operation.new.tap do |o|
@@ -2419,6 +2552,12 @@ module Aws::GameLift
2419
2552
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2420
2553
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2421
2554
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2555
+ o[:pager] = Aws::Pager.new(
2556
+ limit_key: "limit",
2557
+ tokens: {
2558
+ "next_token" => "next_token"
2559
+ }
2560
+ )
2422
2561
  end)
2423
2562
 
2424
2563
  api.add_operation(:list_game_servers, Seahorse::Model::Operation.new.tap do |o|
@@ -2430,6 +2569,12 @@ module Aws::GameLift
2430
2569
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2431
2570
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2432
2571
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2572
+ o[:pager] = Aws::Pager.new(
2573
+ limit_key: "limit",
2574
+ tokens: {
2575
+ "next_token" => "next_token"
2576
+ }
2577
+ )
2433
2578
  end)
2434
2579
 
2435
2580
  api.add_operation(:list_scripts, Seahorse::Model::Operation.new.tap do |o|
@@ -2441,6 +2586,12 @@ module Aws::GameLift
2441
2586
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2442
2587
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2443
2588
  o.errors << Shapes::ShapeRef.new(shape: InternalServiceException)
2589
+ o[:pager] = Aws::Pager.new(
2590
+ limit_key: "limit",
2591
+ tokens: {
2592
+ "next_token" => "next_token"
2593
+ }
2594
+ )
2444
2595
  end)
2445
2596
 
2446
2597
  api.add_operation(:list_tags_for_resource, Seahorse::Model::Operation.new.tap do |o|
@@ -2528,6 +2679,12 @@ module Aws::GameLift
2528
2679
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
2529
2680
  o.errors << Shapes::ShapeRef.new(shape: UnauthorizedException)
2530
2681
  o.errors << Shapes::ShapeRef.new(shape: TerminalRoutingStrategyException)
2682
+ o[:pager] = Aws::Pager.new(
2683
+ limit_key: "limit",
2684
+ tokens: {
2685
+ "next_token" => "next_token"
2686
+ }
2687
+ )
2531
2688
  end)
2532
2689
 
2533
2690
  api.add_operation(:start_fleet_actions, Seahorse::Model::Operation.new.tap do |o|
@@ -10,7 +10,7 @@
10
10
  module Aws::GameLift
11
11
  module Types
12
12
 
13
- # Represents the input for a request action.
13
+ # Represents the input for a request operation.
14
14
  #
15
15
  # @note When making an API call, you may pass AcceptMatchInput
16
16
  # data as a hash:
@@ -326,11 +326,11 @@ module Aws::GameLift
326
326
  # }
327
327
  #
328
328
  # @!attribute [rw] game_server_group_name
329
- # An identifier for the game server group. When claiming a specific
330
- # game server, this is the game server group whether the game server
331
- # is located. When requesting that GameLift FleetIQ locate an
332
- # available game server, this is the game server group to search on.
333
- # You can use either the GameServerGroup name or ARN value.
329
+ # A unique identifier for the game server group where the game server
330
+ # is running. Use either the GameServerGroup name or ARN value.. If
331
+ # you are not specifying a game server to claim, this value identifies
332
+ # where you want GameLift FleetIQ to look for an available game server
333
+ # to claim.
334
334
  # @return [String]
335
335
  #
336
336
  # @!attribute [rw] game_server_id
@@ -341,7 +341,9 @@ module Aws::GameLift
341
341
  #
342
342
  # @!attribute [rw] game_server_data
343
343
  # A set of custom game server properties, formatted as a single string
344
- # value, to be passed to the claimed game server.
344
+ # value. This data is passed to a game client or service when it
345
+ # requests information on game servers using ListGameServers or
346
+ # ClaimGameServer.
345
347
  # @return [String]
346
348
  #
347
349
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ClaimGameServerInput AWS API Documentation
@@ -355,7 +357,7 @@ module Aws::GameLift
355
357
  end
356
358
 
357
359
  # @!attribute [rw] game_server
358
- # Object that describes the newly claimed game server resource.
360
+ # Object that describes the newly claimed game server.
359
361
  # @return [Types::GameServer]
360
362
  #
361
363
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ClaimGameServerOutput AWS API Documentation
@@ -381,7 +383,7 @@ module Aws::GameLift
381
383
  include Aws::Structure
382
384
  end
383
385
 
384
- # Represents the input for a request action.
386
+ # Represents the input for a request operation.
385
387
  #
386
388
  # @note When making an API call, you may pass CreateAliasInput
387
389
  # data as a hash:
@@ -442,7 +444,7 @@ module Aws::GameLift
442
444
  include Aws::Structure
443
445
  end
444
446
 
445
- # Represents the returned data in response to a request action.
447
+ # Represents the returned data in response to a request operation.
446
448
  #
447
449
  # @!attribute [rw] alias
448
450
  # The newly created alias resource.
@@ -456,7 +458,7 @@ module Aws::GameLift
456
458
  include Aws::Structure
457
459
  end
458
460
 
459
- # Represents the input for a request action.
461
+ # Represents the input for a request operation.
460
462
  #
461
463
  # @note When making an API call, you may pass CreateBuildInput
462
464
  # data as a hash:
@@ -492,12 +494,19 @@ module Aws::GameLift
492
494
  # @return [String]
493
495
  #
494
496
  # @!attribute [rw] storage_location
495
- # Information indicating where your game build files are stored. Use
496
- # this parameter only when creating a build with files stored in an S3
497
- # bucket that you own. The storage location must specify an S3 bucket
498
- # name and key. The location must also specify a role ARN that you set
499
- # up to allow Amazon GameLift to access your S3 bucket. The S3 bucket
500
- # and your new build must be in the same Region.
497
+ # The location where your game build files are stored. Use this
498
+ # parameter only when creating a build using files that are stored in
499
+ # an S3 bucket that you own. Identify an S3 bucket name and key, which
500
+ # must in the same Region where you're creating a build. This
501
+ # parameter must also specify the ARN for an IAM role that you've set
502
+ # up to give Amazon GameLift access your S3 bucket. To call this
503
+ # operation with a storage location, you must have IAM PassRole
504
+ # permission. For more details on IAM roles and PassRole permissions,
505
+ # see [ Set up a role for GameLift access][1].
506
+ #
507
+ #
508
+ #
509
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
501
510
  # @return [Types::S3Location]
502
511
  #
503
512
  # @!attribute [rw] operating_system
@@ -537,7 +546,7 @@ module Aws::GameLift
537
546
  include Aws::Structure
538
547
  end
539
548
 
540
- # Represents the returned data in response to a request action.
549
+ # Represents the returned data in response to a request operation.
541
550
  #
542
551
  # @!attribute [rw] build
543
552
  # The newly created build resource, including a unique build IDs and
@@ -567,7 +576,7 @@ module Aws::GameLift
567
576
  include Aws::Structure
568
577
  end
569
578
 
570
- # Represents the input for a request action.
579
+ # Represents the input for a request operation.
571
580
  #
572
581
  # @note When making an API call, you may pass CreateFleetInput
573
582
  # data as a hash:
@@ -580,7 +589,7 @@ module Aws::GameLift
580
589
  # server_launch_path: "NonZeroAndMaxString",
581
590
  # server_launch_parameters: "NonZeroAndMaxString",
582
591
  # log_paths: ["NonZeroAndMaxString"],
583
- # ec2_instance_type: "t2.micro", # required, accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge
592
+ # ec2_instance_type: "t2.micro", # required, accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, c5a.large, c5a.xlarge, c5a.2xlarge, c5a.4xlarge, c5a.8xlarge, c5a.12xlarge, c5a.16xlarge, c5a.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.8xlarge, r5a.12xlarge, r5a.16xlarge, r5a.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge, m5a.large, m5a.xlarge, m5a.2xlarge, m5a.4xlarge, m5a.8xlarge, m5a.12xlarge, m5a.16xlarge, m5a.24xlarge
584
593
  # ec2_inbound_permissions: [
585
594
  # {
586
595
  # from_port: 1, # required
@@ -772,18 +781,17 @@ module Aws::GameLift
772
781
  #
773
782
  # @!attribute [rw] instance_role_arn
774
783
  # A unique identifier for an AWS IAM role that manages access to your
775
- # AWS services. With an instance role ARN set, any application that
776
- # runs on an instance in this fleet can assume the role, including
777
- # install scripts, server processes, and daemons (background
778
- # processes). Create a role or look up a role's ARN from the [IAM
779
- # dashboard][1] in the AWS Management Console. Learn more about using
780
- # on-box credentials for your game servers at [ Access external
781
- # resources from a game server][2].
784
+ # AWS services. Fleets with an instance role ARN allow applications
785
+ # that are running on the fleet's instances to assume the role. Learn
786
+ # more about using on-box credentials for your game servers at [
787
+ # Access external resources from a game server][1]. To call this
788
+ # operation with instance role ARN, you must have IAM PassRole
789
+ # permissions. See [IAM policy examples for GameLift][2].
782
790
  #
783
791
  #
784
792
  #
785
- # [1]: https://console.aws.amazon.com/iam/
786
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
793
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
794
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-iam-policy-examples.html
787
795
  # @return [String]
788
796
  #
789
797
  # @!attribute [rw] certificate_configuration
@@ -853,7 +861,7 @@ module Aws::GameLift
853
861
  include Aws::Structure
854
862
  end
855
863
 
856
- # Represents the returned data in response to a request action.
864
+ # Represents the returned data in response to a request operation.
857
865
  #
858
866
  # @!attribute [rw] fleet_attributes
859
867
  # Properties for the newly created fleet.
@@ -892,7 +900,7 @@ module Aws::GameLift
892
900
  # target_value: 1.0, # required
893
901
  # },
894
902
  # },
895
- # balancing_strategy: "SPOT_ONLY", # accepts SPOT_ONLY, SPOT_PREFERRED
903
+ # balancing_strategy: "SPOT_ONLY", # accepts SPOT_ONLY, SPOT_PREFERRED, ON_DEMAND_ONLY
896
904
  # game_server_protection_policy: "NO_PROTECTION", # accepts NO_PROTECTION, FULL_PROTECTION
897
905
  # vpc_subnets: ["VpcSubnet"],
898
906
  # tags: [
@@ -912,9 +920,7 @@ module Aws::GameLift
912
920
  #
913
921
  # @!attribute [rw] role_arn
914
922
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows
915
- # Amazon GameLift to access your EC2 Auto Scaling groups. The
916
- # submitted role is validated to ensure that it contains the necessary
917
- # permissions for game server groups.
923
+ # Amazon GameLift to access your EC2 Auto Scaling groups.
918
924
  #
919
925
  #
920
926
  #
@@ -923,15 +929,19 @@ module Aws::GameLift
923
929
  #
924
930
  # @!attribute [rw] min_size
925
931
  # The minimum number of instances allowed in the EC2 Auto Scaling
926
- # group. During autoscaling events, GameLift FleetIQ and EC2 do not
927
- # scale down the group below this minimum. In production, this value
928
- # should be set to at least 1.
932
+ # group. During automatic scaling events, GameLift FleetIQ and EC2 do
933
+ # not scale down the group below this minimum. In production, this
934
+ # value should be set to at least 1. After the Auto Scaling group is
935
+ # created, update this value directly in the Auto Scaling group using
936
+ # the AWS console or APIs.
929
937
  # @return [Integer]
930
938
  #
931
939
  # @!attribute [rw] max_size
932
940
  # The maximum number of instances allowed in the EC2 Auto Scaling
933
- # group. During autoscaling events, GameLift FleetIQ and EC2 do not
934
- # scale up the group above this maximum.
941
+ # group. During automatic scaling events, GameLift FleetIQ and EC2 do
942
+ # not scale up the group above this maximum. After the Auto Scaling
943
+ # group is created, update this value directly in the Auto Scaling
944
+ # group using the AWS console or APIs.
935
945
  # @return [Integer]
936
946
  #
937
947
  # @!attribute [rw] launch_template
@@ -940,7 +950,9 @@ module Aws::GameLift
940
950
  # group. You can specify the template using either the template name
941
951
  # or ID. For help with creating a launch template, see [Creating a
942
952
  # Launch Template for an Auto Scaling Group][1] in the *Amazon EC2
943
- # Auto Scaling User Guide*.
953
+ # Auto Scaling User Guide*. After the Auto Scaling group is created,
954
+ # update this value directly in the Auto Scaling group using the AWS
955
+ # console or APIs.
944
956
  #
945
957
  #
946
958
  #
@@ -948,72 +960,88 @@ module Aws::GameLift
948
960
  # @return [Types::LaunchTemplateSpecification]
949
961
  #
950
962
  # @!attribute [rw] instance_definitions
951
- # A set of EC2 instance types to use when creating instances in the
952
- # group. The instance definitions must specify at least two different
963
+ # The EC2 instance types and sizes to use in the Auto Scaling group.
964
+ # The instance definitions must specify at least two different
953
965
  # instance types that are supported by GameLift FleetIQ. For more
954
966
  # information on instance types, see [EC2 Instance Types][1] in the
955
- # *Amazon EC2 User Guide*.
967
+ # *Amazon EC2 User Guide*. You can optionally specify capacity
968
+ # weighting for each instance type. If no weight value is specified
969
+ # for an instance type, it is set to the default value "1". For more
970
+ # information about capacity weighting, see [ Instance Weighting for
971
+ # Amazon EC2 Auto Scaling][2] in the Amazon EC2 Auto Scaling User
972
+ # Guide.
956
973
  #
957
974
  #
958
975
  #
959
976
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html
977
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-weighting.html
960
978
  # @return [Array<Types::InstanceDefinition>]
961
979
  #
962
980
  # @!attribute [rw] auto_scaling_policy
963
981
  # Configuration settings to define a scaling policy for the Auto
964
982
  # Scaling group that is optimized for game hosting. The scaling policy
965
- # uses the metric "PercentUtilizedGameServers" to maintain a buffer
983
+ # uses the metric `"PercentUtilizedGameServers"` to maintain a buffer
966
984
  # of idle game servers that can immediately accommodate new games and
967
- # players. Once the game server and Auto Scaling groups are created,
968
- # you can update the scaling policy settings directly in Auto Scaling
969
- # Groups.
985
+ # players. After the Auto Scaling group is created, update this value
986
+ # directly in the Auto Scaling group using the AWS console or APIs.
970
987
  # @return [Types::GameServerGroupAutoScalingPolicy]
971
988
  #
972
989
  # @!attribute [rw] balancing_strategy
973
- # The fallback balancing method to use for the game server group when
974
- # Spot instances in a Region become unavailable or are not viable for
975
- # game hosting. Once triggered, this method remains active until Spot
976
- # instances can once again be used. Method options include:
990
+ # Indicates how GameLift FleetIQ balances the use of Spot Instances
991
+ # and On-Demand Instances in the game server group. Method options
992
+ # include the following:
977
993
  #
978
- # * SPOT\_ONLY -- If Spot instances are unavailable, the game server
979
- # group provides no hosting capacity. No new instances are started,
980
- # and the existing nonviable Spot instances are terminated (once
981
- # current gameplay ends) and not replaced.
994
+ # * `SPOT_ONLY` - Only Spot Instances are used in the game server
995
+ # group. If Spot Instances are unavailable or not viable for game
996
+ # hosting, the game server group provides no hosting capacity until
997
+ # Spot Instances can again be used. Until then, no new instances are
998
+ # started, and the existing nonviable Spot Instances are terminated
999
+ # (after current gameplay ends) and are not replaced.
982
1000
  #
983
- # * SPOT\_PREFERRED -- If Spot instances are unavailable, the game
984
- # server group continues to provide hosting capacity by using
985
- # On-Demand instances. Existing nonviable Spot instances are
986
- # terminated (once current gameplay ends) and replaced with new
987
- # On-Demand instances.
1001
+ # * `SPOT_PREFERRED` - (default value) Spot Instances are used
1002
+ # whenever available in the game server group. If Spot Instances are
1003
+ # unavailable, the game server group continues to provide hosting
1004
+ # capacity by falling back to On-Demand Instances. Existing
1005
+ # nonviable Spot Instances are terminated (after current gameplay
1006
+ # ends) and are replaced with new On-Demand Instances.
1007
+ #
1008
+ # * `ON_DEMAND_ONLY` - Only On-Demand Instances are used in the game
1009
+ # server group. No Spot Instances are used, even when available,
1010
+ # while this balancing strategy is in force.
988
1011
  # @return [String]
989
1012
  #
990
1013
  # @!attribute [rw] game_server_protection_policy
991
1014
  # A flag that indicates whether instances in the game server group are
992
1015
  # protected from early termination. Unprotected instances that have
993
- # active game servers running may by terminated during a scale-down
1016
+ # active game servers running might be terminated during a scale-down
994
1017
  # event, causing players to be dropped from the game. Protected
995
1018
  # instances cannot be terminated while there are active game servers
996
- # running. An exception to this is Spot Instances, which may be
1019
+ # running except in the event of a forced game server group deletion
1020
+ # (see ). An exception to this is with Spot Instances, which can be
997
1021
  # terminated by AWS regardless of protection status. This property is
998
- # set to NO\_PROTECTION by default.
1022
+ # set to `NO_PROTECTION` by default.
999
1023
  # @return [String]
1000
1024
  #
1001
1025
  # @!attribute [rw] vpc_subnets
1002
1026
  # A list of virtual private cloud (VPC) subnets to use with instances
1003
1027
  # in the game server group. By default, all GameLift FleetIQ-supported
1004
- # availability zones are used; this parameter allows you to specify
1005
- # VPCs that you've set up.
1028
+ # Availability Zones are used. You can use this parameter to specify
1029
+ # VPCs that you've set up. This property cannot be updated after the
1030
+ # game server group is created, and the corresponding Auto Scaling
1031
+ # group will always use the property value that is set with this
1032
+ # request, even if the Auto Scaling group is updated directly.
1006
1033
  # @return [Array<String>]
1007
1034
  #
1008
1035
  # @!attribute [rw] tags
1009
1036
  # A list of labels to assign to the new game server group resource.
1010
- # Tags are developer-defined key-value pairs. Tagging AWS resources
1011
- # are useful for resource management, access management, and cost
1037
+ # Tags are developer-defined key-value pairs. Tagging AWS resources is
1038
+ # useful for resource management, access management, and cost
1012
1039
  # allocation. For more information, see [ Tagging AWS Resources][1] in
1013
1040
  # the *AWS General Reference*. Once the resource is created, you can
1014
1041
  # use TagResource, UntagResource, and ListTagsForResource to add,
1015
- # remove, and view tags. The maximum tag limit may be lower than
1016
- # stated. See the AWS General Reference for actual tagging limits.
1042
+ # remove, and view tags, respectively. The maximum tag limit may be
1043
+ # lower than stated. See the AWS General Reference for actual tagging
1044
+ # limits.
1017
1045
  #
1018
1046
  #
1019
1047
  #
@@ -1043,7 +1071,7 @@ module Aws::GameLift
1043
1071
  # value for the GameLift FleetIQ game server group and the object's
1044
1072
  # status. The EC2 Auto Scaling group ARN is initially null, since the
1045
1073
  # group has not yet been created. This value is added once the game
1046
- # server group status reaches ACTIVE.
1074
+ # server group status reaches `ACTIVE`.
1047
1075
  # @return [Types::GameServerGroup]
1048
1076
  #
1049
1077
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateGameServerGroupOutput AWS API Documentation
@@ -1054,7 +1082,7 @@ module Aws::GameLift
1054
1082
  include Aws::Structure
1055
1083
  end
1056
1084
 
1057
- # Represents the input for a request action.
1085
+ # Represents the input for a request operation.
1058
1086
  #
1059
1087
  # @note When making an API call, you may pass CreateGameSessionInput
1060
1088
  # data as a hash:
@@ -1165,7 +1193,7 @@ module Aws::GameLift
1165
1193
  include Aws::Structure
1166
1194
  end
1167
1195
 
1168
- # Represents the returned data in response to a request action.
1196
+ # Represents the returned data in response to a request operation.
1169
1197
  #
1170
1198
  # @!attribute [rw] game_session
1171
1199
  # Object that describes the newly created game session record.
@@ -1179,7 +1207,7 @@ module Aws::GameLift
1179
1207
  include Aws::Structure
1180
1208
  end
1181
1209
 
1182
- # Represents the input for a request action.
1210
+ # Represents the input for a request operation.
1183
1211
  #
1184
1212
  # @note When making an API call, you may pass CreateGameSessionQueueInput
1185
1213
  # data as a hash:
@@ -1266,7 +1294,7 @@ module Aws::GameLift
1266
1294
  include Aws::Structure
1267
1295
  end
1268
1296
 
1269
- # Represents the returned data in response to a request action.
1297
+ # Represents the returned data in response to a request operation.
1270
1298
  #
1271
1299
  # @!attribute [rw] game_session_queue
1272
1300
  # An object that describes the newly created game session queue.
@@ -1280,7 +1308,7 @@ module Aws::GameLift
1280
1308
  include Aws::Structure
1281
1309
  end
1282
1310
 
1283
- # Represents the input for a request action.
1311
+ # Represents the input for a request operation.
1284
1312
  #
1285
1313
  # @note When making an API call, you may pass CreateMatchmakingConfigurationInput
1286
1314
  # data as a hash:
@@ -1288,7 +1316,7 @@ module Aws::GameLift
1288
1316
  # {
1289
1317
  # name: "MatchmakingIdStringModel", # required
1290
1318
  # description: "NonZeroAndMaxString",
1291
- # game_session_queue_arns: ["ArnStringModel"], # required
1319
+ # game_session_queue_arns: ["ArnStringModel"],
1292
1320
  # request_timeout_seconds: 1, # required
1293
1321
  # acceptance_timeout_seconds: 1,
1294
1322
  # acceptance_required: false, # required
@@ -1304,6 +1332,7 @@ module Aws::GameLift
1304
1332
  # ],
1305
1333
  # game_session_data: "GameSessionData",
1306
1334
  # backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
1335
+ # flex_match_mode: "STANDALONE", # accepts STANDALONE, WITH_QUEUE
1307
1336
  # tags: [
1308
1337
  # {
1309
1338
  # key: "TagKey", # required
@@ -1325,9 +1354,10 @@ module Aws::GameLift
1325
1354
  # @!attribute [rw] game_session_queue_arns
1326
1355
  # Amazon Resource Name ([ARN][1]) that is assigned to a GameLift game
1327
1356
  # session queue resource and uniquely identifies it. ARNs are unique
1328
- # across all Regions. These queues are used when placing game sessions
1329
- # for matches that are created with this matchmaking configuration.
1330
- # Queues can be located in any Region.
1357
+ # across all Regions. Queues can be located in any Region. Queues are
1358
+ # used to start new GameLift-hosted game sessions for matches that are
1359
+ # created with this matchmaking configuration. If `FlexMatchMode` is
1360
+ # set to `STANDALONE`, do not set this parameter.
1331
1361
  #
1332
1362
  #
1333
1363
  #
@@ -1342,15 +1372,18 @@ module Aws::GameLift
1342
1372
  #
1343
1373
  # @!attribute [rw] acceptance_timeout_seconds
1344
1374
  # The length of time (in seconds) to wait for players to accept a
1345
- # proposed match. If any player rejects the match or fails to accept
1346
- # before the timeout, the ticket continues to look for an acceptable
1347
- # match.
1375
+ # proposed match, if acceptance is required. If any player rejects the
1376
+ # match or fails to accept before the timeout, the tickets are
1377
+ # returned to the ticket pool and continue to be evaluated for an
1378
+ # acceptable match.
1348
1379
  # @return [Integer]
1349
1380
  #
1350
1381
  # @!attribute [rw] acceptance_required
1351
1382
  # A flag that determines whether a match that was created with this
1352
1383
  # configuration must be accepted by the matched players. To require
1353
- # acceptance, set to `TRUE`.
1384
+ # acceptance, set to `TRUE`. With this option enabled, matchmaking
1385
+ # tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a
1386
+ # completed potential match is waiting for player acceptance.
1354
1387
  # @return [Boolean]
1355
1388
  #
1356
1389
  # @!attribute [rw] rule_set_name
@@ -1370,7 +1403,8 @@ module Aws::GameLift
1370
1403
  # players. For example, assume that the configuration's rule set
1371
1404
  # specifies a match for a single 12-person team. If the additional
1372
1405
  # player count is set to 2, only 10 players are initially selected for
1373
- # the match.
1406
+ # the match. This parameter is not used if `FlexMatchMode` is set to
1407
+ # `STANDALONE`.
1374
1408
  # @return [Integer]
1375
1409
  #
1376
1410
  # @!attribute [rw] custom_event_data
@@ -1384,7 +1418,8 @@ module Aws::GameLift
1384
1418
  # process in the GameSession object with a request to start a new game
1385
1419
  # session (see [Start a Game Session][1]). This information is added
1386
1420
  # to the new GameSession object that is created for a successful
1387
- # match.
1421
+ # match. This parameter is not used if `FlexMatchMode` is set to
1422
+ # `STANDALONE`.
1388
1423
  #
1389
1424
  #
1390
1425
  #
@@ -1396,7 +1431,8 @@ module Aws::GameLift
1396
1431
  # string value. This data is passed to a game server process in the
1397
1432
  # GameSession object with a request to start a new game session (see
1398
1433
  # [Start a Game Session][1]). This information is added to the new
1399
- # GameSession object that is created for a successful match.
1434
+ # GameSession object that is created for a successful match. This
1435
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
1400
1436
  #
1401
1437
  #
1402
1438
  #
@@ -1410,11 +1446,28 @@ module Aws::GameLift
1410
1446
  # feature. Specify `AUTOMATIC` to have GameLift create a
1411
1447
  # StartMatchBackfill request whenever a game session has one or more
1412
1448
  # open slots. Learn more about manual and automatic backfill in [
1413
- # Backfill Existing Games with FlexMatch][1].
1449
+ # Backfill Existing Games with FlexMatch][1]. Automatic backfill is
1450
+ # not available when `FlexMatchMode` is set to `STANDALONE`.
1414
1451
  #
1415
1452
  #
1416
1453
  #
1417
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
1454
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
1455
+ # @return [String]
1456
+ #
1457
+ # @!attribute [rw] flex_match_mode
1458
+ # Indicates whether this matchmaking configuration is being used with
1459
+ # GameLift hosting or as a standalone matchmaking solution.
1460
+ #
1461
+ # * **STANDALONE** - FlexMatch forms matches and returns match
1462
+ # information, including players and team assignments, in a [
1463
+ # MatchmakingSucceeded][1] event.
1464
+ #
1465
+ # * **WITH\_QUEUE** - FlexMatch forms matches and uses the specified
1466
+ # GameLift queue to start a game session for the match.
1467
+ #
1468
+ #
1469
+ #
1470
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded
1418
1471
  # @return [String]
1419
1472
  #
1420
1473
  # @!attribute [rw] tags
@@ -1449,12 +1502,13 @@ module Aws::GameLift
1449
1502
  :game_properties,
1450
1503
  :game_session_data,
1451
1504
  :backfill_mode,
1505
+ :flex_match_mode,
1452
1506
  :tags)
1453
1507
  SENSITIVE = []
1454
1508
  include Aws::Structure
1455
1509
  end
1456
1510
 
1457
- # Represents the returned data in response to a request action.
1511
+ # Represents the returned data in response to a request operation.
1458
1512
  #
1459
1513
  # @!attribute [rw] configuration
1460
1514
  # Object that describes the newly created matchmaking configuration.
@@ -1468,7 +1522,7 @@ module Aws::GameLift
1468
1522
  include Aws::Structure
1469
1523
  end
1470
1524
 
1471
- # Represents the input for a request action.
1525
+ # Represents the input for a request operation.
1472
1526
  #
1473
1527
  # @note When making an API call, you may pass CreateMatchmakingRuleSetInput
1474
1528
  # data as a hash:
@@ -1522,7 +1576,7 @@ module Aws::GameLift
1522
1576
  include Aws::Structure
1523
1577
  end
1524
1578
 
1525
- # Represents the returned data in response to a request action.
1579
+ # Represents the returned data in response to a request operation.
1526
1580
  #
1527
1581
  # @!attribute [rw] rule_set
1528
1582
  # The newly created matchmaking rule set.
@@ -1536,7 +1590,7 @@ module Aws::GameLift
1536
1590
  include Aws::Structure
1537
1591
  end
1538
1592
 
1539
- # Represents the input for a request action.
1593
+ # Represents the input for a request operation.
1540
1594
  #
1541
1595
  # @note When making an API call, you may pass CreatePlayerSessionInput
1542
1596
  # data as a hash:
@@ -1571,7 +1625,7 @@ module Aws::GameLift
1571
1625
  include Aws::Structure
1572
1626
  end
1573
1627
 
1574
- # Represents the returned data in response to a request action.
1628
+ # Represents the returned data in response to a request operation.
1575
1629
  #
1576
1630
  # @!attribute [rw] player_session
1577
1631
  # Object that describes the newly created player session record.
@@ -1585,7 +1639,7 @@ module Aws::GameLift
1585
1639
  include Aws::Structure
1586
1640
  end
1587
1641
 
1588
- # Represents the input for a request action.
1642
+ # Represents the input for a request operation.
1589
1643
  #
1590
1644
  # @note When making an API call, you may pass CreatePlayerSessionsInput
1591
1645
  # data as a hash:
@@ -1624,7 +1678,7 @@ module Aws::GameLift
1624
1678
  include Aws::Structure
1625
1679
  end
1626
1680
 
1627
- # Represents the returned data in response to a request action.
1681
+ # Represents the returned data in response to a request operation.
1628
1682
  #
1629
1683
  # @!attribute [rw] player_sessions
1630
1684
  # A collection of player session objects created for the added
@@ -1673,15 +1727,21 @@ module Aws::GameLift
1673
1727
  # @return [String]
1674
1728
  #
1675
1729
  # @!attribute [rw] storage_location
1676
- # The location of the Amazon S3 bucket where a zipped file containing
1677
- # your Realtime scripts is stored. The storage location must specify
1678
- # the Amazon S3 bucket name, the zip file name (the "key"), and a
1679
- # role ARN that allows Amazon GameLift to access the Amazon S3 storage
1680
- # location. The S3 bucket must be in the same Region where you want to
1681
- # create a new script. By default, Amazon GameLift uploads the latest
1682
- # version of the zip file; if you have S3 object versioning turned on,
1683
- # you can use the `ObjectVersion` parameter to specify an earlier
1684
- # version.
1730
+ # The Amazon S3 location of your Realtime scripts. The storage
1731
+ # location must specify the S3 bucket name, the zip file name (the
1732
+ # "key"), and an IAM role ARN that allows Amazon GameLift to access
1733
+ # the S3 storage location. The S3 bucket must be in the same Region
1734
+ # where you are creating a new script. By default, Amazon GameLift
1735
+ # uploads the latest version of the zip file; if you have S3 object
1736
+ # versioning turned on, you can use the `ObjectVersion` parameter to
1737
+ # specify an earlier version. To call this operation with a storage
1738
+ # location, you must have IAM PassRole permission. For more details on
1739
+ # IAM roles and PassRole permissions, see [ Set up a role for GameLift
1740
+ # access][1].
1741
+ #
1742
+ #
1743
+ #
1744
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
1685
1745
  # @return [Types::S3Location]
1686
1746
  #
1687
1747
  # @!attribute [rw] zip_file
@@ -1740,7 +1800,7 @@ module Aws::GameLift
1740
1800
  include Aws::Structure
1741
1801
  end
1742
1802
 
1743
- # Represents the input for a request action.
1803
+ # Represents the input for a request operation.
1744
1804
  #
1745
1805
  # @note When making an API call, you may pass CreateVpcPeeringAuthorizationInput
1746
1806
  # data as a hash:
@@ -1778,7 +1838,7 @@ module Aws::GameLift
1778
1838
  include Aws::Structure
1779
1839
  end
1780
1840
 
1781
- # Represents the returned data in response to a request action.
1841
+ # Represents the returned data in response to a request operation.
1782
1842
  #
1783
1843
  # @!attribute [rw] vpc_peering_authorization
1784
1844
  # Details on the requested VPC peering authorization, including
@@ -1793,7 +1853,7 @@ module Aws::GameLift
1793
1853
  include Aws::Structure
1794
1854
  end
1795
1855
 
1796
- # Represents the input for a request action.
1856
+ # Represents the input for a request operation.
1797
1857
  #
1798
1858
  # @note When making an API call, you may pass CreateVpcPeeringConnectionInput
1799
1859
  # data as a hash:
@@ -1843,7 +1903,7 @@ module Aws::GameLift
1843
1903
  #
1844
1904
  class CreateVpcPeeringConnectionOutput < Aws::EmptyStructure; end
1845
1905
 
1846
- # Represents the input for a request action.
1906
+ # Represents the input for a request operation.
1847
1907
  #
1848
1908
  # @note When making an API call, you may pass DeleteAliasInput
1849
1909
  # data as a hash:
@@ -1865,7 +1925,7 @@ module Aws::GameLift
1865
1925
  include Aws::Structure
1866
1926
  end
1867
1927
 
1868
- # Represents the input for a request action.
1928
+ # Represents the input for a request operation.
1869
1929
  #
1870
1930
  # @note When making an API call, you may pass DeleteBuildInput
1871
1931
  # data as a hash:
@@ -1887,7 +1947,7 @@ module Aws::GameLift
1887
1947
  include Aws::Structure
1888
1948
  end
1889
1949
 
1890
- # Represents the input for a request action.
1950
+ # Represents the input for a request operation.
1891
1951
  #
1892
1952
  # @note When making an API call, you may pass DeleteFleetInput
1893
1953
  # data as a hash:
@@ -1918,22 +1978,22 @@ module Aws::GameLift
1918
1978
  # }
1919
1979
  #
1920
1980
  # @!attribute [rw] game_server_group_name
1921
- # The unique identifier of the game server group to delete. Use either
1922
- # the GameServerGroup name or ARN value.
1981
+ # A unique identifier for the game server group. Use either the
1982
+ # GameServerGroup name or ARN value.
1923
1983
  # @return [String]
1924
1984
  #
1925
1985
  # @!attribute [rw] delete_option
1926
- # The type of delete to perform. Options include:
1986
+ # The type of delete to perform. Options include the following:
1927
1987
  #
1928
- # * SAFE\_DELETE – Terminates the game server group and EC2 Auto
1929
- # Scaling group only when it has no game servers that are in IN\_USE
1930
- # status.
1988
+ # * `SAFE_DELETE`(default) Terminates the game server group and EC2
1989
+ # Auto Scaling group only when it has no game servers that are in
1990
+ # `UTILIZED` status.
1931
1991
  #
1932
- # * FORCE\_DELETE – Terminates the game server group, including all
1992
+ # * `FORCE_DELETE` – Terminates the game server group, including all
1933
1993
  # active game servers regardless of their utilization status, and
1934
1994
  # the EC2 Auto Scaling group.
1935
1995
  #
1936
- # * RETAIN – Does a safe delete of the game server group but retains
1996
+ # * `RETAIN` – Does a safe delete of the game server group but retains
1937
1997
  # the EC2 Auto Scaling group as is.
1938
1998
  # @return [String]
1939
1999
  #
@@ -1948,7 +2008,7 @@ module Aws::GameLift
1948
2008
 
1949
2009
  # @!attribute [rw] game_server_group
1950
2010
  # An object that describes the deleted game server group resource,
1951
- # with status updated to DELETE\_SCHEDULED.
2011
+ # with status updated to `DELETE_SCHEDULED`.
1952
2012
  # @return [Types::GameServerGroup]
1953
2013
  #
1954
2014
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteGameServerGroupOutput AWS API Documentation
@@ -1959,7 +2019,7 @@ module Aws::GameLift
1959
2019
  include Aws::Structure
1960
2020
  end
1961
2021
 
1962
- # Represents the input for a request action.
2022
+ # Represents the input for a request operation.
1963
2023
  #
1964
2024
  # @note When making an API call, you may pass DeleteGameSessionQueueInput
1965
2025
  # data as a hash:
@@ -1986,7 +2046,7 @@ module Aws::GameLift
1986
2046
  #
1987
2047
  class DeleteGameSessionQueueOutput < Aws::EmptyStructure; end
1988
2048
 
1989
- # Represents the input for a request action.
2049
+ # Represents the input for a request operation.
1990
2050
  #
1991
2051
  # @note When making an API call, you may pass DeleteMatchmakingConfigurationInput
1992
2052
  # data as a hash:
@@ -2012,7 +2072,7 @@ module Aws::GameLift
2012
2072
  #
2013
2073
  class DeleteMatchmakingConfigurationOutput < Aws::EmptyStructure; end
2014
2074
 
2015
- # Represents the input for a request action.
2075
+ # Represents the input for a request operation.
2016
2076
  #
2017
2077
  # @note When making an API call, you may pass DeleteMatchmakingRuleSetInput
2018
2078
  # data as a hash:
@@ -2036,13 +2096,13 @@ module Aws::GameLift
2036
2096
  include Aws::Structure
2037
2097
  end
2038
2098
 
2039
- # Represents the returned data in response to a request action.
2099
+ # Represents the returned data in response to a request operation.
2040
2100
  #
2041
2101
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteMatchmakingRuleSetOutput AWS API Documentation
2042
2102
  #
2043
2103
  class DeleteMatchmakingRuleSetOutput < Aws::EmptyStructure; end
2044
2104
 
2045
- # Represents the input for a request action.
2105
+ # Represents the input for a request operation.
2046
2106
  #
2047
2107
  # @note When making an API call, you may pass DeleteScalingPolicyInput
2048
2108
  # data as a hash:
@@ -2091,7 +2151,7 @@ module Aws::GameLift
2091
2151
  include Aws::Structure
2092
2152
  end
2093
2153
 
2094
- # Represents the input for a request action.
2154
+ # Represents the input for a request operation.
2095
2155
  #
2096
2156
  # @note When making an API call, you may pass DeleteVpcPeeringAuthorizationInput
2097
2157
  # data as a hash:
@@ -2133,7 +2193,7 @@ module Aws::GameLift
2133
2193
  #
2134
2194
  class DeleteVpcPeeringAuthorizationOutput < Aws::EmptyStructure; end
2135
2195
 
2136
- # Represents the input for a request action.
2196
+ # Represents the input for a request operation.
2137
2197
  #
2138
2198
  # @note When making an API call, you may pass DeleteVpcPeeringConnectionInput
2139
2199
  # data as a hash:
@@ -2177,13 +2237,13 @@ module Aws::GameLift
2177
2237
  # }
2178
2238
  #
2179
2239
  # @!attribute [rw] game_server_group_name
2180
- # An identifier for the game server group where the game server to be
2181
- # de-registered is running. Use either the GameServerGroup name or ARN
2182
- # value.
2240
+ # A unique identifier for the game server group where the game server
2241
+ # is running. Use either the GameServerGroup name or ARN value.
2183
2242
  # @return [String]
2184
2243
  #
2185
2244
  # @!attribute [rw] game_server_id
2186
- # The identifier for the game server to be de-registered.
2245
+ # A custom string that uniquely identifies the game server to
2246
+ # deregister.
2187
2247
  # @return [String]
2188
2248
  #
2189
2249
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeregisterGameServerInput AWS API Documentation
@@ -2195,7 +2255,7 @@ module Aws::GameLift
2195
2255
  include Aws::Structure
2196
2256
  end
2197
2257
 
2198
- # Represents the input for a request action.
2258
+ # Represents the input for a request operation.
2199
2259
  #
2200
2260
  # @note When making an API call, you may pass DescribeAliasInput
2201
2261
  # data as a hash:
@@ -2217,7 +2277,7 @@ module Aws::GameLift
2217
2277
  include Aws::Structure
2218
2278
  end
2219
2279
 
2220
- # Represents the returned data in response to a request action.
2280
+ # Represents the returned data in response to a request operation.
2221
2281
  #
2222
2282
  # @!attribute [rw] alias
2223
2283
  # The requested alias resource.
@@ -2231,7 +2291,7 @@ module Aws::GameLift
2231
2291
  include Aws::Structure
2232
2292
  end
2233
2293
 
2234
- # Represents the input for a request action.
2294
+ # Represents the input for a request operation.
2235
2295
  #
2236
2296
  # @note When making an API call, you may pass DescribeBuildInput
2237
2297
  # data as a hash:
@@ -2253,7 +2313,7 @@ module Aws::GameLift
2253
2313
  include Aws::Structure
2254
2314
  end
2255
2315
 
2256
- # Represents the returned data in response to a request action.
2316
+ # Represents the returned data in response to a request operation.
2257
2317
  #
2258
2318
  # @!attribute [rw] build
2259
2319
  # Set of properties describing the requested build.
@@ -2267,13 +2327,13 @@ module Aws::GameLift
2267
2327
  include Aws::Structure
2268
2328
  end
2269
2329
 
2270
- # Represents the input for a request action.
2330
+ # Represents the input for a request operation.
2271
2331
  #
2272
2332
  # @note When making an API call, you may pass DescribeEC2InstanceLimitsInput
2273
2333
  # data as a hash:
2274
2334
  #
2275
2335
  # {
2276
- # ec2_instance_type: "t2.micro", # accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge
2336
+ # ec2_instance_type: "t2.micro", # accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, c5a.large, c5a.xlarge, c5a.2xlarge, c5a.4xlarge, c5a.8xlarge, c5a.12xlarge, c5a.16xlarge, c5a.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.8xlarge, r5a.12xlarge, r5a.16xlarge, r5a.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge, m5a.large, m5a.xlarge, m5a.2xlarge, m5a.4xlarge, m5a.8xlarge, m5a.12xlarge, m5a.16xlarge, m5a.24xlarge
2277
2337
  # }
2278
2338
  #
2279
2339
  # @!attribute [rw] ec2_instance_type
@@ -2298,7 +2358,7 @@ module Aws::GameLift
2298
2358
  include Aws::Structure
2299
2359
  end
2300
2360
 
2301
- # Represents the returned data in response to a request action.
2361
+ # Represents the returned data in response to a request operation.
2302
2362
  #
2303
2363
  # @!attribute [rw] ec2_instance_limits
2304
2364
  # The maximum number of instances for the specified instance type.
@@ -2312,7 +2372,7 @@ module Aws::GameLift
2312
2372
  include Aws::Structure
2313
2373
  end
2314
2374
 
2315
- # Represents the input for a request action.
2375
+ # Represents the input for a request operation.
2316
2376
  #
2317
2377
  # @note When making an API call, you may pass DescribeFleetAttributesInput
2318
2378
  # data as a hash:
@@ -2341,9 +2401,9 @@ module Aws::GameLift
2341
2401
  # @!attribute [rw] next_token
2342
2402
  # Token that indicates the start of the next sequential page of
2343
2403
  # results. Use the token that is returned with a previous call to this
2344
- # action. To start at the beginning of the result set, do not specify
2345
- # a value. This parameter is ignored when the request specifies one or
2346
- # a list of fleet IDs.
2404
+ # operation. To start at the beginning of the result set, do not
2405
+ # specify a value. This parameter is ignored when the request
2406
+ # specifies one or a list of fleet IDs.
2347
2407
  # @return [String]
2348
2408
  #
2349
2409
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetAttributesInput AWS API Documentation
@@ -2356,7 +2416,7 @@ module Aws::GameLift
2356
2416
  include Aws::Structure
2357
2417
  end
2358
2418
 
2359
- # Represents the returned data in response to a request action.
2419
+ # Represents the returned data in response to a request operation.
2360
2420
  #
2361
2421
  # @!attribute [rw] fleet_attributes
2362
2422
  # A collection of objects containing attribute metadata for each
@@ -2366,7 +2426,7 @@ module Aws::GameLift
2366
2426
  #
2367
2427
  # @!attribute [rw] next_token
2368
2428
  # Token that indicates where to resume retrieving results on the next
2369
- # call to this action. If no token is returned, these results
2429
+ # call to this operation. If no token is returned, these results
2370
2430
  # represent the end of the list.
2371
2431
  # @return [String]
2372
2432
  #
@@ -2379,7 +2439,7 @@ module Aws::GameLift
2379
2439
  include Aws::Structure
2380
2440
  end
2381
2441
 
2382
- # Represents the input for a request action.
2442
+ # Represents the input for a request operation.
2383
2443
  #
2384
2444
  # @note When making an API call, you may pass DescribeFleetCapacityInput
2385
2445
  # data as a hash:
@@ -2405,9 +2465,9 @@ module Aws::GameLift
2405
2465
  # @!attribute [rw] next_token
2406
2466
  # Token that indicates the start of the next sequential page of
2407
2467
  # results. Use the token that is returned with a previous call to this
2408
- # action. To start at the beginning of the result set, do not specify
2409
- # a value. This parameter is ignored when the request specifies one or
2410
- # a list of fleet IDs.
2468
+ # operation. To start at the beginning of the result set, do not
2469
+ # specify a value. This parameter is ignored when the request
2470
+ # specifies one or a list of fleet IDs.
2411
2471
  # @return [String]
2412
2472
  #
2413
2473
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetCapacityInput AWS API Documentation
@@ -2420,7 +2480,7 @@ module Aws::GameLift
2420
2480
  include Aws::Structure
2421
2481
  end
2422
2482
 
2423
- # Represents the returned data in response to a request action.
2483
+ # Represents the returned data in response to a request operation.
2424
2484
  #
2425
2485
  # @!attribute [rw] fleet_capacity
2426
2486
  # A collection of objects containing capacity information for each
@@ -2430,7 +2490,7 @@ module Aws::GameLift
2430
2490
  #
2431
2491
  # @!attribute [rw] next_token
2432
2492
  # Token that indicates where to resume retrieving results on the next
2433
- # call to this action. If no token is returned, these results
2493
+ # call to this operation. If no token is returned, these results
2434
2494
  # represent the end of the list.
2435
2495
  # @return [String]
2436
2496
  #
@@ -2443,7 +2503,7 @@ module Aws::GameLift
2443
2503
  include Aws::Structure
2444
2504
  end
2445
2505
 
2446
- # Represents the input for a request action.
2506
+ # Represents the input for a request operation.
2447
2507
  #
2448
2508
  # @note When making an API call, you may pass DescribeFleetEventsInput
2449
2509
  # data as a hash:
@@ -2483,8 +2543,8 @@ module Aws::GameLift
2483
2543
  # @!attribute [rw] next_token
2484
2544
  # Token that indicates the start of the next sequential page of
2485
2545
  # results. Use the token that is returned with a previous call to this
2486
- # action. To start at the beginning of the result set, do not specify
2487
- # a value.
2546
+ # operation. To start at the beginning of the result set, do not
2547
+ # specify a value.
2488
2548
  # @return [String]
2489
2549
  #
2490
2550
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetEventsInput AWS API Documentation
@@ -2499,7 +2559,7 @@ module Aws::GameLift
2499
2559
  include Aws::Structure
2500
2560
  end
2501
2561
 
2502
- # Represents the returned data in response to a request action.
2562
+ # Represents the returned data in response to a request operation.
2503
2563
  #
2504
2564
  # @!attribute [rw] events
2505
2565
  # A collection of objects containing event log entries for the
@@ -2508,7 +2568,7 @@ module Aws::GameLift
2508
2568
  #
2509
2569
  # @!attribute [rw] next_token
2510
2570
  # Token that indicates where to resume retrieving results on the next
2511
- # call to this action. If no token is returned, these results
2571
+ # call to this operation. If no token is returned, these results
2512
2572
  # represent the end of the list.
2513
2573
  # @return [String]
2514
2574
  #
@@ -2521,7 +2581,7 @@ module Aws::GameLift
2521
2581
  include Aws::Structure
2522
2582
  end
2523
2583
 
2524
- # Represents the input for a request action.
2584
+ # Represents the input for a request operation.
2525
2585
  #
2526
2586
  # @note When making an API call, you may pass DescribeFleetPortSettingsInput
2527
2587
  # data as a hash:
@@ -2543,7 +2603,7 @@ module Aws::GameLift
2543
2603
  include Aws::Structure
2544
2604
  end
2545
2605
 
2546
- # Represents the returned data in response to a request action.
2606
+ # Represents the returned data in response to a request operation.
2547
2607
  #
2548
2608
  # @!attribute [rw] inbound_permissions
2549
2609
  # The port settings for the requested fleet ID.
@@ -2557,7 +2617,7 @@ module Aws::GameLift
2557
2617
  include Aws::Structure
2558
2618
  end
2559
2619
 
2560
- # Represents the input for a request action.
2620
+ # Represents the input for a request operation.
2561
2621
  #
2562
2622
  # @note When making an API call, you may pass DescribeFleetUtilizationInput
2563
2623
  # data as a hash:
@@ -2586,9 +2646,9 @@ module Aws::GameLift
2586
2646
  # @!attribute [rw] next_token
2587
2647
  # Token that indicates the start of the next sequential page of
2588
2648
  # results. Use the token that is returned with a previous call to this
2589
- # action. To start at the beginning of the result set, do not specify
2590
- # a value. This parameter is ignored when the request specifies one or
2591
- # a list of fleet IDs.
2649
+ # operation. To start at the beginning of the result set, do not
2650
+ # specify a value. This parameter is ignored when the request
2651
+ # specifies one or a list of fleet IDs.
2592
2652
  # @return [String]
2593
2653
  #
2594
2654
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetUtilizationInput AWS API Documentation
@@ -2601,7 +2661,7 @@ module Aws::GameLift
2601
2661
  include Aws::Structure
2602
2662
  end
2603
2663
 
2604
- # Represents the returned data in response to a request action.
2664
+ # Represents the returned data in response to a request operation.
2605
2665
  #
2606
2666
  # @!attribute [rw] fleet_utilization
2607
2667
  # A collection of objects containing utilization information for each
@@ -2610,7 +2670,7 @@ module Aws::GameLift
2610
2670
  #
2611
2671
  # @!attribute [rw] next_token
2612
2672
  # Token that indicates where to resume retrieving results on the next
2613
- # call to this action. If no token is returned, these results
2673
+ # call to this operation. If no token is returned, these results
2614
2674
  # represent the end of the list.
2615
2675
  # @return [String]
2616
2676
  #
@@ -2631,8 +2691,8 @@ module Aws::GameLift
2631
2691
  # }
2632
2692
  #
2633
2693
  # @!attribute [rw] game_server_group_name
2634
- # The unique identifier for the game server group being requested. Use
2635
- # either the GameServerGroup name or ARN value.
2694
+ # A unique identifier for the game server group. Use either the
2695
+ # GameServerGroup name or ARN value.
2636
2696
  # @return [String]
2637
2697
  #
2638
2698
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerGroupInput AWS API Documentation
@@ -2644,7 +2704,8 @@ module Aws::GameLift
2644
2704
  end
2645
2705
 
2646
2706
  # @!attribute [rw] game_server_group
2647
- # An object that describes the requested game server group resource.
2707
+ # An object with the property settings for the requested game server
2708
+ # group resource.
2648
2709
  # @return [Types::GameServerGroup]
2649
2710
  #
2650
2711
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerGroupOutput AWS API Documentation
@@ -2664,12 +2725,13 @@ module Aws::GameLift
2664
2725
  # }
2665
2726
  #
2666
2727
  # @!attribute [rw] game_server_group_name
2667
- # An identifier for the game server group where the game server is
2668
- # running. Use either the GameServerGroup name or ARN value.
2728
+ # A unique identifier for the game server group where the game server
2729
+ # is running. Use either the GameServerGroup name or ARN value.
2669
2730
  # @return [String]
2670
2731
  #
2671
2732
  # @!attribute [rw] game_server_id
2672
- # The identifier for the game server to be retrieved.
2733
+ # A custom string that uniquely identifies the game server information
2734
+ # to be retrieved.
2673
2735
  # @return [String]
2674
2736
  #
2675
2737
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerInput AWS API Documentation
@@ -2681,8 +2743,72 @@ module Aws::GameLift
2681
2743
  include Aws::Structure
2682
2744
  end
2683
2745
 
2746
+ # @note When making an API call, you may pass DescribeGameServerInstancesInput
2747
+ # data as a hash:
2748
+ #
2749
+ # {
2750
+ # game_server_group_name: "GameServerGroupNameOrArn", # required
2751
+ # instance_ids: ["GameServerInstanceId"],
2752
+ # limit: 1,
2753
+ # next_token: "NonZeroAndMaxString",
2754
+ # }
2755
+ #
2756
+ # @!attribute [rw] game_server_group_name
2757
+ # A unique identifier for the game server group. Use either the
2758
+ # GameServerGroup name or ARN value.
2759
+ # @return [String]
2760
+ #
2761
+ # @!attribute [rw] instance_ids
2762
+ # The EC2 instance IDs that you want to retrieve status on. EC2
2763
+ # instance IDs use a 17-character format, for example:
2764
+ # `i-1234567890abcdef0`. To retrieve all instances in the game server
2765
+ # group, leave this parameter empty.
2766
+ # @return [Array<String>]
2767
+ #
2768
+ # @!attribute [rw] limit
2769
+ # The maximum number of results to return. Use this parameter with
2770
+ # `NextToken` to get results as a set of sequential segments.
2771
+ # @return [Integer]
2772
+ #
2773
+ # @!attribute [rw] next_token
2774
+ # A token that indicates the start of the next sequential segment of
2775
+ # results. Use the token returned with the previous call to this
2776
+ # operation. To start at the beginning of the result set, do not
2777
+ # specify a value.
2778
+ # @return [String]
2779
+ #
2780
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerInstancesInput AWS API Documentation
2781
+ #
2782
+ class DescribeGameServerInstancesInput < Struct.new(
2783
+ :game_server_group_name,
2784
+ :instance_ids,
2785
+ :limit,
2786
+ :next_token)
2787
+ SENSITIVE = []
2788
+ include Aws::Structure
2789
+ end
2790
+
2791
+ # @!attribute [rw] game_server_instances
2792
+ # The collection of requested game server instances.
2793
+ # @return [Array<Types::GameServerInstance>]
2794
+ #
2795
+ # @!attribute [rw] next_token
2796
+ # A token that indicates where to resume retrieving results on the
2797
+ # next call to this operation. If no token is returned, these results
2798
+ # represent the end of the list.
2799
+ # @return [String]
2800
+ #
2801
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerInstancesOutput AWS API Documentation
2802
+ #
2803
+ class DescribeGameServerInstancesOutput < Struct.new(
2804
+ :game_server_instances,
2805
+ :next_token)
2806
+ SENSITIVE = []
2807
+ include Aws::Structure
2808
+ end
2809
+
2684
2810
  # @!attribute [rw] game_server
2685
- # Object that describes the requested game server resource.
2811
+ # Object that describes the requested game server.
2686
2812
  # @return [Types::GameServer]
2687
2813
  #
2688
2814
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameServerOutput AWS API Documentation
@@ -2693,7 +2819,7 @@ module Aws::GameLift
2693
2819
  include Aws::Structure
2694
2820
  end
2695
2821
 
2696
- # Represents the input for a request action.
2822
+ # Represents the input for a request operation.
2697
2823
  #
2698
2824
  # @note When making an API call, you may pass DescribeGameSessionDetailsInput
2699
2825
  # data as a hash:
@@ -2736,8 +2862,8 @@ module Aws::GameLift
2736
2862
  # @!attribute [rw] next_token
2737
2863
  # Token that indicates the start of the next sequential page of
2738
2864
  # results. Use the token that is returned with a previous call to this
2739
- # action. To start at the beginning of the result set, do not specify
2740
- # a value.
2865
+ # operation. To start at the beginning of the result set, do not
2866
+ # specify a value.
2741
2867
  # @return [String]
2742
2868
  #
2743
2869
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionDetailsInput AWS API Documentation
@@ -2753,7 +2879,7 @@ module Aws::GameLift
2753
2879
  include Aws::Structure
2754
2880
  end
2755
2881
 
2756
- # Represents the returned data in response to a request action.
2882
+ # Represents the returned data in response to a request operation.
2757
2883
  #
2758
2884
  # @!attribute [rw] game_session_details
2759
2885
  # A collection of objects containing game session properties and the
@@ -2763,7 +2889,7 @@ module Aws::GameLift
2763
2889
  #
2764
2890
  # @!attribute [rw] next_token
2765
2891
  # Token that indicates where to resume retrieving results on the next
2766
- # call to this action. If no token is returned, these results
2892
+ # call to this operation. If no token is returned, these results
2767
2893
  # represent the end of the list.
2768
2894
  # @return [String]
2769
2895
  #
@@ -2776,7 +2902,7 @@ module Aws::GameLift
2776
2902
  include Aws::Structure
2777
2903
  end
2778
2904
 
2779
- # Represents the input for a request action.
2905
+ # Represents the input for a request operation.
2780
2906
  #
2781
2907
  # @note When making an API call, you may pass DescribeGameSessionPlacementInput
2782
2908
  # data as a hash:
@@ -2797,7 +2923,7 @@ module Aws::GameLift
2797
2923
  include Aws::Structure
2798
2924
  end
2799
2925
 
2800
- # Represents the returned data in response to a request action.
2926
+ # Represents the returned data in response to a request operation.
2801
2927
  #
2802
2928
  # @!attribute [rw] game_session_placement
2803
2929
  # Object that describes the requested game session placement.
@@ -2811,7 +2937,7 @@ module Aws::GameLift
2811
2937
  include Aws::Structure
2812
2938
  end
2813
2939
 
2814
- # Represents the input for a request action.
2940
+ # Represents the input for a request operation.
2815
2941
  #
2816
2942
  # @note When making an API call, you may pass DescribeGameSessionQueuesInput
2817
2943
  # data as a hash:
@@ -2830,14 +2956,15 @@ module Aws::GameLift
2830
2956
  #
2831
2957
  # @!attribute [rw] limit
2832
2958
  # The maximum number of results to return. Use this parameter with
2833
- # `NextToken` to get results as a set of sequential pages.
2959
+ # `NextToken` to get results as a set of sequential pages. You can
2960
+ # request up to 50 results.
2834
2961
  # @return [Integer]
2835
2962
  #
2836
2963
  # @!attribute [rw] next_token
2837
2964
  # A token that indicates the start of the next sequential page of
2838
2965
  # results. Use the token that is returned with a previous call to this
2839
- # action. To start at the beginning of the result set, do not specify
2840
- # a value.
2966
+ # operation. To start at the beginning of the result set, do not
2967
+ # specify a value.
2841
2968
  # @return [String]
2842
2969
  #
2843
2970
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionQueuesInput AWS API Documentation
@@ -2850,7 +2977,7 @@ module Aws::GameLift
2850
2977
  include Aws::Structure
2851
2978
  end
2852
2979
 
2853
- # Represents the returned data in response to a request action.
2980
+ # Represents the returned data in response to a request operation.
2854
2981
  #
2855
2982
  # @!attribute [rw] game_session_queues
2856
2983
  # A collection of objects that describe the requested game session
@@ -2859,7 +2986,7 @@ module Aws::GameLift
2859
2986
  #
2860
2987
  # @!attribute [rw] next_token
2861
2988
  # A token that indicates where to resume retrieving results on the
2862
- # next call to this action. If no token is returned, these results
2989
+ # next call to this operation. If no token is returned, these results
2863
2990
  # represent the end of the list.
2864
2991
  # @return [String]
2865
2992
  #
@@ -2872,7 +2999,7 @@ module Aws::GameLift
2872
2999
  include Aws::Structure
2873
3000
  end
2874
3001
 
2875
- # Represents the input for a request action.
3002
+ # Represents the input for a request operation.
2876
3003
  #
2877
3004
  # @note When making an API call, you may pass DescribeGameSessionsInput
2878
3005
  # data as a hash:
@@ -2915,8 +3042,8 @@ module Aws::GameLift
2915
3042
  # @!attribute [rw] next_token
2916
3043
  # Token that indicates the start of the next sequential page of
2917
3044
  # results. Use the token that is returned with a previous call to this
2918
- # action. To start at the beginning of the result set, do not specify
2919
- # a value.
3045
+ # operation. To start at the beginning of the result set, do not
3046
+ # specify a value.
2920
3047
  # @return [String]
2921
3048
  #
2922
3049
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeGameSessionsInput AWS API Documentation
@@ -2932,7 +3059,7 @@ module Aws::GameLift
2932
3059
  include Aws::Structure
2933
3060
  end
2934
3061
 
2935
- # Represents the returned data in response to a request action.
3062
+ # Represents the returned data in response to a request operation.
2936
3063
  #
2937
3064
  # @!attribute [rw] game_sessions
2938
3065
  # A collection of objects containing game session properties for each
@@ -2941,7 +3068,7 @@ module Aws::GameLift
2941
3068
  #
2942
3069
  # @!attribute [rw] next_token
2943
3070
  # Token that indicates where to resume retrieving results on the next
2944
- # call to this action. If no token is returned, these results
3071
+ # call to this operation. If no token is returned, these results
2945
3072
  # represent the end of the list.
2946
3073
  # @return [String]
2947
3074
  #
@@ -2954,7 +3081,7 @@ module Aws::GameLift
2954
3081
  include Aws::Structure
2955
3082
  end
2956
3083
 
2957
- # Represents the input for a request action.
3084
+ # Represents the input for a request operation.
2958
3085
  #
2959
3086
  # @note When making an API call, you may pass DescribeInstancesInput
2960
3087
  # data as a hash:
@@ -2984,8 +3111,8 @@ module Aws::GameLift
2984
3111
  # @!attribute [rw] next_token
2985
3112
  # Token that indicates the start of the next sequential page of
2986
3113
  # results. Use the token that is returned with a previous call to this
2987
- # action. To start at the beginning of the result set, do not specify
2988
- # a value.
3114
+ # operation. To start at the beginning of the result set, do not
3115
+ # specify a value.
2989
3116
  # @return [String]
2990
3117
  #
2991
3118
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeInstancesInput AWS API Documentation
@@ -2999,7 +3126,7 @@ module Aws::GameLift
2999
3126
  include Aws::Structure
3000
3127
  end
3001
3128
 
3002
- # Represents the returned data in response to a request action.
3129
+ # Represents the returned data in response to a request operation.
3003
3130
  #
3004
3131
  # @!attribute [rw] instances
3005
3132
  # A collection of objects containing properties for each instance
@@ -3008,7 +3135,7 @@ module Aws::GameLift
3008
3135
  #
3009
3136
  # @!attribute [rw] next_token
3010
3137
  # Token that indicates where to resume retrieving results on the next
3011
- # call to this action. If no token is returned, these results
3138
+ # call to this operation. If no token is returned, these results
3012
3139
  # represent the end of the list.
3013
3140
  # @return [String]
3014
3141
  #
@@ -3021,7 +3148,7 @@ module Aws::GameLift
3021
3148
  include Aws::Structure
3022
3149
  end
3023
3150
 
3024
- # Represents the input for a request action.
3151
+ # Represents the input for a request operation.
3025
3152
  #
3026
3153
  # @note When making an API call, you may pass DescribeMatchmakingConfigurationsInput
3027
3154
  # data as a hash:
@@ -3054,8 +3181,8 @@ module Aws::GameLift
3054
3181
  # @!attribute [rw] next_token
3055
3182
  # A token that indicates the start of the next sequential page of
3056
3183
  # results. Use the token that is returned with a previous call to this
3057
- # action. To start at the beginning of the result set, do not specify
3058
- # a value.
3184
+ # operation. To start at the beginning of the result set, do not
3185
+ # specify a value.
3059
3186
  # @return [String]
3060
3187
  #
3061
3188
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeMatchmakingConfigurationsInput AWS API Documentation
@@ -3069,7 +3196,7 @@ module Aws::GameLift
3069
3196
  include Aws::Structure
3070
3197
  end
3071
3198
 
3072
- # Represents the returned data in response to a request action.
3199
+ # Represents the returned data in response to a request operation.
3073
3200
  #
3074
3201
  # @!attribute [rw] configurations
3075
3202
  # A collection of requested matchmaking configurations.
@@ -3077,7 +3204,7 @@ module Aws::GameLift
3077
3204
  #
3078
3205
  # @!attribute [rw] next_token
3079
3206
  # A token that indicates where to resume retrieving results on the
3080
- # next call to this action. If no token is returned, these results
3207
+ # next call to this operation. If no token is returned, these results
3081
3208
  # represent the end of the list.
3082
3209
  # @return [String]
3083
3210
  #
@@ -3090,7 +3217,7 @@ module Aws::GameLift
3090
3217
  include Aws::Structure
3091
3218
  end
3092
3219
 
3093
- # Represents the input for a request action.
3220
+ # Represents the input for a request operation.
3094
3221
  #
3095
3222
  # @note When making an API call, you may pass DescribeMatchmakingInput
3096
3223
  # data as a hash:
@@ -3112,7 +3239,7 @@ module Aws::GameLift
3112
3239
  include Aws::Structure
3113
3240
  end
3114
3241
 
3115
- # Represents the returned data in response to a request action.
3242
+ # Represents the returned data in response to a request operation.
3116
3243
  #
3117
3244
  # @!attribute [rw] ticket_list
3118
3245
  # A collection of existing matchmaking ticket objects matching the
@@ -3127,7 +3254,7 @@ module Aws::GameLift
3127
3254
  include Aws::Structure
3128
3255
  end
3129
3256
 
3130
- # Represents the input for a request action.
3257
+ # Represents the input for a request operation.
3131
3258
  #
3132
3259
  # @note When making an API call, you may pass DescribeMatchmakingRuleSetsInput
3133
3260
  # data as a hash:
@@ -3153,8 +3280,8 @@ module Aws::GameLift
3153
3280
  # @!attribute [rw] next_token
3154
3281
  # A token that indicates the start of the next sequential page of
3155
3282
  # results. Use the token that is returned with a previous call to this
3156
- # action. To start at the beginning of the result set, do not specify
3157
- # a value.
3283
+ # operation. To start at the beginning of the result set, do not
3284
+ # specify a value.
3158
3285
  # @return [String]
3159
3286
  #
3160
3287
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeMatchmakingRuleSetsInput AWS API Documentation
@@ -3167,7 +3294,7 @@ module Aws::GameLift
3167
3294
  include Aws::Structure
3168
3295
  end
3169
3296
 
3170
- # Represents the returned data in response to a request action.
3297
+ # Represents the returned data in response to a request operation.
3171
3298
  #
3172
3299
  # @!attribute [rw] rule_sets
3173
3300
  # A collection of requested matchmaking rule set objects.
@@ -3175,7 +3302,7 @@ module Aws::GameLift
3175
3302
  #
3176
3303
  # @!attribute [rw] next_token
3177
3304
  # A token that indicates where to resume retrieving results on the
3178
- # next call to this action. If no token is returned, these results
3305
+ # next call to this operation. If no token is returned, these results
3179
3306
  # represent the end of the list.
3180
3307
  # @return [String]
3181
3308
  #
@@ -3188,7 +3315,7 @@ module Aws::GameLift
3188
3315
  include Aws::Structure
3189
3316
  end
3190
3317
 
3191
- # Represents the input for a request action.
3318
+ # Represents the input for a request operation.
3192
3319
  #
3193
3320
  # @note When making an API call, you may pass DescribePlayerSessionsInput
3194
3321
  # data as a hash:
@@ -3243,9 +3370,9 @@ module Aws::GameLift
3243
3370
  # @!attribute [rw] next_token
3244
3371
  # Token that indicates the start of the next sequential page of
3245
3372
  # results. Use the token that is returned with a previous call to this
3246
- # action. To start at the beginning of the result set, do not specify
3247
- # a value. If a player session ID is specified, this parameter is
3248
- # ignored.
3373
+ # operation. To start at the beginning of the result set, do not
3374
+ # specify a value. If a player session ID is specified, this parameter
3375
+ # is ignored.
3249
3376
  # @return [String]
3250
3377
  #
3251
3378
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribePlayerSessionsInput AWS API Documentation
@@ -3261,7 +3388,7 @@ module Aws::GameLift
3261
3388
  include Aws::Structure
3262
3389
  end
3263
3390
 
3264
- # Represents the returned data in response to a request action.
3391
+ # Represents the returned data in response to a request operation.
3265
3392
  #
3266
3393
  # @!attribute [rw] player_sessions
3267
3394
  # A collection of objects containing properties for each player
@@ -3270,7 +3397,7 @@ module Aws::GameLift
3270
3397
  #
3271
3398
  # @!attribute [rw] next_token
3272
3399
  # Token that indicates where to resume retrieving results on the next
3273
- # call to this action. If no token is returned, these results
3400
+ # call to this operation. If no token is returned, these results
3274
3401
  # represent the end of the list.
3275
3402
  # @return [String]
3276
3403
  #
@@ -3283,7 +3410,7 @@ module Aws::GameLift
3283
3410
  include Aws::Structure
3284
3411
  end
3285
3412
 
3286
- # Represents the input for a request action.
3413
+ # Represents the input for a request operation.
3287
3414
  #
3288
3415
  # @note When making an API call, you may pass DescribeRuntimeConfigurationInput
3289
3416
  # data as a hash:
@@ -3305,7 +3432,7 @@ module Aws::GameLift
3305
3432
  include Aws::Structure
3306
3433
  end
3307
3434
 
3308
- # Represents the returned data in response to a request action.
3435
+ # Represents the returned data in response to a request operation.
3309
3436
  #
3310
3437
  # @!attribute [rw] runtime_configuration
3311
3438
  # Instructions describing how server processes should be launched and
@@ -3320,7 +3447,7 @@ module Aws::GameLift
3320
3447
  include Aws::Structure
3321
3448
  end
3322
3449
 
3323
- # Represents the input for a request action.
3450
+ # Represents the input for a request operation.
3324
3451
  #
3325
3452
  # @note When making an API call, you may pass DescribeScalingPoliciesInput
3326
3453
  # data as a hash:
@@ -3367,8 +3494,8 @@ module Aws::GameLift
3367
3494
  # @!attribute [rw] next_token
3368
3495
  # Token that indicates the start of the next sequential page of
3369
3496
  # results. Use the token that is returned with a previous call to this
3370
- # action. To start at the beginning of the result set, do not specify
3371
- # a value.
3497
+ # operation. To start at the beginning of the result set, do not
3498
+ # specify a value.
3372
3499
  # @return [String]
3373
3500
  #
3374
3501
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeScalingPoliciesInput AWS API Documentation
@@ -3382,7 +3509,7 @@ module Aws::GameLift
3382
3509
  include Aws::Structure
3383
3510
  end
3384
3511
 
3385
- # Represents the returned data in response to a request action.
3512
+ # Represents the returned data in response to a request operation.
3386
3513
  #
3387
3514
  # @!attribute [rw] scaling_policies
3388
3515
  # A collection of objects containing the scaling policies matching the
@@ -3391,7 +3518,7 @@ module Aws::GameLift
3391
3518
  #
3392
3519
  # @!attribute [rw] next_token
3393
3520
  # Token that indicates where to resume retrieving results on the next
3394
- # call to this action. If no token is returned, these results
3521
+ # call to this operation. If no token is returned, these results
3395
3522
  # represent the end of the list.
3396
3523
  # @return [String]
3397
3524
  #
@@ -3455,7 +3582,7 @@ module Aws::GameLift
3455
3582
  include Aws::Structure
3456
3583
  end
3457
3584
 
3458
- # Represents the input for a request action.
3585
+ # Represents the input for a request operation.
3459
3586
  #
3460
3587
  # @note When making an API call, you may pass DescribeVpcPeeringConnectionsInput
3461
3588
  # data as a hash:
@@ -3477,7 +3604,7 @@ module Aws::GameLift
3477
3604
  include Aws::Structure
3478
3605
  end
3479
3606
 
3480
- # Represents the returned data in response to a request action.
3607
+ # Represents the returned data in response to a request operation.
3481
3608
  #
3482
3609
  # @!attribute [rw] vpc_peering_connections
3483
3610
  # A collection of VPC peering connection records that match the
@@ -3955,24 +4082,13 @@ module Aws::GameLift
3955
4082
  # @return [Array<String>]
3956
4083
  #
3957
4084
  # @!attribute [rw] stopped_actions
3958
- # List of fleet actions that have been suspended using
4085
+ # List of fleet activity that have been suspended using
3959
4086
  # StopFleetActions. This includes auto-scaling.
3960
4087
  # @return [Array<String>]
3961
4088
  #
3962
4089
  # @!attribute [rw] instance_role_arn
3963
4090
  # A unique identifier for an AWS IAM role that manages access to your
3964
- # AWS services. With an instance role ARN set, any application that
3965
- # runs on an instance in this fleet can assume the role, including
3966
- # install scripts, server processes, and daemons (background
3967
- # processes). Create a role or look up a role's ARN from the [IAM
3968
- # dashboard][1] in the AWS Management Console. Learn more about using
3969
- # on-box credentials for your game servers at [ Access external
3970
- # resources from a game server][2].
3971
- #
3972
- #
3973
- #
3974
- # [1]: https://console.aws.amazon.com/iam/
3975
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
4091
+ # AWS services.
3976
4092
  # @return [String]
3977
4093
  #
3978
4094
  # @!attribute [rw] certificate_configuration
@@ -4160,17 +4276,31 @@ module Aws::GameLift
4160
4276
  include Aws::Structure
4161
4277
  end
4162
4278
 
4163
- # **This data type is part of Amazon GameLift FleetIQ with game server
4164
- # groups, which is in preview release and is subject to change.**
4279
+ # **This data type is used with the Amazon GameLift FleetIQ and game
4280
+ # server groups.**
4281
+ #
4282
+ # Properties describing a game server that is running on an instance in
4283
+ # a GameServerGroup.
4284
+ #
4285
+ # A game server is created by a successful call to `RegisterGameServer`
4286
+ # and deleted by calling `DeregisterGameServer`. A game server is
4287
+ # claimed to host a game session by calling `ClaimGameServer`.
4165
4288
  #
4166
- # Properties describing a game server resource.
4289
+ # * RegisterGameServer
4167
4290
  #
4168
- # A game server resource is created by a successful call to
4169
- # RegisterGameServer and deleted by calling DeregisterGameServer.
4291
+ # * ListGameServers
4292
+ #
4293
+ # * ClaimGameServer
4294
+ #
4295
+ # * DescribeGameServer
4296
+ #
4297
+ # * UpdateGameServer
4298
+ #
4299
+ # * DeregisterGameServer
4170
4300
  #
4171
4301
  # @!attribute [rw] game_server_group_name
4172
- # The name identifier for the game server group where the game server
4173
- # is located.
4302
+ # A unique identifier for the game server group where the game server
4303
+ # is running. Use either the GameServerGroup name or ARN value.
4174
4304
  # @return [String]
4175
4305
  #
4176
4306
  # @!attribute [rw] game_server_group_arn
@@ -4186,7 +4316,8 @@ module Aws::GameLift
4186
4316
  #
4187
4317
  # @!attribute [rw] instance_id
4188
4318
  # The unique identifier for the instance where the game server is
4189
- # located.
4319
+ # running. This ID is available in the instance metadata. EC2 instance
4320
+ # IDs use a 17-character format, for example: `i-1234567890abcdef0`.
4190
4321
  # @return [String]
4191
4322
  #
4192
4323
  # @!attribute [rw] connection_info
@@ -4196,24 +4327,17 @@ module Aws::GameLift
4196
4327
  #
4197
4328
  # @!attribute [rw] game_server_data
4198
4329
  # A set of custom game server properties, formatted as a single string
4199
- # value. This data is passed to a game client or service in response
4200
- # to requests ListGameServers or ClaimGameServer. This property can be
4201
- # updated using UpdateGameServer.
4202
- # @return [String]
4203
- #
4204
- # @!attribute [rw] custom_sort_key
4205
- # A game server tag that can be used to request sorted lists of game
4206
- # servers when calling ListGameServers. Custom sort keys are
4207
- # developer-defined. This property can be updated using
4208
- # UpdateGameServer.
4330
+ # value. This data is passed to a game client or service when it
4331
+ # requests information on game servers using ListGameServers or
4332
+ # ClaimGameServer.
4209
4333
  # @return [String]
4210
4334
  #
4211
4335
  # @!attribute [rw] claim_status
4212
- # Indicates when an available game server has been reserved but has
4213
- # not yet started hosting a game. Once it is claimed, game server
4214
- # remains in CLAIMED status for a maximum of one minute. During this
4215
- # time, game clients must connect to the game server and start the
4216
- # game, which triggers the game server to update its utilization
4336
+ # Indicates when an available game server has been reserved for
4337
+ # gameplay but has not yet started hosting a game. Once it is claimed,
4338
+ # the game server remains in `CLAIMED` status for a maximum of one
4339
+ # minute. During this time, game clients connect to the game server to
4340
+ # start the game and trigger the game server to update its utilization
4217
4341
  # status. After one minute, the game server claim status reverts to
4218
4342
  # null.
4219
4343
  # @return [String]
@@ -4222,32 +4346,33 @@ module Aws::GameLift
4222
4346
  # Indicates whether the game server is currently available for new
4223
4347
  # games or is busy. Possible statuses include:
4224
4348
  #
4225
- # * AVAILABLE - The game server is available to be claimed. A game
4349
+ # * `AVAILABLE` - The game server is available to be claimed. A game
4226
4350
  # server that has been claimed remains in this status until it
4227
4351
  # reports game hosting activity.
4228
4352
  #
4229
- # * IN\_USE - The game server is currently hosting a game session with
4230
- # players.
4353
+ # * `UTILIZED` - The game server is currently hosting a game session
4354
+ # with players.
4231
4355
  # @return [String]
4232
4356
  #
4233
4357
  # @!attribute [rw] registration_time
4234
- # Time stamp indicating when the game server resource was created with
4235
- # a RegisterGameServer request. Format is a number expressed in Unix
4236
- # time as milliseconds (for example "1469498468.057").
4358
+ # Timestamp that indicates when the game server was created with a
4359
+ # RegisterGameServer request. The format is a number expressed in Unix
4360
+ # time as milliseconds (for example `"1469498468.057"`).
4237
4361
  # @return [Time]
4238
4362
  #
4239
4363
  # @!attribute [rw] last_claim_time
4240
- # Time stamp indicating the last time the game server was claimed with
4241
- # a ClaimGameServer request. Format is a number expressed in Unix time
4242
- # as milliseconds (for example "1469498468.057"). This value is used
4243
- # to calculate when the game server's claim status.
4364
+ # Timestamp that indicates the last time the game server was claimed
4365
+ # with a ClaimGameServer request. The format is a number expressed in
4366
+ # Unix time as milliseconds (for example `"1469498468.057"`). This
4367
+ # value is used to calculate when a claimed game server's status
4368
+ # should revert to null.
4244
4369
  # @return [Time]
4245
4370
  #
4246
4371
  # @!attribute [rw] last_health_check_time
4247
- # Time stamp indicating the last time the game server was updated with
4248
- # health status using an UpdateGameServer request. Format is a number
4249
- # expressed in Unix time as milliseconds (for example
4250
- # "1469498468.057"). After game server registration, this property
4372
+ # Timestamp that indicates the last time the game server was updated
4373
+ # with health status using an UpdateGameServer request. The format is
4374
+ # a number expressed in Unix time as milliseconds (for example
4375
+ # `"1469498468.057"`). After game server registration, this property
4251
4376
  # is only changed when a game server update specifies a health check
4252
4377
  # value.
4253
4378
  # @return [Time]
@@ -4261,7 +4386,6 @@ module Aws::GameLift
4261
4386
  :instance_id,
4262
4387
  :connection_info,
4263
4388
  :game_server_data,
4264
- :custom_sort_key,
4265
4389
  :claim_status,
4266
4390
  :utilization_status,
4267
4391
  :registration_time,
@@ -4271,21 +4395,38 @@ module Aws::GameLift
4271
4395
  include Aws::Structure
4272
4396
  end
4273
4397
 
4274
- # **This data type is part of Amazon GameLift FleetIQ with game server
4275
- # groups, which is in preview release and is subject to change.**
4398
+ # **This data type is used with the Amazon GameLift FleetIQ and game
4399
+ # server groups.**
4276
4400
  #
4277
- # Properties describing a game server group resource. A game server
4278
- # group manages certain properties of a corresponding EC2 Auto Scaling
4279
- # group.
4401
+ # Properties that describe a game server group resource. A game server
4402
+ # group manages certain properties related to a corresponding EC2 Auto
4403
+ # Scaling group.
4280
4404
  #
4281
4405
  # A game server group is created by a successful call to
4282
- # CreateGameServerGroup and deleted by calling DeleteGameServerGroup.
4283
- # Game server group activity can be temporarily suspended and resumed by
4284
- # calling SuspendGameServerGroup and ResumeGameServerGroup.
4406
+ # `CreateGameServerGroup` and deleted by calling
4407
+ # `DeleteGameServerGroup`. Game server group activity can be temporarily
4408
+ # suspended and resumed by calling `SuspendGameServerGroup` and
4409
+ # `ResumeGameServerGroup`, respectively.
4410
+ #
4411
+ # * CreateGameServerGroup
4412
+ #
4413
+ # * ListGameServerGroups
4414
+ #
4415
+ # * DescribeGameServerGroup
4416
+ #
4417
+ # * UpdateGameServerGroup
4418
+ #
4419
+ # * DeleteGameServerGroup
4420
+ #
4421
+ # * ResumeGameServerGroup
4422
+ #
4423
+ # * SuspendGameServerGroup
4424
+ #
4425
+ # * DescribeGameServerInstances
4285
4426
  #
4286
4427
  # @!attribute [rw] game_server_group_name
4287
4428
  # A developer-defined identifier for the game server group. The name
4288
- # is unique per Region per AWS account.
4429
+ # is unique for each Region in each AWS account.
4289
4430
  # @return [String]
4290
4431
  #
4291
4432
  # @!attribute [rw] game_server_group_arn
@@ -4294,9 +4435,7 @@ module Aws::GameLift
4294
4435
  #
4295
4436
  # @!attribute [rw] role_arn
4296
4437
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows
4297
- # Amazon GameLift to access your EC2 Auto Scaling groups. The
4298
- # submitted role is validated to ensure that it contains the necessary
4299
- # permissions for game server groups.
4438
+ # Amazon GameLift to access your EC2 Auto Scaling groups.
4300
4439
  #
4301
4440
  #
4302
4441
  #
@@ -4305,40 +4444,47 @@ module Aws::GameLift
4305
4444
  #
4306
4445
  # @!attribute [rw] instance_definitions
4307
4446
  # The set of EC2 instance types that GameLift FleetIQ can use when
4308
- # rebalancing and autoscaling instances in the group.
4447
+ # balancing and automatically scaling instances in the corresponding
4448
+ # Auto Scaling group.
4309
4449
  # @return [Array<Types::InstanceDefinition>]
4310
4450
  #
4311
4451
  # @!attribute [rw] balancing_strategy
4312
- # The fallback balancing method to use for the game server group when
4313
- # Spot instances in a Region become unavailable or are not viable for
4314
- # game hosting. Once triggered, this method remains active until Spot
4315
- # instances can once again be used. Method options include:
4452
+ # Indicates how GameLift FleetIQ balances the use of Spot Instances
4453
+ # and On-Demand Instances in the game server group. Method options
4454
+ # include the following:
4455
+ #
4456
+ # * `SPOT_ONLY` - Only Spot Instances are used in the game server
4457
+ # group. If Spot Instances are unavailable or not viable for game
4458
+ # hosting, the game server group provides no hosting capacity until
4459
+ # Spot Instances can again be used. Until then, no new instances are
4460
+ # started, and the existing nonviable Spot Instances are terminated
4461
+ # (after current gameplay ends) and are not replaced.
4316
4462
  #
4317
- # * SPOT\_ONLY -- If Spot instances are unavailable, the game server
4318
- # group provides no hosting capacity. No new instances are started,
4319
- # and the existing nonviable Spot instances are terminated (once
4320
- # current gameplay ends) and not replaced.
4463
+ # * `SPOT_PREFERRED` - (default value) Spot Instances are used
4464
+ # whenever available in the game server group. If Spot Instances are
4465
+ # unavailable, the game server group continues to provide hosting
4466
+ # capacity by falling back to On-Demand Instances. Existing
4467
+ # nonviable Spot Instances are terminated (after current gameplay
4468
+ # ends) and are replaced with new On-Demand Instances.
4321
4469
  #
4322
- # * SPOT\_PREFERRED -- If Spot instances are unavailable, the game
4323
- # server group continues to provide hosting capacity by using
4324
- # On-Demand instances. Existing nonviable Spot instances are
4325
- # terminated (once current gameplay ends) and replaced with new
4326
- # On-Demand instances.
4470
+ # * `ON_DEMAND_ONLY` - Only On-Demand Instances are used in the game
4471
+ # server group. No Spot Instances are used, even when available,
4472
+ # while this balancing strategy is in force.
4327
4473
  # @return [String]
4328
4474
  #
4329
4475
  # @!attribute [rw] game_server_protection_policy
4330
4476
  # A flag that indicates whether instances in the game server group are
4331
4477
  # protected from early termination. Unprotected instances that have
4332
- # active game servers running may be terminated during a scale-down
4478
+ # active game servers running might be terminated during a scale-down
4333
4479
  # event, causing players to be dropped from the game. Protected
4334
4480
  # instances cannot be terminated while there are active game servers
4335
4481
  # running except in the event of a forced game server group deletion
4336
- # (see DeleteGameServerGroup). An exception to this is Spot Instances,
4337
- # which may be terminated by AWS regardless of protection status.
4482
+ # (see ). An exception to this is with Spot Instances, which can be
4483
+ # terminated by AWS regardless of protection status.
4338
4484
  # @return [String]
4339
4485
  #
4340
4486
  # @!attribute [rw] auto_scaling_group_arn
4341
- # A generated unique ID for the EC2 Auto Scaling group with is
4487
+ # A generated unique ID for the EC2 Auto Scaling group that is
4342
4488
  # associated with this game server group.
4343
4489
  # @return [String]
4344
4490
  #
@@ -4346,32 +4492,32 @@ module Aws::GameLift
4346
4492
  # The current status of the game server group. Possible statuses
4347
4493
  # include:
4348
4494
  #
4349
- # * NEW - GameLift FleetIQ has validated the `CreateGameServerGroup()`
4350
- # request.
4495
+ # * `NEW` - GameLift FleetIQ has validated the
4496
+ # `CreateGameServerGroup()` request.
4351
4497
  #
4352
- # * ACTIVATING - GameLift FleetIQ is setting up a game server group,
4353
- # which includes creating an autoscaling group in your AWS account.
4498
+ # * `ACTIVATING` - GameLift FleetIQ is setting up a game server group,
4499
+ # which includes creating an Auto Scaling group in your AWS account.
4354
4500
  #
4355
- # * ACTIVE - The game server group has been successfully created.
4501
+ # * `ACTIVE` - The game server group has been successfully created.
4356
4502
  #
4357
- # * DELETE\_SCHEDULED - A request to delete the game server group has
4503
+ # * `DELETE_SCHEDULED` - A request to delete the game server group has
4358
4504
  # been received.
4359
4505
  #
4360
- # * DELETING - GameLift FleetIQ has received a valid
4506
+ # * `DELETING` - GameLift FleetIQ has received a valid
4361
4507
  # `DeleteGameServerGroup()` request and is processing it. GameLift
4362
4508
  # FleetIQ must first complete and release hosts before it deletes
4363
- # the autoscaling group and the game server group.
4509
+ # the Auto Scaling group and the game server group.
4364
4510
  #
4365
- # * DELETED - The game server group has been successfully deleted.
4511
+ # * `DELETED` - The game server group has been successfully deleted.
4366
4512
  #
4367
- # * ERROR - The asynchronous processes of activating or deleting a
4513
+ # * `ERROR` - The asynchronous processes of activating or deleting a
4368
4514
  # game server group has failed, resulting in an error state.
4369
4515
  # @return [String]
4370
4516
  #
4371
4517
  # @!attribute [rw] status_reason
4372
4518
  # Additional information about the current game server group status.
4373
- # This information may provide additional insight on groups that in
4374
- # ERROR status.
4519
+ # This information might provide additional insight on groups that are
4520
+ # in `ERROR` status.
4375
4521
  # @return [String]
4376
4522
  #
4377
4523
  # @!attribute [rw] suspended_actions
@@ -4381,13 +4527,13 @@ module Aws::GameLift
4381
4527
  # @return [Array<String>]
4382
4528
  #
4383
4529
  # @!attribute [rw] creation_time
4384
- # A time stamp indicating when this data object was created. Format is
4385
- # a number expressed in Unix time as milliseconds (for example
4386
- # "1469498468.057").
4530
+ # A timestamp that indicates when this data object was created. Format
4531
+ # is a number expressed in Unix time as milliseconds (for example
4532
+ # `"1469498468.057"`).
4387
4533
  # @return [Time]
4388
4534
  #
4389
4535
  # @!attribute [rw] last_updated_time
4390
- # A time stamp indicating when this game server group was last
4536
+ # A timestamp that indicates when this game server group was last
4391
4537
  # updated.
4392
4538
  # @return [Time]
4393
4539
  #
@@ -4410,16 +4556,16 @@ module Aws::GameLift
4410
4556
  include Aws::Structure
4411
4557
  end
4412
4558
 
4413
- # **This data type is part of Amazon GameLift FleetIQ with game server
4414
- # groups, which is in preview release and is subject to change.**
4559
+ # **This data type is used with the Amazon GameLift FleetIQ and game
4560
+ # server groups.**
4415
4561
  #
4416
- # Configuration settings for intelligent autoscaling that uses target
4417
- # tracking. An autoscaling policy can be specified when a new game
4418
- # server group is created with CreateGameServerGroup. If a group has an
4419
- # autoscaling policy, the Auto Scaling group takes action based on this
4420
- # policy, in addition to (and potentially in conflict with) any other
4421
- # autoscaling policies that are separately applied to the Auto Scaling
4422
- # group.
4562
+ # Configuration settings for intelligent automatic scaling that uses
4563
+ # target tracking. These settings are used to add an Auto Scaling policy
4564
+ # when creating the corresponding Auto Scaling group with
4565
+ # CreateGameServerGroup. After the Auto Scaling group is created, all
4566
+ # updates to Auto Scaling policies, including changing this policy and
4567
+ # adding or removing other policies, is done directly on the Auto
4568
+ # Scaling group.
4423
4569
  #
4424
4570
  # @note When making an API call, you may pass GameServerGroupAutoScalingPolicy
4425
4571
  # data as a hash:
@@ -4436,13 +4582,13 @@ module Aws::GameLift
4436
4582
  # game server processes and register with GameLift FleetIQ. Specifying
4437
4583
  # a warm-up time can be useful, particularly with game servers that
4438
4584
  # take a long time to start up, because it avoids prematurely starting
4439
- # new instances
4585
+ # new instances.
4440
4586
  # @return [Integer]
4441
4587
  #
4442
4588
  # @!attribute [rw] target_tracking_configuration
4443
4589
  # Settings for a target-based scaling policy applied to Auto Scaling
4444
4590
  # group. These settings are used to create a target-based policy that
4445
- # tracks the GameLift FleetIQ metric "PercentUtilizedGameServers"
4591
+ # tracks the GameLift FleetIQ metric `"PercentUtilizedGameServers"`
4446
4592
  # and specifies a target value for the metric. As player usage
4447
4593
  # changes, the policy triggers to adjust the game server group
4448
4594
  # capacity so that the metric returns to the target value.
@@ -4457,6 +4603,79 @@ module Aws::GameLift
4457
4603
  include Aws::Structure
4458
4604
  end
4459
4605
 
4606
+ # **This data type is used with the Amazon GameLift FleetIQ and game
4607
+ # server groups.**
4608
+ #
4609
+ # Additional properties, including status, that describe an EC2 instance
4610
+ # in a game server group. Instance configurations are set with game
4611
+ # server group properties (see `DescribeGameServerGroup` and with the
4612
+ # EC2 launch template that was used when creating the game server group.
4613
+ #
4614
+ # Retrieve game server instances for a game server group by calling
4615
+ # `DescribeGameServerInstances`.
4616
+ #
4617
+ # * CreateGameServerGroup
4618
+ #
4619
+ # * ListGameServerGroups
4620
+ #
4621
+ # * DescribeGameServerGroup
4622
+ #
4623
+ # * UpdateGameServerGroup
4624
+ #
4625
+ # * DeleteGameServerGroup
4626
+ #
4627
+ # * ResumeGameServerGroup
4628
+ #
4629
+ # * SuspendGameServerGroup
4630
+ #
4631
+ # * DescribeGameServerInstances
4632
+ #
4633
+ # @!attribute [rw] game_server_group_name
4634
+ # A developer-defined identifier for the game server group that
4635
+ # includes the game server instance. The name is unique for each
4636
+ # Region in each AWS account.
4637
+ # @return [String]
4638
+ #
4639
+ # @!attribute [rw] game_server_group_arn
4640
+ # A generated unique identifier for the game server group that
4641
+ # includes the game server instance.
4642
+ # @return [String]
4643
+ #
4644
+ # @!attribute [rw] instance_id
4645
+ # The unique identifier for the instance where the game server is
4646
+ # running. This ID is available in the instance metadata. EC2 instance
4647
+ # IDs use a 17-character format, for example: `i-1234567890abcdef0`.
4648
+ # @return [String]
4649
+ #
4650
+ # @!attribute [rw] instance_status
4651
+ # Current status of the game server instance.
4652
+ #
4653
+ # * **ACTIVE** -- The instance is viable for hosting game servers.
4654
+ #
4655
+ # * **DRAINING** -- The instance is not viable for hosting game
4656
+ # servers. Existing game servers are in the process of ending, and
4657
+ # new game servers are not started on this instance unless no other
4658
+ # resources are available. When the instance is put in DRAINING, a
4659
+ # new instance is started up to replace it. Once the instance has no
4660
+ # UTILIZED game servers, it will be terminated in favor of the new
4661
+ # instance.
4662
+ #
4663
+ # * **SPOT\_TERMINATING** -- The instance is in the process of
4664
+ # shutting down due to a Spot instance interruption. No new game
4665
+ # servers are started on this instance.
4666
+ # @return [String]
4667
+ #
4668
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameServerInstance AWS API Documentation
4669
+ #
4670
+ class GameServerInstance < Struct.new(
4671
+ :game_server_group_name,
4672
+ :game_server_group_arn,
4673
+ :instance_id,
4674
+ :instance_status)
4675
+ SENSITIVE = []
4676
+ include Aws::Structure
4677
+ end
4678
+
4460
4679
  # Properties describing a game session.
4461
4680
  #
4462
4681
  # A game session in ACTIVE status can host players. When a game session
@@ -4618,7 +4837,7 @@ module Aws::GameLift
4618
4837
  #
4619
4838
  #
4620
4839
  #
4621
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-server.html#match-server-data
4840
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data
4622
4841
  # @return [String]
4623
4842
  #
4624
4843
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSession AWS API Documentation
@@ -4646,12 +4865,12 @@ module Aws::GameLift
4646
4865
  include Aws::Structure
4647
4866
  end
4648
4867
 
4649
- # Connection information for the new game session that is created with
4650
- # matchmaking. (with StartMatchmaking). Once a match is set, the
4651
- # FlexMatch engine places the match and creates a new game session for
4652
- # it. This information, including the game session endpoint and player
4653
- # sessions for each player in the original matchmaking request, is added
4654
- # to the MatchmakingTicket, which can be retrieved by calling
4868
+ # Connection information for a new game session that is created in
4869
+ # response to a StartMatchmaking request. Once a match is made, the
4870
+ # FlexMatch engine creates a new game session for it. This information,
4871
+ # including the game session endpoint and player sessions for each
4872
+ # player in the original matchmaking request, is added to the
4873
+ # MatchmakingTicket, which can be retrieved by calling
4655
4874
  # DescribeMatchmaking.
4656
4875
  #
4657
4876
  # @!attribute [rw] game_session_arn
@@ -4916,7 +5135,7 @@ module Aws::GameLift
4916
5135
  #
4917
5136
  #
4918
5137
  #
4919
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-server.html#match-server-data
5138
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data
4920
5139
  # @return [String]
4921
5140
  #
4922
5141
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GameSessionPlacement AWS API Documentation
@@ -5059,7 +5278,7 @@ module Aws::GameLift
5059
5278
  include Aws::Structure
5060
5279
  end
5061
5280
 
5062
- # Represents the input for a request action.
5281
+ # Represents the input for a request operation.
5063
5282
  #
5064
5283
  # @note When making an API call, you may pass GetGameSessionLogUrlInput
5065
5284
  # data as a hash:
@@ -5080,7 +5299,7 @@ module Aws::GameLift
5080
5299
  include Aws::Structure
5081
5300
  end
5082
5301
 
5083
- # Represents the returned data in response to a request action.
5302
+ # Represents the returned data in response to a request operation.
5084
5303
  #
5085
5304
  # @!attribute [rw] pre_signed_url
5086
5305
  # Location of the requested game session logs, available for download.
@@ -5097,7 +5316,7 @@ module Aws::GameLift
5097
5316
  include Aws::Structure
5098
5317
  end
5099
5318
 
5100
- # Represents the input for a request action.
5319
+ # Represents the input for a request operation.
5101
5320
  #
5102
5321
  # @note When making an API call, you may pass GetInstanceAccessInput
5103
5322
  # data as a hash:
@@ -5129,7 +5348,7 @@ module Aws::GameLift
5129
5348
  include Aws::Structure
5130
5349
  end
5131
5350
 
5132
- # Represents the returned data in response to a request action.
5351
+ # Represents the returned data in response to a request operation.
5133
5352
  #
5134
5353
  # @!attribute [rw] instance_access
5135
5354
  # The connection information for a fleet instance, including IP
@@ -5300,10 +5519,11 @@ module Aws::GameLift
5300
5519
  include Aws::Structure
5301
5520
  end
5302
5521
 
5303
- # **This data type is part of Amazon GameLift FleetIQ with game server
5304
- # groups, which is in preview release and is subject to change.**
5522
+ # **This data type is used with the Amazon GameLift FleetIQ and game
5523
+ # server groups.**
5305
5524
  #
5306
- # An allowed instance type for your game server group. GameLift FleetIQ
5525
+ # An allowed instance type for a GameServerGroup. All game server groups
5526
+ # must have at least two instance types defined for it. GameLift FleetIQ
5307
5527
  # periodically evaluates each defined instance type for viability. It
5308
5528
  # then updates the Auto Scaling group with the list of viable instance
5309
5529
  # types.
@@ -5451,11 +5671,13 @@ module Aws::GameLift
5451
5671
  include Aws::Structure
5452
5672
  end
5453
5673
 
5454
- # **This data type is part of Amazon GameLift FleetIQ with game server
5455
- # groups, which is in preview release and is subject to change.**
5674
+ # **This data type is used with the Amazon GameLift FleetIQ and game
5675
+ # server groups.**
5456
5676
  #
5457
5677
  # An EC2 launch template that contains configuration settings and game
5458
5678
  # server code to be deployed to all instances in a game server group.
5679
+ # The launch template is specified when creating a new game server group
5680
+ # with CreateGameServerGroup.
5459
5681
  #
5460
5682
  # @note When making an API call, you may pass LaunchTemplateSpecification
5461
5683
  # data as a hash:
@@ -5476,9 +5698,9 @@ module Aws::GameLift
5476
5698
  #
5477
5699
  # @!attribute [rw] version
5478
5700
  # The version of the EC2 launch template to use. If no version is
5479
- # specified, the default version will be used. EC2 allows you to
5480
- # specify a default version for a launch template, if none is set, the
5481
- # default is the first version created.
5701
+ # specified, the default version will be used. With Amazon EC2, you
5702
+ # can specify a default version for a launch template. If none is set,
5703
+ # the default is the first version created.
5482
5704
  # @return [String]
5483
5705
  #
5484
5706
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/LaunchTemplateSpecification AWS API Documentation
@@ -5505,7 +5727,7 @@ module Aws::GameLift
5505
5727
  include Aws::Structure
5506
5728
  end
5507
5729
 
5508
- # Represents the input for a request action.
5730
+ # Represents the input for a request operation.
5509
5731
  #
5510
5732
  # @note When making an API call, you may pass ListAliasesInput
5511
5733
  # data as a hash:
@@ -5546,8 +5768,8 @@ module Aws::GameLift
5546
5768
  # @!attribute [rw] next_token
5547
5769
  # A token that indicates the start of the next sequential page of
5548
5770
  # results. Use the token that is returned with a previous call to this
5549
- # action. To start at the beginning of the result set, do not specify
5550
- # a value.
5771
+ # operation. To start at the beginning of the result set, do not
5772
+ # specify a value.
5551
5773
  # @return [String]
5552
5774
  #
5553
5775
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListAliasesInput AWS API Documentation
@@ -5561,7 +5783,7 @@ module Aws::GameLift
5561
5783
  include Aws::Structure
5562
5784
  end
5563
5785
 
5564
- # Represents the returned data in response to a request action.
5786
+ # Represents the returned data in response to a request operation.
5565
5787
  #
5566
5788
  # @!attribute [rw] aliases
5567
5789
  # A collection of alias resources that match the request parameters.
@@ -5569,7 +5791,7 @@ module Aws::GameLift
5569
5791
  #
5570
5792
  # @!attribute [rw] next_token
5571
5793
  # A token that indicates where to resume retrieving results on the
5572
- # next call to this action. If no token is returned, these results
5794
+ # next call to this operation. If no token is returned, these results
5573
5795
  # represent the end of the list.
5574
5796
  # @return [String]
5575
5797
  #
@@ -5582,7 +5804,7 @@ module Aws::GameLift
5582
5804
  include Aws::Structure
5583
5805
  end
5584
5806
 
5585
- # Represents the input for a request action.
5807
+ # Represents the input for a request operation.
5586
5808
  #
5587
5809
  # @note When making an API call, you may pass ListBuildsInput
5588
5810
  # data as a hash:
@@ -5619,8 +5841,8 @@ module Aws::GameLift
5619
5841
  # @!attribute [rw] next_token
5620
5842
  # Token that indicates the start of the next sequential page of
5621
5843
  # results. Use the token that is returned with a previous call to this
5622
- # action. To start at the beginning of the result set, do not specify
5623
- # a value.
5844
+ # operation. To start at the beginning of the result set, do not
5845
+ # specify a value.
5624
5846
  # @return [String]
5625
5847
  #
5626
5848
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListBuildsInput AWS API Documentation
@@ -5633,7 +5855,7 @@ module Aws::GameLift
5633
5855
  include Aws::Structure
5634
5856
  end
5635
5857
 
5636
- # Represents the returned data in response to a request action.
5858
+ # Represents the returned data in response to a request operation.
5637
5859
  #
5638
5860
  # @!attribute [rw] builds
5639
5861
  # A collection of build resources that match the request.
@@ -5641,7 +5863,7 @@ module Aws::GameLift
5641
5863
  #
5642
5864
  # @!attribute [rw] next_token
5643
5865
  # Token that indicates where to resume retrieving results on the next
5644
- # call to this action. If no token is returned, these results
5866
+ # call to this operation. If no token is returned, these results
5645
5867
  # represent the end of the list.
5646
5868
  # @return [String]
5647
5869
  #
@@ -5654,7 +5876,7 @@ module Aws::GameLift
5654
5876
  include Aws::Structure
5655
5877
  end
5656
5878
 
5657
- # Represents the input for a request action.
5879
+ # Represents the input for a request operation.
5658
5880
  #
5659
5881
  # @note When making an API call, you may pass ListFleetsInput
5660
5882
  # data as a hash:
@@ -5688,8 +5910,8 @@ module Aws::GameLift
5688
5910
  # @!attribute [rw] next_token
5689
5911
  # Token that indicates the start of the next sequential page of
5690
5912
  # results. Use the token that is returned with a previous call to this
5691
- # action. To start at the beginning of the result set, do not specify
5692
- # a value.
5913
+ # operation. To start at the beginning of the result set, do not
5914
+ # specify a value.
5693
5915
  # @return [String]
5694
5916
  #
5695
5917
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListFleetsInput AWS API Documentation
@@ -5703,7 +5925,7 @@ module Aws::GameLift
5703
5925
  include Aws::Structure
5704
5926
  end
5705
5927
 
5706
- # Represents the returned data in response to a request action.
5928
+ # Represents the returned data in response to a request operation.
5707
5929
  #
5708
5930
  # @!attribute [rw] fleet_ids
5709
5931
  # Set of fleet IDs matching the list request. You can retrieve
@@ -5714,7 +5936,7 @@ module Aws::GameLift
5714
5936
  #
5715
5937
  # @!attribute [rw] next_token
5716
5938
  # Token that indicates where to resume retrieving results on the next
5717
- # call to this action. If no token is returned, these results
5939
+ # call to this operation. If no token is returned, these results
5718
5940
  # represent the end of the list.
5719
5941
  # @return [String]
5720
5942
  #
@@ -5737,14 +5959,14 @@ module Aws::GameLift
5737
5959
  #
5738
5960
  # @!attribute [rw] limit
5739
5961
  # The maximum number of results to return. Use this parameter with
5740
- # `NextToken` to get results as a set of sequential pages.
5962
+ # `NextToken` to get results as a set of sequential segments.
5741
5963
  # @return [Integer]
5742
5964
  #
5743
5965
  # @!attribute [rw] next_token
5744
- # A token that indicates the start of the next sequential page of
5745
- # results. Use the token that is returned with a previous call to this
5746
- # action. To start at the beginning of the result set, do not specify
5747
- # a value.
5966
+ # A token that indicates the start of the next sequential segment of
5967
+ # results. Use the token returned with the previous call to this
5968
+ # operation. To start at the beginning of the result set, do not
5969
+ # specify a value.
5748
5970
  # @return [String]
5749
5971
  #
5750
5972
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListGameServerGroupsInput AWS API Documentation
@@ -5762,7 +5984,7 @@ module Aws::GameLift
5762
5984
  #
5763
5985
  # @!attribute [rw] next_token
5764
5986
  # A token that indicates where to resume retrieving results on the
5765
- # next call to this action. If no token is returned, these results
5987
+ # next call to this operation. If no token is returned, these results
5766
5988
  # represent the end of the list.
5767
5989
  # @return [String]
5768
5990
  #
@@ -5786,26 +6008,28 @@ module Aws::GameLift
5786
6008
  # }
5787
6009
  #
5788
6010
  # @!attribute [rw] game_server_group_name
5789
- # An identifier for the game server group for the game server you want
5790
- # to list. Use either the GameServerGroup name or ARN value.
6011
+ # An identifier for the game server group to retrieve a list of game
6012
+ # servers from. Use either the GameServerGroup name or ARN value.
5791
6013
  # @return [String]
5792
6014
  #
5793
6015
  # @!attribute [rw] sort_order
5794
- # Indicates how to sort the returned data based on the game servers'
5795
- # custom key sort value. If this parameter is left empty, the list of
5796
- # game servers is returned in no particular order.
6016
+ # Indicates how to sort the returned data based on game server
6017
+ # registration timestamp. Use ASCENDING to retrieve oldest game
6018
+ # servers first, or use DESCENDING to retrieve newest game servers
6019
+ # first. If this parameter is left empty, game servers are returned in
6020
+ # no particular order.
5797
6021
  # @return [String]
5798
6022
  #
5799
6023
  # @!attribute [rw] limit
5800
6024
  # The maximum number of results to return. Use this parameter with
5801
- # `NextToken` to get results as a set of sequential pages.
6025
+ # `NextToken` to get results as a set of sequential segments.
5802
6026
  # @return [Integer]
5803
6027
  #
5804
6028
  # @!attribute [rw] next_token
5805
- # A token that indicates the start of the next sequential page of
5806
- # results. Use the token that is returned with a previous call to this
5807
- # action. To start at the beginning of the result set, do not specify
5808
- # a value.
6029
+ # A token that indicates the start of the next sequential segment of
6030
+ # results. Use the token returned with the previous call to this
6031
+ # operation. To start at the beginning of the result set, do not
6032
+ # specify a value.
5809
6033
  # @return [String]
5810
6034
  #
5811
6035
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListGameServersInput AWS API Documentation
@@ -5825,7 +6049,7 @@ module Aws::GameLift
5825
6049
  #
5826
6050
  # @!attribute [rw] next_token
5827
6051
  # A token that indicates where to resume retrieving results on the
5828
- # next call to this action. If no token is returned, these results
6052
+ # next call to this operation. If no token is returned, these results
5829
6053
  # represent the end of the list.
5830
6054
  # @return [String]
5831
6055
  #
@@ -5854,8 +6078,8 @@ module Aws::GameLift
5854
6078
  # @!attribute [rw] next_token
5855
6079
  # A token that indicates the start of the next sequential page of
5856
6080
  # results. Use the token that is returned with a previous call to this
5857
- # action. To start at the beginning of the result set, do not specify
5858
- # a value.
6081
+ # operation. To start at the beginning of the result set, do not
6082
+ # specify a value.
5859
6083
  # @return [String]
5860
6084
  #
5861
6085
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListScriptsInput AWS API Documentation
@@ -5873,7 +6097,7 @@ module Aws::GameLift
5873
6097
  #
5874
6098
  # @!attribute [rw] next_token
5875
6099
  # A token that indicates where to resume retrieving results on the
5876
- # next call to this action. If no token is returned, these results
6100
+ # next call to this operation. If no token is returned, these results
5877
6101
  # represent the end of the list.
5878
6102
  # @return [String]
5879
6103
  #
@@ -5898,7 +6122,7 @@ module Aws::GameLift
5898
6122
  # identifies the GameLift resource that you want to retrieve tags for.
5899
6123
  # GameLift resource ARNs are included in the data object for the
5900
6124
  # resource, which can be retrieved by calling a List or Describe
5901
- # action for the resource type.
6125
+ # operation for the resource type.
5902
6126
  #
5903
6127
  #
5904
6128
  #
@@ -5980,9 +6204,10 @@ module Aws::GameLift
5980
6204
  # @!attribute [rw] game_session_queue_arns
5981
6205
  # Amazon Resource Name ([ARN][1]) that is assigned to a GameLift game
5982
6206
  # session queue resource and uniquely identifies it. ARNs are unique
5983
- # across all Regions. GameLift uses the listed queues when placing
5984
- # game sessions for matches that are created with this matchmaking
5985
- # configuration. Queues can be located in any Region.
6207
+ # across all Regions. Queues can be located in any Region. Queues are
6208
+ # used to start new GameLift-hosted game sessions for matches that are
6209
+ # created with this matchmaking configuration. Thais property is not
6210
+ # set when `FlexMatchMode` is set to `STANDALONE`.
5986
6211
  #
5987
6212
  #
5988
6213
  #
@@ -5997,15 +6222,18 @@ module Aws::GameLift
5997
6222
  #
5998
6223
  # @!attribute [rw] acceptance_timeout_seconds
5999
6224
  # The length of time (in seconds) to wait for players to accept a
6000
- # proposed match. If any player rejects the match or fails to accept
6001
- # before the timeout, the ticket continues to look for an acceptable
6002
- # match.
6225
+ # proposed match, if acceptance is required. If any player rejects the
6226
+ # match or fails to accept before the timeout, the tickets are
6227
+ # returned to the ticket pool and continue to be evaluated for an
6228
+ # acceptable match.
6003
6229
  # @return [Integer]
6004
6230
  #
6005
6231
  # @!attribute [rw] acceptance_required
6006
6232
  # A flag that indicates whether a match that was created with this
6007
6233
  # configuration must be accepted by the matched players. To require
6008
- # acceptance, set to TRUE.
6234
+ # acceptance, set to TRUE. When this option is enabled, matchmaking
6235
+ # tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a
6236
+ # completed potential match is waiting for player acceptance.
6009
6237
  # @return [Boolean]
6010
6238
  #
6011
6239
  # @!attribute [rw] rule_set_name
@@ -6033,7 +6261,8 @@ module Aws::GameLift
6033
6261
  # players. For example, assume that the configuration's rule set
6034
6262
  # specifies a match for a single 12-person team. If the additional
6035
6263
  # player count is set to 2, only 10 players are initially selected for
6036
- # the match.
6264
+ # the match. This parameter is not used when `FlexMatchMode` is set to
6265
+ # `STANDALONE`.
6037
6266
  # @return [Integer]
6038
6267
  #
6039
6268
  # @!attribute [rw] custom_event_data
@@ -6053,7 +6282,8 @@ module Aws::GameLift
6053
6282
  # process in the GameSession object with a request to start a new game
6054
6283
  # session (see [Start a Game Session][1]). This information is added
6055
6284
  # to the new GameSession object that is created for a successful
6056
- # match.
6285
+ # match. This parameter is not used when `FlexMatchMode` is set to
6286
+ # `STANDALONE`.
6057
6287
  #
6058
6288
  #
6059
6289
  #
@@ -6065,7 +6295,8 @@ module Aws::GameLift
6065
6295
  # string value. This data is passed to a game server process in the
6066
6296
  # GameSession object with a request to start a new game session (see
6067
6297
  # [Start a Game Session][1]). This information is added to the new
6068
- # GameSession object that is created for a successful match.
6298
+ # GameSession object that is created for a successful match. This
6299
+ # parameter is not used when `FlexMatchMode` is set to `STANDALONE`.
6069
6300
  #
6070
6301
  #
6071
6302
  #
@@ -6079,11 +6310,28 @@ module Aws::GameLift
6079
6310
  # AUTOMATIC indicates that GameLift creates StartMatchBackfill
6080
6311
  # requests whenever a game session has one or more open slots. Learn
6081
6312
  # more about manual and automatic backfill in [Backfill Existing Games
6082
- # with FlexMatch][1].
6313
+ # with FlexMatch][1]. Automatic backfill is not available when
6314
+ # `FlexMatchMode` is set to `STANDALONE`.
6083
6315
  #
6084
6316
  #
6085
6317
  #
6086
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
6318
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
6319
+ # @return [String]
6320
+ #
6321
+ # @!attribute [rw] flex_match_mode
6322
+ # Indicates whether this matchmaking configuration is being used with
6323
+ # GameLift hosting or as a standalone matchmaking solution.
6324
+ #
6325
+ # * **STANDALONE** - FlexMatch forms matches and returns match
6326
+ # information, including players and team assignments, in a [
6327
+ # MatchmakingSucceeded][1] event.
6328
+ #
6329
+ # * **WITH\_QUEUE** - FlexMatch forms matches and uses the specified
6330
+ # GameLift queue to start a game session for the match.
6331
+ #
6332
+ #
6333
+ #
6334
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded
6087
6335
  # @return [String]
6088
6336
  #
6089
6337
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/MatchmakingConfiguration AWS API Documentation
@@ -6104,7 +6352,8 @@ module Aws::GameLift
6104
6352
  :creation_time,
6105
6353
  :game_properties,
6106
6354
  :game_session_data,
6107
- :backfill_mode)
6355
+ :backfill_mode,
6356
+ :flex_match_mode)
6108
6357
  SENSITIVE = []
6109
6358
  include Aws::Structure
6110
6359
  end
@@ -6147,7 +6396,7 @@ module Aws::GameLift
6147
6396
  #
6148
6397
  #
6149
6398
  #
6150
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-rulesets.html
6399
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-rulesets.html
6151
6400
  #
6152
6401
  # @!attribute [rw] rule_set_name
6153
6402
  # A unique identifier for a matchmaking rule set
@@ -6283,7 +6532,9 @@ module Aws::GameLift
6283
6532
  # @!attribute [rw] game_session_connection_info
6284
6533
  # Identifier and connection information of the game session created
6285
6534
  # for the match. This information is added to the ticket only after
6286
- # the matchmaking request has been successfully completed.
6535
+ # the matchmaking request has been successfully completed. This
6536
+ # parameter is not set when FlexMatch is being used without GameLift
6537
+ # hosting.
6287
6538
  # @return [Types::GameSessionConnectionInfo]
6288
6539
  #
6289
6540
  # @!attribute [rw] estimated_wait_time
@@ -6658,7 +6909,7 @@ module Aws::GameLift
6658
6909
  include Aws::Structure
6659
6910
  end
6660
6911
 
6661
- # Represents the input for a request action.
6912
+ # Represents the input for a request operation.
6662
6913
  #
6663
6914
  # @note When making an API call, you may pass PutScalingPolicyInput
6664
6915
  # data as a hash:
@@ -6803,7 +7054,7 @@ module Aws::GameLift
6803
7054
  include Aws::Structure
6804
7055
  end
6805
7056
 
6806
- # Represents the returned data in response to a request action.
7057
+ # Represents the returned data in response to a request operation.
6807
7058
  #
6808
7059
  # @!attribute [rw] name
6809
7060
  # A descriptive label that is associated with a scaling policy. Policy
@@ -6827,65 +7078,38 @@ module Aws::GameLift
6827
7078
  # instance_id: "GameServerInstanceId", # required
6828
7079
  # connection_info: "GameServerConnectionInfo",
6829
7080
  # game_server_data: "GameServerData",
6830
- # custom_sort_key: "GameServerSortKey",
6831
- # tags: [
6832
- # {
6833
- # key: "TagKey", # required
6834
- # value: "TagValue", # required
6835
- # },
6836
- # ],
6837
7081
  # }
6838
7082
  #
6839
7083
  # @!attribute [rw] game_server_group_name
6840
- # An identifier for the game server group where the game server is
6841
- # running. You can use either the GameServerGroup name or ARN value.
7084
+ # A unique identifier for the game server group where the game server
7085
+ # is running. Use either the GameServerGroup name or ARN value.
6842
7086
  # @return [String]
6843
7087
  #
6844
7088
  # @!attribute [rw] game_server_id
6845
- # A custom string that uniquely identifies the new game server. Game
6846
- # server IDs are developer-defined and must be unique across all game
6847
- # server groups in your AWS account.
7089
+ # A custom string that uniquely identifies the game server to
7090
+ # register. Game server IDs are developer-defined and must be unique
7091
+ # across all game server groups in your AWS account.
6848
7092
  # @return [String]
6849
7093
  #
6850
7094
  # @!attribute [rw] instance_id
6851
7095
  # The unique identifier for the instance where the game server is
6852
- # running. This ID is available in the instance metadata.
7096
+ # running. This ID is available in the instance metadata. EC2 instance
7097
+ # IDs use a 17-character format, for example: `i-1234567890abcdef0`.
6853
7098
  # @return [String]
6854
7099
  #
6855
7100
  # @!attribute [rw] connection_info
6856
- # Information needed to make inbound client connections to the game
6857
- # server. This might include IP address and port, DNS name, etc.
7101
+ # Information that is needed to make inbound client connections to the
7102
+ # game server. This might include the IP address and port, DNS name,
7103
+ # and other information.
6858
7104
  # @return [String]
6859
7105
  #
6860
7106
  # @!attribute [rw] game_server_data
6861
7107
  # A set of custom game server properties, formatted as a single string
6862
7108
  # value. This data is passed to a game client or service when it
6863
- # requests information on a game servers using ListGameServers or
7109
+ # requests information on game servers using ListGameServers or
6864
7110
  # ClaimGameServer.
6865
7111
  # @return [String]
6866
7112
  #
6867
- # @!attribute [rw] custom_sort_key
6868
- # A game server tag that can be used to request sorted lists of game
6869
- # servers using ListGameServers. Custom sort keys are
6870
- # developer-defined based on how you want to organize the retrieved
6871
- # game server information.
6872
- # @return [String]
6873
- #
6874
- # @!attribute [rw] tags
6875
- # A list of labels to assign to the new game server resource. Tags are
6876
- # developer-defined key-value pairs. Tagging AWS resources are useful
6877
- # for resource management, access management, and cost allocation. For
6878
- # more information, see [ Tagging AWS Resources][1] in the *AWS
6879
- # General Reference*. Once the resource is created, you can use
6880
- # TagResource, UntagResource, and ListTagsForResource to add, remove,
6881
- # and view tags. The maximum tag limit may be lower than stated. See
6882
- # the AWS General Reference for actual tagging limits.
6883
- #
6884
- #
6885
- #
6886
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
6887
- # @return [Array<Types::Tag>]
6888
- #
6889
7113
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/RegisterGameServerInput AWS API Documentation
6890
7114
  #
6891
7115
  class RegisterGameServerInput < Struct.new(
@@ -6893,15 +7117,13 @@ module Aws::GameLift
6893
7117
  :game_server_id,
6894
7118
  :instance_id,
6895
7119
  :connection_info,
6896
- :game_server_data,
6897
- :custom_sort_key,
6898
- :tags)
7120
+ :game_server_data)
6899
7121
  SENSITIVE = []
6900
7122
  include Aws::Structure
6901
7123
  end
6902
7124
 
6903
7125
  # @!attribute [rw] game_server
6904
- # Object that describes the newly created game server resource.
7126
+ # Object that describes the newly registered game server.
6905
7127
  # @return [Types::GameServer]
6906
7128
  #
6907
7129
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/RegisterGameServerOutput AWS API Documentation
@@ -6912,7 +7134,7 @@ module Aws::GameLift
6912
7134
  include Aws::Structure
6913
7135
  end
6914
7136
 
6915
- # Represents the input for a request action.
7137
+ # Represents the input for a request operation.
6916
7138
  #
6917
7139
  # @note When making an API call, you may pass RequestUploadCredentialsInput
6918
7140
  # data as a hash:
@@ -6934,7 +7156,7 @@ module Aws::GameLift
6934
7156
  include Aws::Structure
6935
7157
  end
6936
7158
 
6937
- # Represents the returned data in response to a request action.
7159
+ # Represents the returned data in response to a request operation.
6938
7160
  #
6939
7161
  # @!attribute [rw] upload_credentials
6940
7162
  # AWS credentials required when uploading a game build to the storage
@@ -6956,7 +7178,7 @@ module Aws::GameLift
6956
7178
  include Aws::Structure
6957
7179
  end
6958
7180
 
6959
- # Represents the input for a request action.
7181
+ # Represents the input for a request operation.
6960
7182
  #
6961
7183
  # @note When making an API call, you may pass ResolveAliasInput
6962
7184
  # data as a hash:
@@ -6978,7 +7200,7 @@ module Aws::GameLift
6978
7200
  include Aws::Structure
6979
7201
  end
6980
7202
 
6981
- # Represents the returned data in response to a request action.
7203
+ # Represents the returned data in response to a request operation.
6982
7204
  #
6983
7205
  # @!attribute [rw] fleet_id
6984
7206
  # The fleet identifier that the alias is pointing to.
@@ -7051,12 +7273,12 @@ module Aws::GameLift
7051
7273
  # }
7052
7274
  #
7053
7275
  # @!attribute [rw] game_server_group_name
7054
- # The unique identifier of the game server group to resume activity
7055
- # on. Use either the GameServerGroup name or ARN value.
7276
+ # A unique identifier for the game server group. Use either the
7277
+ # GameServerGroup name or ARN value.
7056
7278
  # @return [String]
7057
7279
  #
7058
7280
  # @!attribute [rw] resume_actions
7059
- # The action to resume for this game server group.
7281
+ # The activity to resume for this game server group.
7060
7282
  # @return [Array<String>]
7061
7283
  #
7062
7284
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ResumeGameServerGroupInput AWS API Documentation
@@ -7070,7 +7292,7 @@ module Aws::GameLift
7070
7292
 
7071
7293
  # @!attribute [rw] game_server_group
7072
7294
  # An object that describes the game server group resource, with the
7073
- # *SuspendedActions* property updated to reflect the resumed activity.
7295
+ # `SuspendedActions` property updated to reflect the resumed activity.
7074
7296
  # @return [Types::GameServerGroup]
7075
7297
  #
7076
7298
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ResumeGameServerGroupOutput AWS API Documentation
@@ -7229,6 +7451,11 @@ module Aws::GameLift
7229
7451
  #
7230
7452
  # @!attribute [rw] bucket
7231
7453
  # An S3 bucket identifier. This is the name of the S3 bucket.
7454
+ #
7455
+ # <note markdown="1"> GameLift currently does not support uploading from S3 buckets with
7456
+ # names that contain a dot (.).
7457
+ #
7458
+ # </note>
7232
7459
  # @return [String]
7233
7460
  #
7234
7461
  # @!attribute [rw] key
@@ -7507,7 +7734,7 @@ module Aws::GameLift
7507
7734
  include Aws::Structure
7508
7735
  end
7509
7736
 
7510
- # Represents the input for a request action.
7737
+ # Represents the input for a request operation.
7511
7738
  #
7512
7739
  # @note When making an API call, you may pass SearchGameSessionsInput
7513
7740
  # data as a hash:
@@ -7609,8 +7836,8 @@ module Aws::GameLift
7609
7836
  # @!attribute [rw] next_token
7610
7837
  # Token that indicates the start of the next sequential page of
7611
7838
  # results. Use the token that is returned with a previous call to this
7612
- # action. To start at the beginning of the result set, do not specify
7613
- # a value.
7839
+ # operation. To start at the beginning of the result set, do not
7840
+ # specify a value.
7614
7841
  # @return [String]
7615
7842
  #
7616
7843
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/SearchGameSessionsInput AWS API Documentation
@@ -7626,7 +7853,7 @@ module Aws::GameLift
7626
7853
  include Aws::Structure
7627
7854
  end
7628
7855
 
7629
- # Represents the returned data in response to a request action.
7856
+ # Represents the returned data in response to a request operation.
7630
7857
  #
7631
7858
  # @!attribute [rw] game_sessions
7632
7859
  # A collection of objects containing game session properties for each
@@ -7635,7 +7862,7 @@ module Aws::GameLift
7635
7862
  #
7636
7863
  # @!attribute [rw] next_token
7637
7864
  # Token that indicates where to resume retrieving results on the next
7638
- # call to this action. If no token is returned, these results
7865
+ # call to this operation. If no token is returned, these results
7639
7866
  # represent the end of the list.
7640
7867
  # @return [String]
7641
7868
  #
@@ -7730,7 +7957,7 @@ module Aws::GameLift
7730
7957
  #
7731
7958
  class StartFleetActionsOutput < Aws::EmptyStructure; end
7732
7959
 
7733
- # Represents the input for a request action.
7960
+ # Represents the input for a request operation.
7734
7961
  #
7735
7962
  # @note When making an API call, you may pass StartGameSessionPlacementInput
7736
7963
  # data as a hash:
@@ -7832,7 +8059,7 @@ module Aws::GameLift
7832
8059
  include Aws::Structure
7833
8060
  end
7834
8061
 
7835
- # Represents the returned data in response to a request action.
8062
+ # Represents the returned data in response to a request operation.
7836
8063
  #
7837
8064
  # @!attribute [rw] game_session_placement
7838
8065
  # Object that describes the newly created game session placement. This
@@ -7848,7 +8075,7 @@ module Aws::GameLift
7848
8075
  include Aws::Structure
7849
8076
  end
7850
8077
 
7851
- # Represents the input for a request action.
8078
+ # Represents the input for a request operation.
7852
8079
  #
7853
8080
  # @note When making an API call, you may pass StartMatchBackfillInput
7854
8081
  # data as a hash:
@@ -7856,7 +8083,7 @@ module Aws::GameLift
7856
8083
  # {
7857
8084
  # ticket_id: "MatchmakingIdStringModel",
7858
8085
  # configuration_name: "MatchmakingConfigurationName", # required
7859
- # game_session_arn: "ArnStringModel", # required
8086
+ # game_session_arn: "ArnStringModel",
7860
8087
  # players: [ # required
7861
8088
  # {
7862
8089
  # player_id: "NonZeroAndMaxString",
@@ -7912,7 +8139,7 @@ module Aws::GameLift
7912
8139
  #
7913
8140
  #
7914
8141
  #
7915
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-server.html#match-server-data
8142
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data
7916
8143
  # @return [Array<Types::Player>]
7917
8144
  #
7918
8145
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/StartMatchBackfillInput AWS API Documentation
@@ -7926,7 +8153,7 @@ module Aws::GameLift
7926
8153
  include Aws::Structure
7927
8154
  end
7928
8155
 
7929
- # Represents the returned data in response to a request action.
8156
+ # Represents the returned data in response to a request operation.
7930
8157
  #
7931
8158
  # @!attribute [rw] matchmaking_ticket
7932
8159
  # Ticket representing the backfill matchmaking request. This object
@@ -7942,7 +8169,7 @@ module Aws::GameLift
7942
8169
  include Aws::Structure
7943
8170
  end
7944
8171
 
7945
- # Represents the input for a request action.
8172
+ # Represents the input for a request operation.
7946
8173
  #
7947
8174
  # @note When making an API call, you may pass StartMatchmakingInput
7948
8175
  # data as a hash:
@@ -7995,7 +8222,7 @@ module Aws::GameLift
7995
8222
  include Aws::Structure
7996
8223
  end
7997
8224
 
7998
- # Represents the returned data in response to a request action.
8225
+ # Represents the returned data in response to a request operation.
7999
8226
  #
8000
8227
  # @!attribute [rw] matchmaking_ticket
8001
8228
  # Ticket representing the matchmaking request. This object include the
@@ -8041,7 +8268,7 @@ module Aws::GameLift
8041
8268
  #
8042
8269
  class StopFleetActionsOutput < Aws::EmptyStructure; end
8043
8270
 
8044
- # Represents the input for a request action.
8271
+ # Represents the input for a request operation.
8045
8272
  #
8046
8273
  # @note When making an API call, you may pass StopGameSessionPlacementInput
8047
8274
  # data as a hash:
@@ -8062,7 +8289,7 @@ module Aws::GameLift
8062
8289
  include Aws::Structure
8063
8290
  end
8064
8291
 
8065
- # Represents the returned data in response to a request action.
8292
+ # Represents the returned data in response to a request operation.
8066
8293
  #
8067
8294
  # @!attribute [rw] game_session_placement
8068
8295
  # Object that describes the canceled game session placement, with
@@ -8077,7 +8304,7 @@ module Aws::GameLift
8077
8304
  include Aws::Structure
8078
8305
  end
8079
8306
 
8080
- # Represents the input for a request action.
8307
+ # Represents the input for a request operation.
8081
8308
  #
8082
8309
  # @note When making an API call, you may pass StopMatchmakingInput
8083
8310
  # data as a hash:
@@ -8111,12 +8338,12 @@ module Aws::GameLift
8111
8338
  # }
8112
8339
  #
8113
8340
  # @!attribute [rw] game_server_group_name
8114
- # The unique identifier of the game server group to stop activity on.
8115
- # Use either the GameServerGroup name or ARN value.
8341
+ # A unique identifier for the game server group. Use either the
8342
+ # GameServerGroup name or ARN value.
8116
8343
  # @return [String]
8117
8344
  #
8118
8345
  # @!attribute [rw] suspend_actions
8119
- # The action to suspend for this game server group.
8346
+ # The activity to suspend for this game server group.
8120
8347
  # @return [Array<String>]
8121
8348
  #
8122
8349
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/SuspendGameServerGroupInput AWS API Documentation
@@ -8130,7 +8357,7 @@ module Aws::GameLift
8130
8357
 
8131
8358
  # @!attribute [rw] game_server_group
8132
8359
  # An object that describes the game server group resource, with the
8133
- # *SuspendedActions* property updated to reflect the suspended
8360
+ # `SuspendedActions` property updated to reflect the suspended
8134
8361
  # activity.
8135
8362
  # @return [Types::GameServerGroup]
8136
8363
  #
@@ -8208,7 +8435,7 @@ module Aws::GameLift
8208
8435
  # identifies the GameLift resource that you want to assign tags to.
8209
8436
  # GameLift resource ARNs are included in the data object for the
8210
8437
  # resource, which can be retrieved by calling a List or Describe
8211
- # action for the resource type.
8438
+ # operation for the resource type.
8212
8439
  #
8213
8440
  #
8214
8441
  #
@@ -8305,15 +8532,16 @@ module Aws::GameLift
8305
8532
  include Aws::Structure
8306
8533
  end
8307
8534
 
8308
- # **This data type is part of Amazon GameLift FleetIQ with game server
8309
- # groups, which is in preview release and is subject to change.**
8535
+ # **This data type is used with the Amazon GameLift FleetIQ and game
8536
+ # server groups.**
8310
8537
  #
8311
- # Settings for a target-based scaling policy applied to Auto Scaling
8312
- # group. These settings are used to create a target-based policy that
8313
- # tracks the GameLift FleetIQ metric "PercentUtilizedGameServers" and
8314
- # specifies a target value for the metric. As player usage changes, the
8315
- # policy triggers to adjust the game server group capacity so that the
8316
- # metric returns to the target value.
8538
+ # Settings for a target-based scaling policy as part of a
8539
+ # GameServerGroupAutoScalingPolicy. These settings are used to create a
8540
+ # target-based policy that tracks the GameLift FleetIQ metric
8541
+ # `"PercentUtilizedGameServers"` and specifies a target value for the
8542
+ # metric. As player usage changes, the policy triggers to adjust the
8543
+ # game server group capacity so that the metric returns to the target
8544
+ # value.
8317
8545
  #
8318
8546
  # @note When making an API call, you may pass TargetTrackingConfiguration
8319
8547
  # data as a hash:
@@ -8392,7 +8620,7 @@ module Aws::GameLift
8392
8620
  # identifies the GameLift resource that you want to remove tags from.
8393
8621
  # GameLift resource ARNs are included in the data object for the
8394
8622
  # resource, which can be retrieved by calling a List or Describe
8395
- # action for the resource type.
8623
+ # operation for the resource type.
8396
8624
  #
8397
8625
  #
8398
8626
  #
@@ -8418,7 +8646,7 @@ module Aws::GameLift
8418
8646
  #
8419
8647
  class UntagResourceResponse < Aws::EmptyStructure; end
8420
8648
 
8421
- # Represents the input for a request action.
8649
+ # Represents the input for a request operation.
8422
8650
  #
8423
8651
  # @note When making an API call, you may pass UpdateAliasInput
8424
8652
  # data as a hash:
@@ -8464,7 +8692,7 @@ module Aws::GameLift
8464
8692
  include Aws::Structure
8465
8693
  end
8466
8694
 
8467
- # Represents the returned data in response to a request action.
8695
+ # Represents the returned data in response to a request operation.
8468
8696
  #
8469
8697
  # @!attribute [rw] alias
8470
8698
  # The updated alias resource.
@@ -8478,7 +8706,7 @@ module Aws::GameLift
8478
8706
  include Aws::Structure
8479
8707
  end
8480
8708
 
8481
- # Represents the input for a request action.
8709
+ # Represents the input for a request operation.
8482
8710
  #
8483
8711
  # @note When making an API call, you may pass UpdateBuildInput
8484
8712
  # data as a hash:
@@ -8514,7 +8742,7 @@ module Aws::GameLift
8514
8742
  include Aws::Structure
8515
8743
  end
8516
8744
 
8517
- # Represents the returned data in response to a request action.
8745
+ # Represents the returned data in response to a request operation.
8518
8746
  #
8519
8747
  # @!attribute [rw] build
8520
8748
  # The updated build resource.
@@ -8528,7 +8756,7 @@ module Aws::GameLift
8528
8756
  include Aws::Structure
8529
8757
  end
8530
8758
 
8531
- # Represents the input for a request action.
8759
+ # Represents the input for a request operation.
8532
8760
  #
8533
8761
  # @note When making an API call, you may pass UpdateFleetAttributesInput
8534
8762
  # data as a hash:
@@ -8597,7 +8825,7 @@ module Aws::GameLift
8597
8825
  include Aws::Structure
8598
8826
  end
8599
8827
 
8600
- # Represents the returned data in response to a request action.
8828
+ # Represents the returned data in response to a request operation.
8601
8829
  #
8602
8830
  # @!attribute [rw] fleet_id
8603
8831
  # A unique identifier for a fleet that was updated. Use either the
@@ -8612,7 +8840,7 @@ module Aws::GameLift
8612
8840
  include Aws::Structure
8613
8841
  end
8614
8842
 
8615
- # Represents the input for a request action.
8843
+ # Represents the input for a request operation.
8616
8844
  #
8617
8845
  # @note When making an API call, you may pass UpdateFleetCapacityInput
8618
8846
  # data as a hash:
@@ -8654,7 +8882,7 @@ module Aws::GameLift
8654
8882
  include Aws::Structure
8655
8883
  end
8656
8884
 
8657
- # Represents the returned data in response to a request action.
8885
+ # Represents the returned data in response to a request operation.
8658
8886
  #
8659
8887
  # @!attribute [rw] fleet_id
8660
8888
  # A unique identifier for a fleet that was updated.
@@ -8668,7 +8896,7 @@ module Aws::GameLift
8668
8896
  include Aws::Structure
8669
8897
  end
8670
8898
 
8671
- # Represents the input for a request action.
8899
+ # Represents the input for a request operation.
8672
8900
  #
8673
8901
  # @note When making an API call, you may pass UpdateFleetPortSettingsInput
8674
8902
  # data as a hash:
@@ -8716,7 +8944,7 @@ module Aws::GameLift
8716
8944
  include Aws::Structure
8717
8945
  end
8718
8946
 
8719
- # Represents the returned data in response to a request action.
8947
+ # Represents the returned data in response to a request operation.
8720
8948
  #
8721
8949
  # @!attribute [rw] fleet_id
8722
8950
  # A unique identifier for a fleet that was updated.
@@ -8743,19 +8971,17 @@ module Aws::GameLift
8743
8971
  # },
8744
8972
  # ],
8745
8973
  # game_server_protection_policy: "NO_PROTECTION", # accepts NO_PROTECTION, FULL_PROTECTION
8746
- # balancing_strategy: "SPOT_ONLY", # accepts SPOT_ONLY, SPOT_PREFERRED
8974
+ # balancing_strategy: "SPOT_ONLY", # accepts SPOT_ONLY, SPOT_PREFERRED, ON_DEMAND_ONLY
8747
8975
  # }
8748
8976
  #
8749
8977
  # @!attribute [rw] game_server_group_name
8750
- # The unique identifier of the game server group to update. Use either
8751
- # the GameServerGroup name or ARN value.
8978
+ # A unique identifier for the game server group. Use either the
8979
+ # GameServerGroup name or ARN value.
8752
8980
  # @return [String]
8753
8981
  #
8754
8982
  # @!attribute [rw] role_arn
8755
8983
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows
8756
- # Amazon GameLift to access your EC2 Auto Scaling groups. The
8757
- # submitted role is validated to ensure that it contains the necessary
8758
- # permissions for game server groups.
8984
+ # Amazon GameLift to access your EC2 Auto Scaling groups.
8759
8985
  #
8760
8986
  #
8761
8987
  #
@@ -8763,46 +8989,58 @@ module Aws::GameLift
8763
8989
  # @return [String]
8764
8990
  #
8765
8991
  # @!attribute [rw] instance_definitions
8766
- # An updated list of EC2 instance types to use when creating instances
8767
- # in the group. The instance definition must specify instance types
8768
- # that are supported by GameLift FleetIQ, and must include at least
8769
- # two instance types. This updated list replaces the entire current
8770
- # list of instance definitions for the game server group. For more
8771
- # information on instance types, see [EC2 Instance Types][1] in the
8772
- # *Amazon EC2 User Guide*..
8992
+ # An updated list of EC2 instance types to use in the Auto Scaling
8993
+ # group. The instance definitions must specify at least two different
8994
+ # instance types that are supported by GameLift FleetIQ. This updated
8995
+ # list replaces the entire current list of instance definitions for
8996
+ # the game server group. For more information on instance types, see
8997
+ # [EC2 Instance Types][1] in the *Amazon EC2 User Guide*. You can
8998
+ # optionally specify capacity weighting for each instance type. If no
8999
+ # weight value is specified for an instance type, it is set to the
9000
+ # default value "1". For more information about capacity weighting,
9001
+ # see [ Instance Weighting for Amazon EC2 Auto Scaling][2] in the
9002
+ # Amazon EC2 Auto Scaling User Guide.
8773
9003
  #
8774
9004
  #
8775
9005
  #
8776
9006
  # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html
9007
+ # [2]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-weighting.html
8777
9008
  # @return [Array<Types::InstanceDefinition>]
8778
9009
  #
8779
9010
  # @!attribute [rw] game_server_protection_policy
8780
9011
  # A flag that indicates whether instances in the game server group are
8781
9012
  # protected from early termination. Unprotected instances that have
8782
- # active game servers running may by terminated during a scale-down
9013
+ # active game servers running might be terminated during a scale-down
8783
9014
  # event, causing players to be dropped from the game. Protected
8784
9015
  # instances cannot be terminated while there are active game servers
8785
- # running. An exception to this is Spot Instances, which may be
9016
+ # running except in the event of a forced game server group deletion
9017
+ # (see ). An exception to this is with Spot Instances, which can be
8786
9018
  # terminated by AWS regardless of protection status. This property is
8787
- # set to NO\_PROTECTION by default.
9019
+ # set to `NO_PROTECTION` by default.
8788
9020
  # @return [String]
8789
9021
  #
8790
9022
  # @!attribute [rw] balancing_strategy
8791
- # The fallback balancing method to use for the game server group when
8792
- # Spot instances in a Region become unavailable or are not viable for
8793
- # game hosting. Once triggered, this method remains active until Spot
8794
- # instances can once again be used. Method options include:
9023
+ # Indicates how GameLift FleetIQ balances the use of Spot Instances
9024
+ # and On-Demand Instances in the game server group. Method options
9025
+ # include the following:
8795
9026
  #
8796
- # * SPOT\_ONLY -- If Spot instances are unavailable, the game server
8797
- # group provides no hosting capacity. No new instances are started,
8798
- # and the existing nonviable Spot instances are terminated (once
8799
- # current gameplay ends) and not replaced.
9027
+ # * `SPOT_ONLY` - Only Spot Instances are used in the game server
9028
+ # group. If Spot Instances are unavailable or not viable for game
9029
+ # hosting, the game server group provides no hosting capacity until
9030
+ # Spot Instances can again be used. Until then, no new instances are
9031
+ # started, and the existing nonviable Spot Instances are terminated
9032
+ # (after current gameplay ends) and are not replaced.
8800
9033
  #
8801
- # * SPOT\_PREFERRED -- If Spot instances are unavailable, the game
8802
- # server group continues to provide hosting capacity by using
8803
- # On-Demand instances. Existing nonviable Spot instances are
8804
- # terminated (once current gameplay ends) and replaced with new
8805
- # On-Demand instances.
9034
+ # * `SPOT_PREFERRED` - (default value) Spot Instances are used
9035
+ # whenever available in the game server group. If Spot Instances are
9036
+ # unavailable, the game server group continues to provide hosting
9037
+ # capacity by falling back to On-Demand Instances. Existing
9038
+ # nonviable Spot Instances are terminated (after current gameplay
9039
+ # ends) and are replaced with new On-Demand Instances.
9040
+ #
9041
+ # * `ON_DEMAND_ONLY` - Only On-Demand Instances are used in the game
9042
+ # server group. No Spot Instances are used, even when available,
9043
+ # while this balancing strategy is in force.
8806
9044
  # @return [String]
8807
9045
  #
8808
9046
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameServerGroupInput AWS API Documentation
@@ -8837,43 +9075,35 @@ module Aws::GameLift
8837
9075
  # game_server_group_name: "GameServerGroupNameOrArn", # required
8838
9076
  # game_server_id: "GameServerId", # required
8839
9077
  # game_server_data: "GameServerData",
8840
- # custom_sort_key: "GameServerSortKey",
8841
9078
  # utilization_status: "AVAILABLE", # accepts AVAILABLE, UTILIZED
8842
9079
  # health_check: "HEALTHY", # accepts HEALTHY
8843
9080
  # }
8844
9081
  #
8845
9082
  # @!attribute [rw] game_server_group_name
8846
- # An identifier for the game server group where the game server is
8847
- # running. Use either the GameServerGroup name or ARN value.
9083
+ # A unique identifier for the game server group where the game server
9084
+ # is running. Use either the GameServerGroup name or ARN value.
8848
9085
  # @return [String]
8849
9086
  #
8850
9087
  # @!attribute [rw] game_server_id
8851
- # The identifier for the game server to be updated.
9088
+ # A custom string that uniquely identifies the game server to update.
8852
9089
  # @return [String]
8853
9090
  #
8854
9091
  # @!attribute [rw] game_server_data
8855
9092
  # A set of custom game server properties, formatted as a single string
8856
9093
  # value. This data is passed to a game client or service when it
8857
- # requests information on a game servers using DescribeGameServer or
9094
+ # requests information on game servers using ListGameServers or
8858
9095
  # ClaimGameServer.
8859
9096
  # @return [String]
8860
9097
  #
8861
- # @!attribute [rw] custom_sort_key
8862
- # A game server tag that can be used to request sorted lists of game
8863
- # servers using ListGameServers. Custom sort keys are
8864
- # developer-defined based on how you want to organize the retrieved
8865
- # game server information.
8866
- # @return [String]
8867
- #
8868
9098
  # @!attribute [rw] utilization_status
8869
9099
  # Indicates whether the game server is available or is currently
8870
9100
  # hosting gameplay.
8871
9101
  # @return [String]
8872
9102
  #
8873
9103
  # @!attribute [rw] health_check
8874
- # Indicates health status of the game server. An update that
8875
- # explicitly includes this parameter updates the game server's
8876
- # *LastHealthCheckTime* time stamp.
9104
+ # Indicates health status of the game server. A request that includes
9105
+ # this parameter updates the game server's *LastHealthCheckTime*
9106
+ # timestamp.
8877
9107
  # @return [String]
8878
9108
  #
8879
9109
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameServerInput AWS API Documentation
@@ -8882,7 +9112,6 @@ module Aws::GameLift
8882
9112
  :game_server_group_name,
8883
9113
  :game_server_id,
8884
9114
  :game_server_data,
8885
- :custom_sort_key,
8886
9115
  :utilization_status,
8887
9116
  :health_check)
8888
9117
  SENSITIVE = []
@@ -8890,7 +9119,7 @@ module Aws::GameLift
8890
9119
  end
8891
9120
 
8892
9121
  # @!attribute [rw] game_server
8893
- # Object that describes the newly updated game server resource.
9122
+ # Object that describes the newly updated game server.
8894
9123
  # @return [Types::GameServer]
8895
9124
  #
8896
9125
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateGameServerOutput AWS API Documentation
@@ -8901,7 +9130,7 @@ module Aws::GameLift
8901
9130
  include Aws::Structure
8902
9131
  end
8903
9132
 
8904
- # Represents the input for a request action.
9133
+ # Represents the input for a request operation.
8905
9134
  #
8906
9135
  # @note When making an API call, you may pass UpdateGameSessionInput
8907
9136
  # data as a hash:
@@ -8955,7 +9184,7 @@ module Aws::GameLift
8955
9184
  include Aws::Structure
8956
9185
  end
8957
9186
 
8958
- # Represents the returned data in response to a request action.
9187
+ # Represents the returned data in response to a request operation.
8959
9188
  #
8960
9189
  # @!attribute [rw] game_session
8961
9190
  # The updated game session metadata.
@@ -8969,7 +9198,7 @@ module Aws::GameLift
8969
9198
  include Aws::Structure
8970
9199
  end
8971
9200
 
8972
- # Represents the input for a request action.
9201
+ # Represents the input for a request operation.
8973
9202
  #
8974
9203
  # @note When making an API call, you may pass UpdateGameSessionQueueInput
8975
9204
  # data as a hash:
@@ -9035,7 +9264,7 @@ module Aws::GameLift
9035
9264
  include Aws::Structure
9036
9265
  end
9037
9266
 
9038
- # Represents the returned data in response to a request action.
9267
+ # Represents the returned data in response to a request operation.
9039
9268
  #
9040
9269
  # @!attribute [rw] game_session_queue
9041
9270
  # An object that describes the newly updated game session queue.
@@ -9049,7 +9278,7 @@ module Aws::GameLift
9049
9278
  include Aws::Structure
9050
9279
  end
9051
9280
 
9052
- # Represents the input for a request action.
9281
+ # Represents the input for a request operation.
9053
9282
  #
9054
9283
  # @note When making an API call, you may pass UpdateMatchmakingConfigurationInput
9055
9284
  # data as a hash:
@@ -9073,6 +9302,7 @@ module Aws::GameLift
9073
9302
  # ],
9074
9303
  # game_session_data: "GameSessionData",
9075
9304
  # backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
9305
+ # flex_match_mode: "STANDALONE", # accepts STANDALONE, WITH_QUEUE
9076
9306
  # }
9077
9307
  #
9078
9308
  # @!attribute [rw] name
@@ -9088,9 +9318,10 @@ module Aws::GameLift
9088
9318
  # @!attribute [rw] game_session_queue_arns
9089
9319
  # Amazon Resource Name ([ARN][1]) that is assigned to a GameLift game
9090
9320
  # session queue resource and uniquely identifies it. ARNs are unique
9091
- # across all Regions. These queues are used when placing game sessions
9092
- # for matches that are created with this matchmaking configuration.
9093
- # Queues can be located in any Region.
9321
+ # across all Regions. Queues can be located in any Region. Queues are
9322
+ # used to start new GameLift-hosted game sessions for matches that are
9323
+ # created with this matchmaking configuration. If `FlexMatchMode` is
9324
+ # set to `STANDALONE`, do not set this parameter.
9094
9325
  #
9095
9326
  #
9096
9327
  #
@@ -9105,15 +9336,18 @@ module Aws::GameLift
9105
9336
  #
9106
9337
  # @!attribute [rw] acceptance_timeout_seconds
9107
9338
  # The length of time (in seconds) to wait for players to accept a
9108
- # proposed match. If any player rejects the match or fails to accept
9109
- # before the timeout, the ticket continues to look for an acceptable
9110
- # match.
9339
+ # proposed match, if acceptance is required. If any player rejects the
9340
+ # match or fails to accept before the timeout, the tickets are
9341
+ # returned to the ticket pool and continue to be evaluated for an
9342
+ # acceptable match.
9111
9343
  # @return [Integer]
9112
9344
  #
9113
9345
  # @!attribute [rw] acceptance_required
9114
9346
  # A flag that indicates whether a match that was created with this
9115
9347
  # configuration must be accepted by the matched players. To require
9116
- # acceptance, set to TRUE.
9348
+ # acceptance, set to TRUE. With this option enabled, matchmaking
9349
+ # tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a
9350
+ # completed potential match is waiting for player acceptance.
9117
9351
  # @return [Boolean]
9118
9352
  #
9119
9353
  # @!attribute [rw] rule_set_name
@@ -9130,7 +9364,7 @@ module Aws::GameLift
9130
9364
  #
9131
9365
  #
9132
9366
  #
9133
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
9367
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
9134
9368
  # @return [String]
9135
9369
  #
9136
9370
  # @!attribute [rw] additional_player_count
@@ -9138,7 +9372,8 @@ module Aws::GameLift
9138
9372
  # players. For example, assume that the configuration's rule set
9139
9373
  # specifies a match for a single 12-person team. If the additional
9140
9374
  # player count is set to 2, only 10 players are initially selected for
9141
- # the match.
9375
+ # the match. This parameter is not used if `FlexMatchMode` is set to
9376
+ # `STANDALONE`.
9142
9377
  # @return [Integer]
9143
9378
  #
9144
9379
  # @!attribute [rw] custom_event_data
@@ -9152,7 +9387,8 @@ module Aws::GameLift
9152
9387
  # process in the GameSession object with a request to start a new game
9153
9388
  # session (see [Start a Game Session][1]). This information is added
9154
9389
  # to the new GameSession object that is created for a successful
9155
- # match.
9390
+ # match. This parameter is not used if `FlexMatchMode` is set to
9391
+ # `STANDALONE`.
9156
9392
  #
9157
9393
  #
9158
9394
  #
@@ -9164,7 +9400,8 @@ module Aws::GameLift
9164
9400
  # string value. This data is passed to a game server process in the
9165
9401
  # GameSession object with a request to start a new game session (see
9166
9402
  # [Start a Game Session][1]). This information is added to the new
9167
- # GameSession object that is created for a successful match.
9403
+ # GameSession object that is created for a successful match. This
9404
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
9168
9405
  #
9169
9406
  #
9170
9407
  #
@@ -9178,11 +9415,28 @@ module Aws::GameLift
9178
9415
  # feature. Specify AUTOMATIC to have GameLift create a
9179
9416
  # StartMatchBackfill request whenever a game session has one or more
9180
9417
  # open slots. Learn more about manual and automatic backfill in
9181
- # [Backfill Existing Games with FlexMatch][1].
9418
+ # [Backfill Existing Games with FlexMatch][1]. Automatic backfill is
9419
+ # not available when `FlexMatchMode` is set to `STANDALONE`.
9182
9420
  #
9183
9421
  #
9184
9422
  #
9185
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
9423
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
9424
+ # @return [String]
9425
+ #
9426
+ # @!attribute [rw] flex_match_mode
9427
+ # Indicates whether this matchmaking configuration is being used with
9428
+ # GameLift hosting or as a standalone matchmaking solution.
9429
+ #
9430
+ # * **STANDALONE** - FlexMatch forms matches and returns match
9431
+ # information, including players and team assignments, in a [
9432
+ # MatchmakingSucceeded][1] event.
9433
+ #
9434
+ # * **WITH\_QUEUE** - FlexMatch forms matches and uses the specified
9435
+ # GameLift queue to start a game session for the match.
9436
+ #
9437
+ #
9438
+ #
9439
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded
9186
9440
  # @return [String]
9187
9441
  #
9188
9442
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateMatchmakingConfigurationInput AWS API Documentation
@@ -9200,12 +9454,13 @@ module Aws::GameLift
9200
9454
  :custom_event_data,
9201
9455
  :game_properties,
9202
9456
  :game_session_data,
9203
- :backfill_mode)
9457
+ :backfill_mode,
9458
+ :flex_match_mode)
9204
9459
  SENSITIVE = []
9205
9460
  include Aws::Structure
9206
9461
  end
9207
9462
 
9208
- # Represents the returned data in response to a request action.
9463
+ # Represents the returned data in response to a request operation.
9209
9464
  #
9210
9465
  # @!attribute [rw] configuration
9211
9466
  # The updated matchmaking configuration.
@@ -9219,7 +9474,7 @@ module Aws::GameLift
9219
9474
  include Aws::Structure
9220
9475
  end
9221
9476
 
9222
- # Represents the input for a request action.
9477
+ # Represents the input for a request operation.
9223
9478
  #
9224
9479
  # @note When making an API call, you may pass UpdateRuntimeConfigurationInput
9225
9480
  # data as a hash:
@@ -9264,7 +9519,7 @@ module Aws::GameLift
9264
9519
  include Aws::Structure
9265
9520
  end
9266
9521
 
9267
- # Represents the returned data in response to a request action.
9522
+ # Represents the returned data in response to a request operation.
9268
9523
  #
9269
9524
  # @!attribute [rw] runtime_configuration
9270
9525
  # The runtime configuration currently in force. If the update was
@@ -9311,15 +9566,20 @@ module Aws::GameLift
9311
9566
  # @return [String]
9312
9567
  #
9313
9568
  # @!attribute [rw] storage_location
9314
- # The location of the Amazon S3 bucket where a zipped file containing
9315
- # your Realtime scripts is stored. The storage location must specify
9316
- # the Amazon S3 bucket name, the zip file name (the "key"), and a
9317
- # role ARN that allows Amazon GameLift to access the Amazon S3 storage
9318
- # location. The S3 bucket must be in the same Region where you want to
9319
- # create a new script. By default, Amazon GameLift uploads the latest
9320
- # version of the zip file; if you have S3 object versioning turned on,
9321
- # you can use the `ObjectVersion` parameter to specify an earlier
9322
- # version.
9569
+ # The Amazon S3 location of your Realtime scripts. The storage
9570
+ # location must specify the S3 bucket name, the zip file name (the
9571
+ # "key"), and an IAM role ARN that allows Amazon GameLift to access
9572
+ # the S3 storage location. The S3 bucket must be in the same Region as
9573
+ # the script you're updating. By default, Amazon GameLift uploads the
9574
+ # latest version of the zip file; if you have S3 object versioning
9575
+ # turned on, you can use the `ObjectVersion` parameter to specify an
9576
+ # earlier version. To call this operation with a storage location, you
9577
+ # must have IAM PassRole permission. For more details on IAM roles and
9578
+ # PassRole permissions, see [ Set up a role for GameLift access][1].
9579
+ #
9580
+ #
9581
+ #
9582
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
9323
9583
  # @return [Types::S3Location]
9324
9584
  #
9325
9585
  # @!attribute [rw] zip_file
@@ -9363,7 +9623,7 @@ module Aws::GameLift
9363
9623
  include Aws::Structure
9364
9624
  end
9365
9625
 
9366
- # Represents the input for a request action.
9626
+ # Represents the input for a request operation.
9367
9627
  #
9368
9628
  # @note When making an API call, you may pass ValidateMatchmakingRuleSetInput
9369
9629
  # data as a hash:
@@ -9385,7 +9645,7 @@ module Aws::GameLift
9385
9645
  include Aws::Structure
9386
9646
  end
9387
9647
 
9388
- # Represents the returned data in response to a request action.
9648
+ # Represents the returned data in response to a request operation.
9389
9649
  #
9390
9650
  # @!attribute [rw] valid
9391
9651
  # A response indicating whether the rule set is valid.