aws-sdk-gamelift 1.52.0 → 1.55.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,7 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
30
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
+ require 'aws-sdk-core/plugins/recursion_detection.rb'
31
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
32
34
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
33
35
 
@@ -74,7 +76,9 @@ module Aws::GameLift
74
76
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
75
77
  add_plugin(Aws::Plugins::TransferEncoding)
76
78
  add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
77
80
  add_plugin(Aws::Plugins::DefaultsMode)
81
+ add_plugin(Aws::Plugins::RecursionDetection)
78
82
  add_plugin(Aws::Plugins::SignatureV4)
79
83
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
80
84
 
@@ -543,12 +547,12 @@ module Aws::GameLift
543
547
  # for a fleet that is useful when redirecting player traffic from one
544
548
  # fleet to another, such as when updating your game build.
545
549
  #
546
- # Amazon GameLift supports two types of routing strategies for aliases:
547
- # simple and terminal. A simple alias points to an active fleet. A
548
- # terminal alias is used to display messaging or link to a URL instead
549
- # of routing players to an active fleet. For example, you might use a
550
- # terminal alias when a game version is no longer supported and you want
551
- # to direct players to an upgrade site.
550
+ # Amazon Web Services supports two types of routing strategies for
551
+ # aliases: simple and terminal. A simple alias points to an active
552
+ # fleet. A terminal alias is used to display messaging or link to a URL
553
+ # instead of routing players to an active fleet. For example, you might
554
+ # use a terminal alias when a game version is no longer supported and
555
+ # you want to direct players to an upgrade site.
552
556
  #
553
557
  # To create a fleet alias, specify an alias name, routing strategy, and
554
558
  # optional description. Each simple alias can point to only one fleet,
@@ -578,12 +582,13 @@ module Aws::GameLift
578
582
  #
579
583
  # @option params [Array<Types::Tag>] :tags
580
584
  # A list of labels to assign to the new alias resource. Tags are
581
- # developer-defined key-value pairs. Tagging AWS resources are useful
582
- # for resource management, access management and cost allocation. For
583
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
584
- # Reference*. Once the resource is created, you can use TagResource,
585
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
586
- # The maximum tag limit may be lower than stated. See the AWS General
585
+ # developer-defined key-value pairs. Tagging Amazon Web Services
586
+ # resources are useful for resource management, access management and
587
+ # cost allocation. For more information, see [ Tagging Amazon Web
588
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
589
+ # Once the resource is created, you can use TagResource, UntagResource,
590
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
591
+ # limit may be lower than stated. See the Amazon Web Services General
587
592
  # Reference for actual tagging limits.
588
593
  #
589
594
  #
@@ -633,12 +638,12 @@ module Aws::GameLift
633
638
  req.send_request(options)
634
639
  end
635
640
 
636
- # Creates a new Amazon GameLift build resource for your game server
641
+ # Creates a new Amazon Web Services build resource for your game server
637
642
  # binary files. Game server binaries must be combined into a zip file
638
- # for use with Amazon GameLift.
643
+ # for use with Amazon Web Services.
639
644
  #
640
645
  # When setting up a new game build for GameLift, we recommend using the
641
- # AWS CLI command <b> <a
646
+ # Amazon Web Services CLI command <b> <a
642
647
  # href="https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html">upload-build</a>
643
648
  # </b>. This helper command combines two tasks: (1) it uploads your
644
649
  # build files from a file directory to a GameLift Amazon S3 location,
@@ -647,11 +652,11 @@ module Aws::GameLift
647
652
  # The `CreateBuild` operation can used in the following scenarios:
648
653
  #
649
654
  # * To create a new game build with build files that are in an Amazon S3
650
- # location under an AWS account that you control. To use this option,
651
- # you must first give Amazon GameLift access to the Amazon S3 bucket.
652
- # With permissions in place, call `CreateBuild` and specify a build
653
- # name, operating system, and the Amazon S3 storage location of your
654
- # game build.
655
+ # location under an Amazon Web Services account that you control. To
656
+ # use this option, you must first give Amazon Web Services access to
657
+ # the Amazon S3 bucket. With permissions in place, call `CreateBuild`
658
+ # and specify a build name, operating system, and the Amazon S3
659
+ # storage location of your game build.
655
660
  #
656
661
  # * To directly upload your build files to a GameLift Amazon S3
657
662
  # location. To use this option, first call `CreateBuild` and specify a
@@ -700,8 +705,13 @@ module Aws::GameLift
700
705
  # this parameter only when creating a build with files stored in an
701
706
  # Amazon S3 bucket that you own. The storage location must specify an
702
707
  # Amazon S3 bucket name and key. The location must also specify a role
703
- # ARN that you set up to allow Amazon GameLift to access your Amazon S3
704
- # bucket. The S3 bucket and your new build must be in the same Region.
708
+ # ARN that you set up to allow Amazon Web Services to access your Amazon
709
+ # S3 bucket. The S3 bucket and your new build must be in the same
710
+ # Region.
711
+ #
712
+ # If a `StorageLocation` is specified, the size of your file can be
713
+ # found in your Amazon S3 bucket. Amazon Web Services will report a
714
+ # `SizeOnDisk` of 0.
705
715
  #
706
716
  # @option params [String] :operating_system
707
717
  # The operating system that the game server binaries are built to run
@@ -713,12 +723,13 @@ module Aws::GameLift
713
723
  #
714
724
  # @option params [Array<Types::Tag>] :tags
715
725
  # A list of labels to assign to the new build resource. Tags are
716
- # developer-defined key-value pairs. Tagging AWS resources are useful
717
- # for resource management, access management and cost allocation. For
718
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
719
- # Reference*. Once the resource is created, you can use TagResource,
720
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
721
- # The maximum tag limit may be lower than stated. See the AWS General
726
+ # developer-defined key-value pairs. Tagging Amazon Web Services
727
+ # resources are useful for resource management, access management and
728
+ # cost allocation. For more information, see [ Tagging Amazon Web
729
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
730
+ # Once the resource is created, you can use TagResource, UntagResource,
731
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
732
+ # limit may be lower than stated. See the Amazon Web Services General
722
733
  # Reference for actual tagging limits.
723
734
  #
724
735
  #
@@ -778,21 +789,23 @@ module Aws::GameLift
778
789
  req.send_request(options)
779
790
  end
780
791
 
781
- # Creates a fleet of Amazon Elastic Compute Cloud (Amazon EC2) instances
782
- # to host your custom game server or Realtime Servers. Use this
783
- # operation to configure the computing resources for your fleet and
784
- # provide instructions for running game servers on each instance.
792
+ # Creates a fleet of Amazon Elastic Compute Cloud (Amazon Elastic
793
+ # Compute Cloud) instances to host your custom game server or Realtime
794
+ # Servers. Use this operation to configure the computing resources for
795
+ # your fleet and provide instructions for running game servers on each
796
+ # instance.
785
797
  #
786
798
  # Most GameLift fleets can deploy instances to multiple locations,
787
799
  # including the home Region (where the fleet is created) and an optional
788
- # set of remote locations. Fleets that are created in the following AWS
789
- # Regions support multiple locations: us-east-1 (N. Virginia), us-west-2
790
- # (Oregon), eu-central-1 (Frankfurt), eu-west-1 (Ireland),
791
- # ap-southeast-2 (Sydney), ap-northeast-1 (Tokyo), and ap-northeast-2
792
- # (Seoul). Fleets that are created in other GameLift Regions can deploy
793
- # instances in the fleet's home Region only. All fleet instances use
794
- # the same configuration regardless of location; however, you can adjust
795
- # capacity settings and turn auto-scaling on/off for each location.
800
+ # set of remote locations. Fleets that are created in the following
801
+ # Amazon Web Services Regions support multiple locations: us-east-1 (N.
802
+ # Virginia), us-west-2 (Oregon), eu-central-1 (Frankfurt), eu-west-1
803
+ # (Ireland), ap-southeast-2 (Sydney), ap-northeast-1 (Tokyo), and
804
+ # ap-northeast-2 (Seoul). Fleets that are created in other GameLift
805
+ # Regions can deploy instances in the fleet's home Region only. All
806
+ # fleet instances use the same configuration regardless of location;
807
+ # however, you can adjust capacity settings and turn auto-scaling on/off
808
+ # for each location.
796
809
  #
797
810
  # To create a fleet, choose the hardware for your instances, specify a
798
811
  # game server build or Realtime script to deploy, and provide a runtime
@@ -802,6 +815,12 @@ module Aws::GameLift
802
815
  # creating a multi-location fleet, provide a list of additional remote
803
816
  # locations.
804
817
  #
818
+ # If you need to debug your fleet, fetch logs, view performance metrics
819
+ # or other actions on the fleet, create the development fleet with port
820
+ # 22/3389 open. As a best practice, we recommend opening ports for
821
+ # remote access only when you need them and closing them when you're
822
+ # finished.
823
+ #
805
824
  # If successful, this operation creates a new Fleet resource and places
806
825
  # it in `NEW` status, which prompts GameLift to initiate the [fleet
807
826
  # creation workflow][1]. You can track fleet creation by checking fleet
@@ -876,11 +895,11 @@ module Aws::GameLift
876
895
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api-ref.html#gamelift-sdk-server-api-ref-dataypes-process
877
896
  #
878
897
  # @option params [required, String] :ec2_instance_type
879
- # The GameLift-supported EC2 instance type to use for all fleet
898
+ # The GameLift-supported Amazon EC2 instance type to use for all fleet
880
899
  # instances. Instance type determines the computing resources that will
881
900
  # be used to host your game servers, including CPU, memory, storage, and
882
- # networking capacity. See [Amazon EC2 Instance Types][1] for detailed
883
- # descriptions of EC2 instance types.
901
+ # networking capacity. See [Amazon Elastic Compute Cloud Instance
902
+ # Types][1] for detailed descriptions of Amazon EC2 instance types.
884
903
  #
885
904
  #
886
905
  #
@@ -925,23 +944,24 @@ module Aws::GameLift
925
944
  # of time.
926
945
  #
927
946
  # @option params [Array<String>] :metric_groups
928
- # The name of an AWS CloudWatch metric group to add this fleet to. A
929
- # metric group is used to aggregate the metrics for multiple fleets. You
930
- # can specify an existing metric group name or set a new name to create
931
- # a new metric group. A fleet can be included in only one metric group
932
- # at a time.
947
+ # The name of an Amazon Web Services CloudWatch metric group to add this
948
+ # fleet to. A metric group is used to aggregate the metrics for multiple
949
+ # fleets. You can specify an existing metric group name or set a new
950
+ # name to create a new metric group. A fleet can be included in only one
951
+ # metric group at a time.
933
952
  #
934
953
  # @option params [String] :peer_vpc_aws_account_id
935
954
  # Used when peering your GameLift fleet with a VPC, the unique
936
- # identifier for the AWS account that owns the VPC. You can find your
937
- # account ID in the AWS Management Console under account settings.
955
+ # identifier for the Amazon Web Services account that owns the VPC. You
956
+ # can find your account ID in the Amazon Web Services Management Console
957
+ # under account settings.
938
958
  #
939
959
  # @option params [String] :peer_vpc_id
940
960
  # A unique identifier for a VPC with resources to be accessed by your
941
961
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
942
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
943
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
944
- # Fleets][2].
962
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
963
+ # Services Management Console. Learn more about VPC peering in [VPC
964
+ # Peering with GameLift Fleets][2].
945
965
  #
946
966
  #
947
967
  #
@@ -959,15 +979,15 @@ module Aws::GameLift
959
979
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
960
980
  #
961
981
  # @option params [String] :instance_role_arn
962
- # A unique identifier for an AWS IAM role that manages access to your
963
- # AWS services. With an instance role ARN set, any application that runs
964
- # on an instance in this fleet can assume the role, including install
965
- # scripts, server processes, and daemons (background processes). Create
966
- # a role or look up a role's ARN by using the [IAM dashboard][1] in the
967
- # AWS Management Console. Learn more about using on-box credentials for
968
- # your game servers at [ Access external resources from a game
969
- # server][2]. This property cannot be changed after the fleet is
970
- # created.
982
+ # A unique identifier for an IAM role that manages access to your Amazon
983
+ # Web Services services. With an instance role ARN set, any application
984
+ # that runs on an instance in this fleet can assume the role, including
985
+ # install scripts, server processes, and daemons (background processes).
986
+ # Create a role or look up a role's ARN by using the [IAM dashboard][1]
987
+ # in the Amazon Web Services Management Console. Learn more about using
988
+ # on-box credentials for your game servers at [ Access external
989
+ # resources from a game server][2]. This property cannot be changed
990
+ # after the fleet is created.
971
991
  #
972
992
  #
973
993
  #
@@ -978,35 +998,33 @@ module Aws::GameLift
978
998
  # Prompts GameLift to generate a TLS/SSL certificate for the fleet. TLS
979
999
  # certificates are used for encrypting traffic between game clients and
980
1000
  # the game servers that are running on GameLift. By default, the
981
- # `CertificateConfiguration` is set to `DISABLED`. Learn more at
982
- # [Securing Client/Server Communication][1]. This property cannot be
983
- # changed after the fleet is created.
984
- #
985
- # Note: This feature requires the AWS Certificate Manager (ACM) service,
986
- # which is not available in all AWS regions. When working in a region
987
- # that does not support this feature, a fleet creation request with
988
- # certificate generation fails with a 4xx error.
1001
+ # `CertificateConfiguration` is set to `DISABLED`. This property cannot
1002
+ # be changed after the fleet is created.
989
1003
  #
990
- #
991
- #
992
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-howitworks.html#gamelift-howitworks-security
1004
+ # Note: This feature requires the Amazon Web Services Certificate
1005
+ # Manager (ACM) service, which is not available in all Amazon Web
1006
+ # Services regions. When working in a region that does not support this
1007
+ # feature, a fleet creation request with certificate generation fails
1008
+ # with a 4xx error.
993
1009
  #
994
1010
  # @option params [Array<Types::LocationConfiguration>] :locations
995
1011
  # A set of remote locations to deploy additional instances to and manage
996
1012
  # as part of the fleet. This parameter can only be used when creating
997
- # fleets in AWS Regions that support multiple locations. You can add any
998
- # GameLift-supported AWS Region as a remote location, in the form of an
999
- # AWS Region code such as `us-west-2`. To create a fleet with instances
1000
- # in the home Region only, omit this parameter.
1013
+ # fleets in Amazon Web Services Regions that support multiple locations.
1014
+ # You can add any GameLift-supported Amazon Web Services Region as a
1015
+ # remote location, in the form of an Amazon Web Services Region code
1016
+ # such as `us-west-2`. To create a fleet with instances in the home
1017
+ # Region only, omit this parameter.
1001
1018
  #
1002
1019
  # @option params [Array<Types::Tag>] :tags
1003
1020
  # A list of labels to assign to the new fleet resource. Tags are
1004
- # developer-defined key-value pairs. Tagging AWS resources are useful
1005
- # for resource management, access management and cost allocation. For
1006
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
1007
- # Reference*. Once the fleet is created, you can use TagResource,
1008
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
1009
- # The maximum tag limit may be lower than stated. See the *AWS General
1021
+ # developer-defined key-value pairs. Tagging Amazon Web Services
1022
+ # resources are useful for resource management, access management and
1023
+ # cost allocation. For more information, see [ Tagging Amazon Web
1024
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
1025
+ # Once the fleet is created, you can use TagResource, UntagResource, and
1026
+ # ListTagsForResource to add, remove, and view tags. The maximum tag
1027
+ # limit may be lower than stated. See the *Amazon Web Services General
1010
1028
  # Reference* for actual tagging limits.
1011
1029
  #
1012
1030
  #
@@ -1123,9 +1141,9 @@ module Aws::GameLift
1123
1141
  #
1124
1142
  # <note markdown="1"> This operation cannot be used with fleets that don't support remote
1125
1143
  # locations. Fleets can have multiple locations only if they reside in
1126
- # AWS Regions that support this feature (see CreateFleet for the
1127
- # complete list) and were created after the feature was released in
1128
- # March 2021.
1144
+ # Amazon Web Services Regions that support this feature (see CreateFleet
1145
+ # for the complete list) and were created after the feature was released
1146
+ # in March 2021.
1129
1147
  #
1130
1148
  # </note>
1131
1149
  #
@@ -1166,9 +1184,9 @@ module Aws::GameLift
1166
1184
  #
1167
1185
  # @option params [required, Array<Types::LocationConfiguration>] :locations
1168
1186
  # A list of locations to deploy additional instances to and manage as
1169
- # part of the fleet. You can add any GameLift-supported AWS Region as a
1170
- # remote location, in the form of an AWS Region code such as
1171
- # `us-west-2`.
1187
+ # part of the fleet. You can add any GameLift-supported Amazon Web
1188
+ # Services Region as a remote location, in the form of an Amazon Web
1189
+ # Services Region code such as `us-west-2`.
1172
1190
  #
1173
1191
  # @return [Types::CreateFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1174
1192
  #
@@ -1208,31 +1226,33 @@ module Aws::GameLift
1208
1226
  # server groups.**
1209
1227
  #
1210
1228
  # Creates a GameLift FleetIQ game server group for managing game hosting
1211
- # on a collection of Amazon EC2 instances for game hosting. This
1212
- # operation creates the game server group, creates an Auto Scaling group
1213
- # in your AWS account, and establishes a link between the two groups.
1214
- # You can view the status of your game server groups in the GameLift
1215
- # console. Game server group metrics and events are emitted to Amazon
1216
- # CloudWatch.
1229
+ # on a collection of Amazon Elastic Compute Cloud instances for game
1230
+ # hosting. This operation creates the game server group, creates an Auto
1231
+ # Scaling group in your Amazon Web Services account, and establishes a
1232
+ # link between the two groups. You can view the status of your game
1233
+ # server groups in the GameLift console. Game server group metrics and
1234
+ # events are emitted to Amazon CloudWatch.
1217
1235
  #
1218
1236
  # Before creating a new game server group, you must have the following:
1219
1237
  #
1220
- # * An Amazon EC2 launch template that specifies how to launch Amazon
1221
- # EC2 instances with your game server build. For more information, see
1222
- # [ Launching an Instance from a Launch Template][1] in the *Amazon
1223
- # EC2 User Guide*.
1238
+ # * An Amazon Elastic Compute Cloud launch template that specifies how
1239
+ # to launch Amazon Elastic Compute Cloud instances with your game
1240
+ # server build. For more information, see [ Launching an Instance from
1241
+ # a Launch Template][1] in the *Amazon Elastic Compute Cloud User
1242
+ # Guide*.
1224
1243
  #
1225
- # * An IAM role that extends limited access to your AWS account to allow
1226
- # GameLift FleetIQ to create and interact with the Auto Scaling group.
1227
- # For more information, see [Create IAM roles for cross-service
1228
- # interaction][2] in the *GameLift FleetIQ Developer Guide*.
1244
+ # * An IAM role that extends limited access to your Amazon Web Services
1245
+ # account to allow GameLift FleetIQ to create and interact with the
1246
+ # Auto Scaling group. For more information, see [Create IAM roles for
1247
+ # cross-service interaction][2] in the *GameLift FleetIQ Developer
1248
+ # Guide*.
1229
1249
  #
1230
1250
  # To create a new game server group, specify a unique group name, IAM
1231
- # role and Amazon EC2 launch template, and provide a list of instance
1232
- # types that can be used in the group. You must also set initial maximum
1233
- # and minimum limits on the group's instance count. You can optionally
1234
- # set an Auto Scaling policy with target tracking based on a GameLift
1235
- # FleetIQ metric.
1251
+ # role and Amazon Elastic Compute Cloud launch template, and provide a
1252
+ # list of instance types that can be used in the group. You must also
1253
+ # set initial maximum and minimum limits on the group's instance count.
1254
+ # You can optionally set an Auto Scaling policy with target tracking
1255
+ # based on a GameLift FleetIQ metric.
1236
1256
  #
1237
1257
  # Once the game server group and corresponding Auto Scaling group are
1238
1258
  # created, you have full access to change the Auto Scaling group's
@@ -1264,41 +1284,42 @@ module Aws::GameLift
1264
1284
  #
1265
1285
  # @option params [required, String] :game_server_group_name
1266
1286
  # An identifier for the new game server group. This value is used to
1267
- # generate unique ARN identifiers for the EC2 Auto Scaling group and the
1268
- # GameLift FleetIQ game server group. The name must be unique per Region
1269
- # per AWS account.
1287
+ # generate unique ARN identifiers for the Amazon EC2 Auto Scaling group
1288
+ # and the GameLift FleetIQ game server group. The name must be unique
1289
+ # per Region per Amazon Web Services account.
1270
1290
  #
1271
1291
  # @option params [required, String] :role_arn
1272
1292
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
1273
- # GameLift to access your EC2 Auto Scaling groups.
1293
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
1274
1294
  #
1275
1295
  #
1276
1296
  #
1277
1297
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
1278
1298
  #
1279
1299
  # @option params [required, Integer] :min_size
1280
- # The minimum number of instances allowed in the EC2 Auto Scaling group.
1281
- # During automatic scaling events, GameLift FleetIQ and EC2 do not scale
1282
- # down the group below this minimum. In production, this value should be
1283
- # set to at least 1. After the Auto Scaling group is created, update
1284
- # this value directly in the Auto Scaling group using the AWS console or
1285
- # APIs.
1300
+ # The minimum number of instances allowed in the Amazon EC2 Auto Scaling
1301
+ # group. During automatic scaling events, GameLift FleetIQ and Amazon
1302
+ # EC2 do not scale down the group below this minimum. In production,
1303
+ # this value should be set to at least 1. After the Auto Scaling group
1304
+ # is created, update this value directly in the Auto Scaling group using
1305
+ # the Amazon Web Services console or APIs.
1286
1306
  #
1287
1307
  # @option params [required, Integer] :max_size
1288
- # The maximum number of instances allowed in the EC2 Auto Scaling group.
1289
- # During automatic scaling events, GameLift FleetIQ and EC2 do not scale
1290
- # up the group above this maximum. After the Auto Scaling group is
1291
- # created, update this value directly in the Auto Scaling group using
1292
- # the AWS console or APIs.
1308
+ # The maximum number of instances allowed in the Amazon EC2 Auto Scaling
1309
+ # group. During automatic scaling events, GameLift FleetIQ and EC2 do
1310
+ # not scale up the group above this maximum. After the Auto Scaling
1311
+ # group is created, update this value directly in the Auto Scaling group
1312
+ # using the Amazon Web Services console or APIs.
1293
1313
  #
1294
1314
  # @option params [required, Types::LaunchTemplateSpecification] :launch_template
1295
- # The EC2 launch template that contains configuration settings and game
1296
- # server code to be deployed to all instances in the game server group.
1297
- # You can specify the template using either the template name or ID. For
1298
- # help with creating a launch template, see [Creating a Launch Template
1299
- # for an Auto Scaling Group][1] in the *Amazon EC2 Auto Scaling User
1300
- # Guide*. After the Auto Scaling group is created, update this value
1301
- # directly in the Auto Scaling group using the AWS console or APIs.
1315
+ # The Amazon EC2 launch template that contains configuration settings
1316
+ # and game server code to be deployed to all instances in the game
1317
+ # server group. You can specify the template using either the template
1318
+ # name or ID. For help with creating a launch template, see [Creating a
1319
+ # Launch Template for an Auto Scaling Group][1] in the *Amazon Elastic
1320
+ # Compute Cloud Auto Scaling User Guide*. After the Auto Scaling group
1321
+ # is created, update this value directly in the Auto Scaling group using
1322
+ # the Amazon Web Services console or APIs.
1302
1323
  #
1303
1324
  # <note markdown="1"> If you specify network interfaces in your launch template, you must
1304
1325
  # explicitly set the property `AssociatePublicIpAddress` to "true". If
@@ -1312,15 +1333,16 @@ module Aws::GameLift
1312
1333
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
1313
1334
  #
1314
1335
  # @option params [required, Array<Types::InstanceDefinition>] :instance_definitions
1315
- # The EC2 instance types and sizes to use in the Auto Scaling group. The
1316
- # instance definitions must specify at least two different instance
1317
- # types that are supported by GameLift FleetIQ. For more information on
1318
- # instance types, see [EC2 Instance Types][1] in the *Amazon EC2 User
1319
- # Guide*. You can optionally specify capacity weighting for each
1320
- # instance type. If no weight value is specified for an instance type,
1321
- # it is set to the default value "1". For more information about
1322
- # capacity weighting, see [ Instance Weighting for Amazon EC2 Auto
1323
- # Scaling][2] in the Amazon EC2 Auto Scaling User Guide.
1336
+ # The Amazon EC2 instance types and sizes to use in the Auto Scaling
1337
+ # group. The instance definitions must specify at least two different
1338
+ # instance types that are supported by GameLift FleetIQ. For more
1339
+ # information on instance types, see [EC2 Instance Types][1] in the
1340
+ # *Amazon Elastic Compute Cloud User Guide*. You can optionally specify
1341
+ # capacity weighting for each instance type. If no weight value is
1342
+ # specified for an instance type, it is set to the default value "1".
1343
+ # For more information about capacity weighting, see [ Instance
1344
+ # Weighting for Amazon EC2 Auto Scaling][2] in the Amazon EC2 Auto
1345
+ # Scaling User Guide.
1324
1346
  #
1325
1347
  #
1326
1348
  #
@@ -1333,7 +1355,7 @@ module Aws::GameLift
1333
1355
  # metric `"PercentUtilizedGameServers"` to maintain a buffer of idle
1334
1356
  # game servers that can immediately accommodate new games and players.
1335
1357
  # After the Auto Scaling group is created, update this value directly in
1336
- # the Auto Scaling group using the AWS console or APIs.
1358
+ # the Auto Scaling group using the Amazon Web Services console or APIs.
1337
1359
  #
1338
1360
  # @option params [String] :balancing_strategy
1339
1361
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -1366,8 +1388,8 @@ module Aws::GameLift
1366
1388
  # instances cannot be terminated while there are active game servers
1367
1389
  # running except in the event of a forced game server group deletion
1368
1390
  # (see ). An exception to this is with Spot Instances, which can be
1369
- # terminated by AWS regardless of protection status. This property is
1370
- # set to `NO_PROTECTION` by default.
1391
+ # terminated by Amazon Web Services regardless of protection status.
1392
+ # This property is set to `NO_PROTECTION` by default.
1371
1393
  #
1372
1394
  # @option params [Array<String>] :vpc_subnets
1373
1395
  # A list of virtual private cloud (VPC) subnets to use with instances in
@@ -1380,13 +1402,14 @@ module Aws::GameLift
1380
1402
  #
1381
1403
  # @option params [Array<Types::Tag>] :tags
1382
1404
  # A list of labels to assign to the new game server group resource. Tags
1383
- # are developer-defined key-value pairs. Tagging AWS resources is useful
1384
- # for resource management, access management, and cost allocation. For
1385
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
1386
- # Reference*. Once the resource is created, you can use TagResource,
1387
- # UntagResource, and ListTagsForResource to add, remove, and view tags,
1388
- # respectively. The maximum tag limit may be lower than stated. See the
1389
- # AWS General Reference for actual tagging limits.
1405
+ # are developer-defined key-value pairs. Tagging Amazon Web Services
1406
+ # resources is useful for resource management, access management, and
1407
+ # cost allocation. For more information, see [ Tagging Amazon Web
1408
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
1409
+ # Once the resource is created, you can use TagResource, UntagResource,
1410
+ # and ListTagsForResource to add, remove, and view tags, respectively.
1411
+ # The maximum tag limit may be lower than stated. See the Amazon Web
1412
+ # Services General Reference for actual tagging limits.
1390
1413
  #
1391
1414
  #
1392
1415
  #
@@ -1495,7 +1518,7 @@ module Aws::GameLift
1495
1518
  # days. To access the logs, call GetGameSessionLogUrl to download the
1496
1519
  # log files.
1497
1520
  #
1498
- # *Available in GameLift Local.*
1521
+ # *Available in Amazon Web Services Local.*
1499
1522
  #
1500
1523
  # **Learn more**
1501
1524
  #
@@ -1535,7 +1558,12 @@ module Aws::GameLift
1535
1558
  # @option params [Array<Types::GameProperty>] :game_properties
1536
1559
  # A set of custom properties for a game session, formatted as key:value
1537
1560
  # pairs. These properties are passed to a game server process in the
1538
- # GameSession object with a request to start a new game session.
1561
+ # GameSession object with a request to start a new game session (see
1562
+ # [Start a Game Session][1]).
1563
+ #
1564
+ #
1565
+ #
1566
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
1539
1567
  #
1540
1568
  # @option params [String] :creator_id
1541
1569
  # A unique identifier for a player or entity creating the game session.
@@ -1567,13 +1595,18 @@ module Aws::GameLift
1567
1595
  # @option params [String] :game_session_data
1568
1596
  # A set of custom game session properties, formatted as a single string
1569
1597
  # value. This data is passed to a game server process in the GameSession
1570
- # object with a request to start a new game session.
1598
+ # object with a request to start a new game session (see [Start a Game
1599
+ # Session][1]).
1600
+ #
1601
+ #
1602
+ #
1603
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
1571
1604
  #
1572
1605
  # @option params [String] :location
1573
1606
  # A fleet's remote location to place the new game session in. If this
1574
1607
  # parameter is not set, the new game session is placed in the fleet's
1575
- # home Region. Specify a remote location with an AWS Region code such as
1576
- # `us-west-2`.
1608
+ # home Region. Specify a remote location with an Amazon Web Services
1609
+ # Region code such as `us-west-2`.
1577
1610
  #
1578
1611
  # @return [Types::CreateGameSessionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1579
1612
  #
@@ -1640,10 +1673,10 @@ module Aws::GameLift
1640
1673
  # A game session queue is configured with a set of destinations
1641
1674
  # (GameLift fleets or aliases), which determine the locations where the
1642
1675
  # queue can place new game sessions. These destinations can span
1643
- # multiple fleet types (Spot and On-Demand), instance types, and AWS
1644
- # Regions. If the queue includes multi-location fleets, the queue is
1645
- # able to place game sessions in all of a fleet's remote locations. You
1646
- # can opt to filter out individual locations if needed.
1676
+ # multiple fleet types (Spot and On-Demand), instance types, and Amazon
1677
+ # Web Services Regions. If the queue includes multi-location fleets, the
1678
+ # queue is able to place game sessions in all of a fleet's remote
1679
+ # locations. You can opt to filter out individual locations if needed.
1647
1680
  #
1648
1681
  # The queue configuration also determines how FleetIQ selects the best
1649
1682
  # available placement for a new game session. Before searching for an
@@ -1662,26 +1695,32 @@ module Aws::GameLift
1662
1695
  #
1663
1696
  # If successful, a new `GameSessionQueue` object is returned with an
1664
1697
  # assigned queue ARN. New game session requests, which are submitted to
1665
- # the queue with StartGameSessionPlacement or StartMatchmaking,
1698
+ # queue with [StartGameSessionPlacement][1] or [StartMatchmaking][2],
1666
1699
  # reference a queue's name or ARN.
1667
1700
  #
1668
1701
  # **Learn more**
1669
1702
  #
1670
- # [ Design a game session queue][1]
1703
+ # [ Design a game session queue][3]
1671
1704
  #
1672
- # [ Create a game session queue][2]
1705
+ # [ Create a game session queue][4]
1673
1706
  #
1674
1707
  # **Related actions**
1675
1708
  #
1676
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
1677
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
1678
- # task][3]
1709
+ # [CreateGameSessionQueue][5] \| [DescribeGameSessionQueues][6] \|
1710
+ # [UpdateGameSessionQueue][7] \| [DeleteGameSessionQueue][8] \| [All
1711
+ # APIs by task][9]
1679
1712
  #
1680
1713
  #
1681
1714
  #
1682
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-design.html
1683
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html
1684
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
1715
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartGameSessionPlacement.html
1716
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartMatchmaking.html
1717
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-design.html
1718
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html
1719
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
1720
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
1721
+ # [7]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
1722
+ # [8]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
1723
+ # [9]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
1685
1724
  #
1686
1725
  # @option params [required, String] :name
1687
1726
  # A descriptive label that is associated with game session queue. Queue
@@ -1709,9 +1748,9 @@ module Aws::GameLift
1709
1748
  #
1710
1749
  # @option params [Types::FilterConfiguration] :filter_configuration
1711
1750
  # A list of locations where a queue is allowed to place new game
1712
- # sessions. Locations are specified in the form of AWS Region codes,
1713
- # such as `us-west-2`. If this parameter is not set, game sessions can
1714
- # be placed in any queue location.
1751
+ # sessions. Locations are specified in the form of Amazon Web Services
1752
+ # Region codes, such as `us-west-2`. If this parameter is not set, game
1753
+ # sessions can be placed in any queue location.
1715
1754
  #
1716
1755
  # @option params [Types::PriorityConfiguration] :priority_configuration
1717
1756
  # Custom settings to use when prioritizing destinations and locations
@@ -1735,13 +1774,14 @@ module Aws::GameLift
1735
1774
  #
1736
1775
  # @option params [Array<Types::Tag>] :tags
1737
1776
  # A list of labels to assign to the new game session queue resource.
1738
- # Tags are developer-defined key-value pairs. Tagging AWS resources are
1739
- # useful for resource management, access management and cost allocation.
1740
- # For more information, see [ Tagging AWS Resources][1] in the *AWS
1741
- # General Reference*. Once the resource is created, you can use
1742
- # TagResource, UntagResource, and ListTagsForResource to add, remove,
1743
- # and view tags. The maximum tag limit may be lower than stated. See the
1744
- # AWS General Reference for actual tagging limits.
1777
+ # Tags are developer-defined key-value pairs. Tagging Amazon Web
1778
+ # Services resources are useful for resource management, access
1779
+ # management and cost allocation. For more information, see [ Tagging
1780
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
1781
+ # Reference*. Once the resource is created, you can use TagResource,
1782
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
1783
+ # The maximum tag limit may be lower than stated. See the Amazon Web
1784
+ # Services General Reference for actual tagging limits.
1745
1785
  #
1746
1786
  #
1747
1787
  #
@@ -1832,10 +1872,10 @@ module Aws::GameLift
1832
1872
  # queue to use when starting a game session for the match.
1833
1873
  #
1834
1874
  # In addition, you must set up an Amazon Simple Notification Service
1835
- # (SNS) topic to receive matchmaking notifications. Provide the topic
1836
- # ARN in the matchmaking configuration. An alternative method,
1837
- # continuously polling ticket status with DescribeMatchmaking, is only
1838
- # suitable for games in development with low matchmaking usage.
1875
+ # topic to receive matchmaking notifications. Provide the topic ARN in
1876
+ # the matchmaking configuration. An alternative method, continuously
1877
+ # polling ticket status with DescribeMatchmaking, is only suitable for
1878
+ # games in development with low matchmaking usage.
1839
1879
  #
1840
1880
  # **Learn more**
1841
1881
  #
@@ -1976,13 +2016,14 @@ module Aws::GameLift
1976
2016
  #
1977
2017
  # @option params [Array<Types::Tag>] :tags
1978
2018
  # A list of labels to assign to the new matchmaking configuration
1979
- # resource. Tags are developer-defined key-value pairs. Tagging AWS
1980
- # resources are useful for resource management, access management and
1981
- # cost allocation. For more information, see [ Tagging AWS Resources][1]
1982
- # in the *AWS General Reference*. Once the resource is created, you can
1983
- # use TagResource, UntagResource, and ListTagsForResource to add,
1984
- # remove, and view tags. The maximum tag limit may be lower than stated.
1985
- # See the AWS General Reference for actual tagging limits.
2019
+ # resource. Tags are developer-defined key-value pairs. Tagging Amazon
2020
+ # Web Services resources are useful for resource management, access
2021
+ # management and cost allocation. For more information, see [ Tagging
2022
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
2023
+ # Reference*. Once the resource is created, you can use TagResource,
2024
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
2025
+ # The maximum tag limit may be lower than stated. See the Amazon Web
2026
+ # Services General Reference for actual tagging limits.
1986
2027
  #
1987
2028
  #
1988
2029
  #
@@ -2104,13 +2145,14 @@ module Aws::GameLift
2104
2145
  #
2105
2146
  # @option params [Array<Types::Tag>] :tags
2106
2147
  # A list of labels to assign to the new matchmaking rule set resource.
2107
- # Tags are developer-defined key-value pairs. Tagging AWS resources are
2108
- # useful for resource management, access management and cost allocation.
2109
- # For more information, see [ Tagging AWS Resources][1] in the *AWS
2110
- # General Reference*. Once the resource is created, you can use
2111
- # TagResource, UntagResource, and ListTagsForResource to add, remove,
2112
- # and view tags. The maximum tag limit may be lower than stated. See the
2113
- # AWS General Reference for actual tagging limits.
2148
+ # Tags are developer-defined key-value pairs. Tagging Amazon Web
2149
+ # Services resources are useful for resource management, access
2150
+ # management and cost allocation. For more information, see [ Tagging
2151
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
2152
+ # Reference*. Once the resource is created, you can use TagResource,
2153
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
2154
+ # The maximum tag limit may be lower than stated. See the Amazon Web
2155
+ # Services General Reference for actual tagging limits.
2114
2156
  #
2115
2157
  #
2116
2158
  #
@@ -2165,7 +2207,10 @@ module Aws::GameLift
2165
2207
  # validate the player reservation with the GameLift service. Player
2166
2208
  # sessions cannot be updated.
2167
2209
  #
2168
- # *Available in Amazon GameLift Local.*
2210
+ # The maximum number of players per game session is 200. It is not
2211
+ # adjustable.
2212
+ #
2213
+ # *Available in Amazon Web Services Local.*
2169
2214
  #
2170
2215
  # **Related actions**
2171
2216
  #
@@ -2240,7 +2285,10 @@ module Aws::GameLift
2240
2285
  # to validate the player reservation with the GameLift service. Player
2241
2286
  # sessions cannot be updated.
2242
2287
  #
2243
- # *Available in Amazon GameLift Local.*
2288
+ # The maximum number of players per game session is 200. It is not
2289
+ # adjustable.
2290
+ #
2291
+ # *Available in Amazon Web Services Local.*
2244
2292
  #
2245
2293
  # **Related actions**
2246
2294
  #
@@ -2260,10 +2308,10 @@ module Aws::GameLift
2260
2308
  #
2261
2309
  # @option params [Hash<String,String>] :player_data_map
2262
2310
  # Map of string pairs, each specifying a player ID and a set of
2263
- # developer-defined information related to the player. Amazon GameLift
2264
- # does not use this data, so it can be formatted as needed for use in
2265
- # the game. Any player data strings for player IDs that are not included
2266
- # in the `PlayerIds` parameter are ignored.
2311
+ # developer-defined information related to the player. Amazon Web
2312
+ # Services does not use this data, so it can be formatted as needed for
2313
+ # use in the game. Any player data strings for player IDs that are not
2314
+ # included in the `PlayerIds` parameter are ignored.
2267
2315
  #
2268
2316
  # @return [Types::CreatePlayerSessionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2269
2317
  #
@@ -2318,23 +2366,24 @@ module Aws::GameLift
2318
2366
  # * A locally available directory. Use the *ZipFile* parameter for this
2319
2367
  # option.
2320
2368
  #
2321
- # * An Amazon Simple Storage Service (Amazon S3) bucket under your AWS
2322
- # account. Use the *StorageLocation* parameter for this option.
2323
- # You'll need to have an Identity Access Management (IAM) role that
2324
- # allows the Amazon GameLift service to access your S3 bucket.
2369
+ # * An Amazon Simple Storage Service (Amazon S3) bucket under your
2370
+ # Amazon Web Services account. Use the *StorageLocation* parameter for
2371
+ # this option. You'll need to have an Identity Access Management
2372
+ # (IAM) role that allows the Amazon Web Services service to access
2373
+ # your S3 bucket.
2325
2374
  #
2326
2375
  # If the call is successful, a new script record is created with a
2327
2376
  # unique script ID. If the script file is provided as a local file, the
2328
- # file is uploaded to an Amazon GameLift-owned S3 bucket and the script
2329
- # record's storage location reflects this location. If the script file
2330
- # is provided as an S3 bucket, Amazon GameLift accesses the file at this
2331
- # storage location as needed for deployment.
2377
+ # file is uploaded to an Amazon Web Services-owned S3 bucket and the
2378
+ # script record's storage location reflects this location. If the
2379
+ # script file is provided as an S3 bucket, Amazon Web Services accesses
2380
+ # the file at this storage location as needed for deployment.
2332
2381
  #
2333
2382
  # **Learn more**
2334
2383
  #
2335
- # [Amazon GameLift Realtime Servers][1]
2384
+ # [Amazon Web Services Realtime Servers][1]
2336
2385
  #
2337
- # [Set Up a Role for Amazon GameLift Access][2]
2386
+ # [Set Up a Role for Amazon Web Services Access][2]
2338
2387
  #
2339
2388
  # **Related actions**
2340
2389
  #
@@ -2361,30 +2410,32 @@ module Aws::GameLift
2361
2410
  # The location of the Amazon S3 bucket where a zipped file containing
2362
2411
  # your Realtime scripts is stored. The storage location must specify the
2363
2412
  # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
2364
- # that allows Amazon GameLift to access the Amazon S3 storage location.
2365
- # The S3 bucket must be in the same Region where you want to create a
2366
- # new script. By default, Amazon GameLift uploads the latest version of
2367
- # the zip file; if you have S3 object versioning turned on, you can use
2368
- # the `ObjectVersion` parameter to specify an earlier version.
2413
+ # that allows Amazon Web Services to access the Amazon S3 storage
2414
+ # location. The S3 bucket must be in the same Region where you want to
2415
+ # create a new script. By default, Amazon Web Services uploads the
2416
+ # latest version of the zip file; if you have S3 object versioning
2417
+ # turned on, you can use the `ObjectVersion` parameter to specify an
2418
+ # earlier version.
2369
2419
  #
2370
2420
  # @option params [String, StringIO, File] :zip_file
2371
2421
  # A data object containing your Realtime scripts and dependencies as a
2372
2422
  # zip file. The zip file can have one or multiple files. Maximum size of
2373
2423
  # a zip file is 5 MB.
2374
2424
  #
2375
- # When using the AWS CLI tool to create a script, this parameter is set
2376
- # to the zip file name. It must be prepended with the string
2377
- # "fileb://" to indicate that the file data is a binary object. For
2378
- # example: `--zip-file fileb://myRealtimeScript.zip`.
2425
+ # When using the Amazon Web Services CLI tool to create a script, this
2426
+ # parameter is set to the zip file name. It must be prepended with the
2427
+ # string "fileb://" to indicate that the file data is a binary object.
2428
+ # For example: `--zip-file fileb://myRealtimeScript.zip`.
2379
2429
  #
2380
2430
  # @option params [Array<Types::Tag>] :tags
2381
2431
  # A list of labels to assign to the new script resource. Tags are
2382
- # developer-defined key-value pairs. Tagging AWS resources are useful
2383
- # for resource management, access management and cost allocation. For
2384
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
2385
- # Reference*. Once the resource is created, you can use TagResource,
2386
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
2387
- # The maximum tag limit may be lower than stated. See the AWS General
2432
+ # developer-defined key-value pairs. Tagging Amazon Web Services
2433
+ # resources are useful for resource management, access management and
2434
+ # cost allocation. For more information, see [ Tagging Amazon Web
2435
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
2436
+ # Once the resource is created, you can use TagResource, UntagResource,
2437
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
2438
+ # limit may be lower than stated. See the Amazon Web Services General
2388
2439
  # Reference for actual tagging limits.
2389
2440
  #
2390
2441
  #
@@ -2438,32 +2489,35 @@ module Aws::GameLift
2438
2489
  end
2439
2490
 
2440
2491
  # Requests authorization to create or delete a peer connection between
2441
- # the VPC for your Amazon GameLift fleet and a virtual private cloud
2442
- # (VPC) in your AWS account. VPC peering enables the game servers on
2443
- # your fleet to communicate directly with other AWS resources. Once
2444
- # you've received authorization, call CreateVpcPeeringConnection to
2445
- # establish the peering connection. For more information, see [VPC
2446
- # Peering with Amazon GameLift Fleets][1].
2447
- #
2448
- # You can peer with VPCs that are owned by any AWS account you have
2449
- # access to, including the account that you use to manage your Amazon
2450
- # GameLift fleets. You cannot peer with VPCs that are in different
2451
- # Regions.
2492
+ # the VPC for your Amazon Web Services fleet and a virtual private cloud
2493
+ # (VPC) in your Amazon Web Services account. VPC peering enables the
2494
+ # game servers on your fleet to communicate directly with other Amazon
2495
+ # Web Services resources. Once you've received authorization, call
2496
+ # CreateVpcPeeringConnection to establish the peering connection. For
2497
+ # more information, see [VPC Peering with Amazon Web Services
2498
+ # Fleets][1].
2499
+ #
2500
+ # You can peer with VPCs that are owned by any Amazon Web Services
2501
+ # account you have access to, including the account that you use to
2502
+ # manage your Amazon Web Services fleets. You cannot peer with VPCs that
2503
+ # are in different Regions.
2452
2504
  #
2453
2505
  # To request authorization to create a connection, call this operation
2454
- # from the AWS account with the VPC that you want to peer to your Amazon
2455
- # GameLift fleet. For example, to enable your game servers to retrieve
2456
- # data from a DynamoDB table, use the account that manages that DynamoDB
2457
- # resource. Identify the following values: (1) The ID of the VPC that
2458
- # you want to peer with, and (2) the ID of the AWS account that you use
2459
- # to manage Amazon GameLift. If successful, VPC peering is authorized
2460
- # for the specified VPC.
2506
+ # from the Amazon Web Services account with the VPC that you want to
2507
+ # peer to your Amazon Web Services fleet. For example, to enable your
2508
+ # game servers to retrieve data from a DynamoDB table, use the account
2509
+ # that manages that DynamoDB resource. Identify the following values:
2510
+ # (1) The ID of the VPC that you want to peer with, and (2) the ID of
2511
+ # the Amazon Web Services account that you use to manage Amazon Web
2512
+ # Services. If successful, VPC peering is authorized for the specified
2513
+ # VPC.
2461
2514
  #
2462
2515
  # To request authorization to delete a connection, call this operation
2463
- # from the AWS account with the VPC that is peered with your Amazon
2464
- # GameLift fleet. Identify the following values: (1) VPC ID that you
2465
- # want to delete the peering connection for, and (2) ID of the AWS
2466
- # account that you use to manage Amazon GameLift.
2516
+ # from the Amazon Web Services account with the VPC that is peered with
2517
+ # your Amazon Web Services fleet. Identify the following values: (1) VPC
2518
+ # ID that you want to delete the peering connection for, and (2) ID of
2519
+ # the Amazon Web Services account that you use to manage Amazon Web
2520
+ # Services.
2467
2521
  #
2468
2522
  # The authorization remains valid for 24 hours unless it is canceled by
2469
2523
  # a call to DeleteVpcPeeringAuthorization. You must create or delete the
@@ -2482,16 +2536,16 @@ module Aws::GameLift
2482
2536
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2483
2537
  #
2484
2538
  # @option params [required, String] :game_lift_aws_account_id
2485
- # A unique identifier for the AWS account that you use to manage your
2486
- # GameLift fleet. You can find your Account ID in the AWS Management
2487
- # Console under account settings.
2539
+ # A unique identifier for the Amazon Web Services account that you use
2540
+ # to manage your GameLift fleet. You can find your Account ID in the
2541
+ # Amazon Web Services Management Console under account settings.
2488
2542
  #
2489
2543
  # @option params [required, String] :peer_vpc_id
2490
2544
  # A unique identifier for a VPC with resources to be accessed by your
2491
2545
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
2492
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
2493
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
2494
- # Fleets][2].
2546
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
2547
+ # Services Management Console. Learn more about VPC peering in [VPC
2548
+ # Peering with GameLift Fleets][2].
2495
2549
  #
2496
2550
  #
2497
2551
  #
@@ -2527,13 +2581,14 @@ module Aws::GameLift
2527
2581
  end
2528
2582
 
2529
2583
  # Establishes a VPC peering connection between a virtual private cloud
2530
- # (VPC) in an AWS account with the VPC for your Amazon GameLift fleet.
2531
- # VPC peering enables the game servers on your fleet to communicate
2532
- # directly with other AWS resources. You can peer with VPCs in any AWS
2533
- # account that you have access to, including the account that you use to
2534
- # manage your Amazon GameLift fleets. You cannot peer with VPCs that are
2535
- # in different Regions. For more information, see [VPC Peering with
2536
- # Amazon GameLift Fleets][1].
2584
+ # (VPC) in an Amazon Web Services account with the VPC for your Amazon
2585
+ # Web Services fleet. VPC peering enables the game servers on your fleet
2586
+ # to communicate directly with other Amazon Web Services resources. You
2587
+ # can peer with VPCs in any Amazon Web Services account that you have
2588
+ # access to, including the account that you use to manage your Amazon
2589
+ # Web Services fleets. You cannot peer with VPCs that are in different
2590
+ # Regions. For more information, see [VPC Peering with Amazon Web
2591
+ # Services Fleets][1].
2537
2592
  #
2538
2593
  # Before calling this operation to establish the peering connection, you
2539
2594
  # first need to call CreateVpcPeeringAuthorization and identify the VPC
@@ -2542,16 +2597,16 @@ module Aws::GameLift
2542
2597
  # operations handle all tasks necessary to peer the two VPCs, including
2543
2598
  # acceptance, updating routing tables, etc.
2544
2599
  #
2545
- # To establish the connection, call this operation from the AWS account
2546
- # that is used to manage the Amazon GameLift fleets. Identify the
2547
- # following values: (1) The ID of the fleet you want to be enable a VPC
2548
- # peering connection for; (2) The AWS account with the VPC that you want
2549
- # to peer with; and (3) The ID of the VPC you want to peer with. This
2550
- # operation is asynchronous. If successful, a VpcPeeringConnection
2551
- # request is created. You can use continuous polling to track the
2552
- # request's status using DescribeVpcPeeringConnections, or by
2553
- # monitoring fleet events for success or failure using
2554
- # DescribeFleetEvents.
2600
+ # To establish the connection, call this operation from the Amazon Web
2601
+ # Services account that is used to manage the Amazon Web Services
2602
+ # fleets. Identify the following values: (1) The ID of the fleet you
2603
+ # want to be enable a VPC peering connection for; (2) The Amazon Web
2604
+ # Services account with the VPC that you want to peer with; and (3) The
2605
+ # ID of the VPC you want to peer with. This operation is asynchronous.
2606
+ # If successful, a VpcPeeringConnection request is created. You can use
2607
+ # continuous polling to track the request's status using
2608
+ # DescribeVpcPeeringConnections, or by monitoring fleet events for
2609
+ # success or failure using DescribeFleetEvents.
2555
2610
  #
2556
2611
  # **Related actions**
2557
2612
  #
@@ -2567,19 +2622,21 @@ module Aws::GameLift
2567
2622
  #
2568
2623
  # @option params [required, String] :fleet_id
2569
2624
  # A unique identifier for the fleet. You can use either the fleet ID or
2570
- # ARN value. This tells Amazon GameLift which GameLift VPC to peer with.
2625
+ # ARN value. This tells Amazon Web Services which GameLift VPC to peer
2626
+ # with.
2571
2627
  #
2572
2628
  # @option params [required, String] :peer_vpc_aws_account_id
2573
- # A unique identifier for the AWS account with the VPC that you want to
2574
- # peer your Amazon GameLift fleet with. You can find your Account ID in
2575
- # the AWS Management Console under account settings.
2629
+ # A unique identifier for the Amazon Web Services account with the VPC
2630
+ # that you want to peer your Amazon Web Services fleet with. You can
2631
+ # find your Account ID in the Amazon Web Services Management Console
2632
+ # under account settings.
2576
2633
  #
2577
2634
  # @option params [required, String] :peer_vpc_id
2578
2635
  # A unique identifier for a VPC with resources to be accessed by your
2579
2636
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
2580
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
2581
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
2582
- # Fleets][2].
2637
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
2638
+ # Services Management Console. Learn more about VPC peering in [VPC
2639
+ # Peering with GameLift Fleets][2].
2583
2640
  #
2584
2641
  #
2585
2642
  #
@@ -2772,7 +2829,7 @@ module Aws::GameLift
2772
2829
  #
2773
2830
  # @option params [required, Array<String>] :locations
2774
2831
  # The list of fleet locations to delete. Specify locations in the form
2775
- # of an AWS Region code, such as `us-west-2`.
2832
+ # of an Amazon Web Services Region code, such as `us-west-2`.
2776
2833
  #
2777
2834
  # @return [Types::DeleteFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2778
2835
  #
@@ -2858,16 +2915,16 @@ module Aws::GameLift
2858
2915
  # @option params [String] :delete_option
2859
2916
  # The type of delete to perform. Options include the following:
2860
2917
  #
2861
- # * `SAFE_DELETE` – (default) Terminates the game server group and EC2
2862
- # Auto Scaling group only when it has no game servers that are in
2863
- # `UTILIZED` status.
2918
+ # * `SAFE_DELETE` – (default) Terminates the game server group and
2919
+ # Amazon EC2 Auto Scaling group only when it has no game servers that
2920
+ # are in `UTILIZED` status.
2864
2921
  #
2865
2922
  # * `FORCE_DELETE` – Terminates the game server group, including all
2866
2923
  # active game servers regardless of their utilization status, and the
2867
- # EC2 Auto Scaling group.
2924
+ # Amazon EC2 Auto Scaling group.
2868
2925
  #
2869
2926
  # * `RETAIN` – Does a safe delete of the game server group but retains
2870
- # the EC2 Auto Scaling group as is.
2927
+ # the Amazon EC2 Auto Scaling group as is.
2871
2928
  #
2872
2929
  # @return [Types::DeleteGameServerGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2873
2930
  #
@@ -2908,23 +2965,28 @@ module Aws::GameLift
2908
2965
  end
2909
2966
 
2910
2967
  # Deletes a game session queue. Once a queue is successfully deleted,
2911
- # unfulfilled StartGameSessionPlacement requests that reference the
2968
+ # unfulfilled [StartGameSessionPlacement][1] requests that reference the
2912
2969
  # queue will fail. To delete a queue, specify the queue name.
2913
2970
  #
2914
2971
  # **Learn more**
2915
2972
  #
2916
- # [ Using Multi-Region Queues][1]
2973
+ # [ Using Multi-Region Queues][2]
2917
2974
  #
2918
2975
  # **Related actions**
2919
2976
  #
2920
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
2921
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
2922
- # task][2]
2977
+ # [CreateGameSessionQueue][3] \| [DescribeGameSessionQueues][4] \|
2978
+ # [UpdateGameSessionQueue][5] \| [DeleteGameSessionQueue][6] \| [All
2979
+ # APIs by task][7]
2923
2980
  #
2924
2981
  #
2925
2982
  #
2926
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
2927
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2983
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartGameSessionPlacement.html
2984
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
2985
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
2986
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
2987
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
2988
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
2989
+ # [7]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2928
2990
  #
2929
2991
  # @option params [required, String] :name
2930
2992
  # A descriptive label that is associated with game session queue. Queue
@@ -3087,7 +3149,7 @@ module Aws::GameLift
3087
3149
  #
3088
3150
  # **Learn more**
3089
3151
  #
3090
- # [Amazon GameLift Realtime Servers][1]
3152
+ # [Amazon Web Services Realtime Servers][1]
3091
3153
  #
3092
3154
  # **Related actions**
3093
3155
  #
@@ -3136,16 +3198,16 @@ module Aws::GameLift
3136
3198
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3137
3199
  #
3138
3200
  # @option params [required, String] :game_lift_aws_account_id
3139
- # A unique identifier for the AWS account that you use to manage your
3140
- # GameLift fleet. You can find your Account ID in the AWS Management
3141
- # Console under account settings.
3201
+ # A unique identifier for the Amazon Web Services account that you use
3202
+ # to manage your GameLift fleet. You can find your Account ID in the
3203
+ # Amazon Web Services Management Console under account settings.
3142
3204
  #
3143
3205
  # @option params [required, String] :peer_vpc_id
3144
3206
  # A unique identifier for a VPC with resources to be accessed by your
3145
3207
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
3146
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
3147
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
3148
- # Fleets][2].
3208
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
3209
+ # Services Management Console. Learn more about VPC peering in [VPC
3210
+ # Peering with GameLift Fleets][2].
3149
3211
  #
3150
3212
  #
3151
3213
  #
@@ -3176,10 +3238,10 @@ module Aws::GameLift
3176
3238
  # DescribeVpcPeeringAuthorizations or request a new one using
3177
3239
  # CreateVpcPeeringAuthorization.
3178
3240
  #
3179
- # Once a valid authorization exists, call this operation from the AWS
3180
- # account that is used to manage the Amazon GameLift fleets. Identify
3181
- # the connection to delete by the connection ID and fleet ID. If
3182
- # successful, the connection is removed.
3241
+ # Once a valid authorization exists, call this operation from the Amazon
3242
+ # Web Services account that is used to manage the Amazon Web Services
3243
+ # fleets. Identify the connection to delete by the connection ID and
3244
+ # fleet ID. If successful, the connection is removed.
3183
3245
  #
3184
3246
  # **Related actions**
3185
3247
  #
@@ -3375,22 +3437,23 @@ module Aws::GameLift
3375
3437
  req.send_request(options)
3376
3438
  end
3377
3439
 
3378
- # The GameLift service limits and current utilization for an AWS Region
3379
- # or location. Instance limits control the number of instances, per
3380
- # instance type, per location, that your AWS account can use. Learn more
3381
- # at [Amazon EC2 Instance Types][1]. The information returned includes
3382
- # the maximum number of instances allowed and your account's current
3383
- # usage across all fleets. This information can affect your ability to
3384
- # scale your GameLift fleets. You can request a limit increase for your
3385
- # account by using the **Service limits** page in the GameLift console.
3440
+ # The GameLift service limits and current utilization for an Amazon Web
3441
+ # Services Region or location. Instance limits control the number of
3442
+ # instances, per instance type, per location, that your Amazon Web
3443
+ # Services account can use. Learn more at [Amazon EC2 Instance
3444
+ # Types][1]. The information returned includes the maximum number of
3445
+ # instances allowed and your account's current usage across all fleets.
3446
+ # This information can affect your ability to scale your GameLift
3447
+ # fleets. You can request a limit increase for your account by using the
3448
+ # **Service limits** page in the GameLift console.
3386
3449
  #
3387
3450
  # Instance limits differ based on whether the instances are deployed in
3388
3451
  # a fleet's home Region or in a remote location. For remote locations,
3389
3452
  # limits also differ based on the combination of home Region and remote
3390
- # location. All requests must specify an AWS Region (either explicitly
3391
- # or as your default settings). To get the limit for a remote location,
3392
- # you must also specify the location. For example, the following
3393
- # requests all return different results:
3453
+ # location. All requests must specify an Amazon Web Services Region
3454
+ # (either explicitly or as your default settings). To get the limit for
3455
+ # a remote location, you must also specify the location. For example,
3456
+ # the following requests all return different results:
3394
3457
  #
3395
3458
  # * Request specifies the Region `ap-northeast-1` with no location. The
3396
3459
  # result is limits and usage data on all instance types that are
@@ -3411,14 +3474,15 @@ module Aws::GameLift
3411
3474
  # This operation can be used in the following ways:
3412
3475
  #
3413
3476
  # * To get limit and usage data for all instance types that are deployed
3414
- # in an AWS Region by fleets that reside in the same Region: Specify
3415
- # the Region only. Optionally, specify a single instance type to
3416
- # retrieve information for.
3477
+ # in an Amazon Web Services Region by fleets that reside in the same
3478
+ # Region: Specify the Region only. Optionally, specify a single
3479
+ # instance type to retrieve information for.
3417
3480
  #
3418
3481
  # * To get limit and usage data for all instance types that are deployed
3419
- # to a remote location by fleets that reside in different AWS Region:
3420
- # Provide both the AWS Region and the remote location. Optionally,
3421
- # specify a single instance type to retrieve information for.
3482
+ # to a remote location by fleets that reside in different Amazon Web
3483
+ # Services Region: Provide both the Amazon Web Services Region and the
3484
+ # remote location. Optionally, specify a single instance type to
3485
+ # retrieve information for.
3422
3486
  #
3423
3487
  # If successful, an `EC2InstanceLimits` object is returned with limits
3424
3488
  # and usage data for each requested instance type.
@@ -3441,15 +3505,15 @@ module Aws::GameLift
3441
3505
  # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3442
3506
  #
3443
3507
  # @option params [String] :ec2_instance_type
3444
- # Name of an EC2 instance type that is supported in GameLift. A fleet
3445
- # instance type determines the computing resources of each instance in
3446
- # the fleet, including CPU, memory, storage, and networking capacity. Do
3447
- # not specify a value for this parameter to retrieve limits for all
3448
- # instance types.
3508
+ # Name of an Amazon EC2 instance type that is supported in GameLift. A
3509
+ # fleet instance type determines the computing resources of each
3510
+ # instance in the fleet, including CPU, memory, storage, and networking
3511
+ # capacity. Do not specify a value for this parameter to retrieve limits
3512
+ # for all instance types.
3449
3513
  #
3450
3514
  # @option params [String] :location
3451
3515
  # The name of a remote location to request instance limits for, in the
3452
- # form of an AWS Region code such as `us-west-2`.
3516
+ # form of an Amazon Web Services Region code such as `us-west-2`.
3453
3517
  #
3454
3518
  # @return [Types::DescribeEC2InstanceLimitsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3455
3519
  #
@@ -3837,7 +3901,8 @@ module Aws::GameLift
3837
3901
  #
3838
3902
  # @option params [Array<String>] :locations
3839
3903
  # A list of fleet locations to retrieve information for. Specify
3840
- # locations in the form of an AWS Region code, such as `us-west-2`.
3904
+ # locations in the form of an Amazon Web Services Region code, such as
3905
+ # `us-west-2`.
3841
3906
  #
3842
3907
  # @option params [Integer] :limit
3843
3908
  # The maximum number of results to return. Use this parameter with
@@ -3927,7 +3992,8 @@ module Aws::GameLift
3927
3992
  #
3928
3993
  # @option params [required, String] :location
3929
3994
  # The fleet location to retrieve capacity information for. Specify a
3930
- # location in the form of an AWS Region code, such as `us-west-2`.
3995
+ # location in the form of an Amazon Web Services Region code, such as
3996
+ # `us-west-2`.
3931
3997
  #
3932
3998
  # @return [Types::DescribeFleetLocationCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3933
3999
  #
@@ -4000,7 +4066,8 @@ module Aws::GameLift
4000
4066
  #
4001
4067
  # @option params [required, String] :location
4002
4068
  # The fleet location to retrieve utilization information for. Specify a
4003
- # location in the form of an AWS Region code, such as `us-west-2`.
4069
+ # location in the form of an Amazon Web Services Region code, such as
4070
+ # `us-west-2`.
4004
4071
  #
4005
4072
  # @return [Types::DescribeFleetLocationUtilizationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4006
4073
  #
@@ -4075,7 +4142,7 @@ module Aws::GameLift
4075
4142
  #
4076
4143
  # @option params [String] :location
4077
4144
  # A remote location to check for status of port setting updates. Use the
4078
- # AWS Region code format, such as `us-west-2`.
4145
+ # Amazon Web Services Region code format, such as `us-west-2`.
4079
4146
  #
4080
4147
  # @return [Types::DescribeFleetPortSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4081
4148
  #
@@ -4396,10 +4463,10 @@ module Aws::GameLift
4396
4463
  # GameServerGroup name or ARN value.
4397
4464
  #
4398
4465
  # @option params [Array<String>] :instance_ids
4399
- # The EC2 instance IDs that you want to retrieve status on. EC2 instance
4400
- # IDs use a 17-character format, for example: `i-1234567890abcdef0`. To
4401
- # retrieve all instances in the game server group, leave this parameter
4402
- # empty.
4466
+ # The Amazon EC2 instance IDs that you want to retrieve status on.
4467
+ # Amazon EC2 instance IDs use a 17-character format, for example:
4468
+ # `i-1234567890abcdef0`. To retrieve all instances in the game server
4469
+ # group, leave this parameter empty.
4403
4470
  #
4404
4471
  # @option params [Integer] :limit
4405
4472
  # The maximum number of results to return. Use this parameter with
@@ -4467,7 +4534,8 @@ module Aws::GameLift
4467
4534
  #
4468
4535
  # * To retrieve details for a specific game session, provide the game
4469
4536
  # session ID. This approach looks for the game session ID in all
4470
- # fleets that reside in the AWS Region defined in the request.
4537
+ # fleets that reside in the Amazon Web Services Region defined in the
4538
+ # request.
4471
4539
  #
4472
4540
  # Use the pagination parameters to retrieve results as a set of
4473
4541
  # sequential pages.
@@ -4506,8 +4574,8 @@ module Aws::GameLift
4506
4574
  #
4507
4575
  # @option params [String] :location
4508
4576
  # A fleet location to get game sessions for. You can specify a fleet's
4509
- # home Region or a remote location. Use the AWS Region code format, such
4510
- # as `us-west-2`.
4577
+ # home Region or a remote location. Use the Amazon Web Services Region
4578
+ # code format, such as `us-west-2`.
4511
4579
  #
4512
4580
  # @option params [String] :status_filter
4513
4581
  # Game session status to filter results on. Possible game session
@@ -4584,6 +4652,14 @@ module Aws::GameLift
4584
4652
  #
4585
4653
  # To get game session placement details, specify the placement ID.
4586
4654
  #
4655
+ # This operation is not designed to be continually called to track game
4656
+ # session status. This practice can cause you to exceed your API limit,
4657
+ # which results in errors. Instead, you must configure configure an
4658
+ # Amazon Simple Notification Service (SNS) topic to receive
4659
+ # notifications from FlexMatch or queues. Continuously polling with
4660
+ # `DescribeGameSessionPlacement` should only be used for games in
4661
+ # development with low game session usage.
4662
+ #
4587
4663
  # If successful, a GameSessionPlacement object is returned.
4588
4664
  #
4589
4665
  # **Related actions**
@@ -4661,14 +4737,18 @@ module Aws::GameLift
4661
4737
  #
4662
4738
  # **Related actions**
4663
4739
  #
4664
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
4665
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
4666
- # task][2]
4740
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
4741
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
4742
+ # APIs by task][6]
4667
4743
  #
4668
4744
  #
4669
4745
  #
4670
4746
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-console.html
4671
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
4747
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
4748
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
4749
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
4750
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
4751
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
4672
4752
  #
4673
4753
  # @option params [Array<String>] :names
4674
4754
  # A list of queue names to retrieve information for. You can use either
@@ -4738,6 +4818,14 @@ module Aws::GameLift
4738
4818
  # retrieve the protection policy for game sessions, use
4739
4819
  # DescribeGameSessionDetails.
4740
4820
  #
4821
+ # This operation is not designed to be continually called to track game
4822
+ # session status. This practice can cause you to exceed your API limit,
4823
+ # which results in errors. Instead, you must configure configure an
4824
+ # Amazon Simple Notification Service (SNS) topic to receive
4825
+ # notifications from FlexMatch or queues. Continuously polling with
4826
+ # `DescribeGameSessions` should only be used for games in development
4827
+ # with low game session usage.
4828
+ #
4741
4829
  # This operation can be used in the following ways:
4742
4830
  #
4743
4831
  # * To retrieve all game sessions that are currently running on all
@@ -4752,7 +4840,7 @@ module Aws::GameLift
4752
4840
  #
4753
4841
  # * To retrieve a specific game session, provide the game session ID.
4754
4842
  # This approach looks for the game session ID in all fleets that
4755
- # reside in the AWS Region defined in the request.
4843
+ # reside in the Amazon Web Services Region defined in the request.
4756
4844
  #
4757
4845
  # Use the pagination parameters to retrieve results as a set of
4758
4846
  # sequential pages.
@@ -4760,7 +4848,15 @@ module Aws::GameLift
4760
4848
  # If successful, a `GameSession` object is returned for each game
4761
4849
  # session that matches the request.
4762
4850
  #
4763
- # *Available in GameLift Local.*
4851
+ # This operation is not designed to be continually called to track
4852
+ # matchmaking ticket status. This practice can cause you to exceed your
4853
+ # API limit, which results in errors. Instead, as a best practice, set
4854
+ # up an Amazon Simple Notification Service to receive notifications, and
4855
+ # provide the topic ARN in the matchmaking configuration. Continuously
4856
+ # poling ticket status with DescribeGameSessions should only be used for
4857
+ # games in development with low matchmaking usage.
4858
+ #
4859
+ # *Available in Amazon Web Services Local.*
4764
4860
  #
4765
4861
  # **Learn more**
4766
4862
  #
@@ -4793,8 +4889,8 @@ module Aws::GameLift
4793
4889
  #
4794
4890
  # @option params [String] :location
4795
4891
  # A fleet location to get game session details for. You can specify a
4796
- # fleet's home Region or a remote location. Use the AWS Region code
4797
- # format, such as `us-west-2`.
4892
+ # fleet's home Region or a remote location. Use the Amazon Web Services
4893
+ # Region code format, such as `us-west-2`.
4798
4894
  #
4799
4895
  # @option params [String] :status_filter
4800
4896
  # Game session status to filter results on. You can filter on the
@@ -4923,7 +5019,7 @@ module Aws::GameLift
4923
5019
  #
4924
5020
  # @option params [String] :location
4925
5021
  # The name of a location to retrieve instance information for, in the
4926
- # form of an AWS Region code such as `us-west-2`.
5022
+ # form of an Amazon Web Services Region code such as `us-west-2`.
4927
5023
  #
4928
5024
  # @return [Types::DescribeInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4929
5025
  #
@@ -4977,11 +5073,10 @@ module Aws::GameLift
4977
5073
  # This operation is not designed to be continually called to track
4978
5074
  # matchmaking ticket status. This practice can cause you to exceed your
4979
5075
  # API limit, which results in errors. Instead, as a best practice, set
4980
- # up an Amazon Simple Notification Service (SNS) to receive
4981
- # notifications, and provide the topic ARN in the matchmaking
4982
- # configuration. Continuously poling ticket status with
4983
- # DescribeMatchmaking should only be used for games in development with
4984
- # low matchmaking usage.
5076
+ # up an Amazon Simple Notification Service to receive notifications, and
5077
+ # provide the topic ARN in the matchmaking configuration. Continuously
5078
+ # poling ticket status with DescribeMatchmaking should only be used for
5079
+ # games in development with low matchmaking usage.
4985
5080
  #
4986
5081
  #
4987
5082
  #
@@ -5248,7 +5343,7 @@ module Aws::GameLift
5248
5343
  # If successful, a `PlayerSession` object is returned for each session
5249
5344
  # that matches the request.
5250
5345
  #
5251
- # *Available in Amazon GameLift Local.*
5346
+ # *Available in Amazon Web Services Local.*
5252
5347
  #
5253
5348
  # **Related actions**
5254
5349
  #
@@ -5433,8 +5528,8 @@ module Aws::GameLift
5433
5528
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
5434
5529
  #
5435
5530
  # @option params [required, String] :fleet_id
5436
- # A unique identifier for the fleet to retrieve scaling policies for.
5437
- # You can use either the fleet ID or ARN value.
5531
+ # A unique identifier for the fleet for which to retrieve scaling
5532
+ # policies. You can use either the fleet ID or ARN value.
5438
5533
  #
5439
5534
  # @option params [String] :status_filter
5440
5535
  # Scaling policy status to filter results on. A scaling policy is only
@@ -5468,7 +5563,8 @@ module Aws::GameLift
5468
5563
  # a value.
5469
5564
  #
5470
5565
  # @option params [String] :location
5471
- # CONTENT TODO
5566
+ # The fleet location. If you don't specify this value, the response
5567
+ # contains the scaling policies of every location in the fleet.
5472
5568
  #
5473
5569
  # @return [Types::DescribeScalingPoliciesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5474
5570
  #
@@ -5522,7 +5618,7 @@ module Aws::GameLift
5522
5618
  #
5523
5619
  # **Learn more**
5524
5620
  #
5525
- # [Amazon GameLift Realtime Servers][1]
5621
+ # [Amazon Web Services Realtime Servers][1]
5526
5622
  #
5527
5623
  # **Related actions**
5528
5624
  #
@@ -5571,9 +5667,9 @@ module Aws::GameLift
5571
5667
  end
5572
5668
 
5573
5669
  # Retrieves valid VPC peering authorizations that are pending for the
5574
- # AWS account. This operation returns all VPC peering authorizations and
5575
- # requests for peering. This includes those initiated and received by
5576
- # this account.
5670
+ # Amazon Web Services account. This operation returns all VPC peering
5671
+ # authorizations and requests for peering. This includes those initiated
5672
+ # and received by this account.
5577
5673
  #
5578
5674
  # **Related actions**
5579
5675
  #
@@ -5612,12 +5708,12 @@ module Aws::GameLift
5612
5708
  # to get peering information for all fleets or for one specific fleet
5613
5709
  # ID.
5614
5710
  #
5615
- # To retrieve connection information, call this operation from the AWS
5616
- # account that is used to manage the Amazon GameLift fleets. Specify a
5617
- # fleet ID or leave the parameter empty to retrieve all connection
5618
- # records. If successful, the retrieved information includes both active
5619
- # and pending connections. Active connections identify the IpV4 CIDR
5620
- # block that the VPC uses to connect.
5711
+ # To retrieve connection information, call this operation from the
5712
+ # Amazon Web Services account that is used to manage the Amazon Web
5713
+ # Services fleets. Specify a fleet ID or leave the parameter empty to
5714
+ # retrieve all connection records. If successful, the retrieved
5715
+ # information includes both active and pending connections. Active
5716
+ # connections identify the IpV4 CIDR block that the VPC uses to connect.
5621
5717
  #
5622
5718
  # **Related actions**
5623
5719
  #
@@ -5670,8 +5766,8 @@ module Aws::GameLift
5670
5766
  # automatically stores the logs in Amazon S3 and retains them for 14
5671
5767
  # days. Use this URL to download the logs.
5672
5768
  #
5673
- # <note markdown="1"> See the [AWS Service Limits][1] page for maximum log file sizes. Log
5674
- # files that exceed this limit are not saved.
5769
+ # <note markdown="1"> See the [Amazon Web Services Service Limits][1] page for maximum log
5770
+ # file sizes. Log files that exceed this limit are not saved.
5675
5771
  #
5676
5772
  # </note>
5677
5773
  #
@@ -5724,9 +5820,9 @@ module Aws::GameLift
5724
5820
  # Remote Desktop client. For a Linux instance, GameLift returns a user
5725
5821
  # name and RSA private key, also as strings, for use with an SSH client.
5726
5822
  # The private key must be saved in the proper format to a `.pem` file
5727
- # before using. If you're making this request using the AWS CLI, saving
5728
- # the secret can be handled as part of the `GetInstanceAccess` request,
5729
- # as shown in one of the examples for this operation.
5823
+ # before using. If you're making this request using the CLI, saving the
5824
+ # secret can be handled as part of the `GetInstanceAccess` request, as
5825
+ # shown in one of the examples for this operation.
5730
5826
  #
5731
5827
  # To request access to a specific instance, specify the IDs of both the
5732
5828
  # instance and the fleet it belongs to. You can retrieve a fleet's
@@ -5791,9 +5887,9 @@ module Aws::GameLift
5791
5887
  req.send_request(options)
5792
5888
  end
5793
5889
 
5794
- # Retrieves all aliases for this AWS account. You can filter the result
5795
- # set by alias name and/or routing strategy type. Use the pagination
5796
- # parameters to retrieve results in sequential pages.
5890
+ # Retrieves all aliases for this Amazon Web Services account. You can
5891
+ # filter the result set by alias name and/or routing strategy type. Use
5892
+ # the pagination parameters to retrieve results in sequential pages.
5797
5893
  #
5798
5894
  # <note markdown="1"> Returned aliases are not listed in any particular order.
5799
5895
  #
@@ -5876,10 +5972,11 @@ module Aws::GameLift
5876
5972
  req.send_request(options)
5877
5973
  end
5878
5974
 
5879
- # Retrieves build resources for all builds associated with the AWS
5880
- # account in use. You can limit results to builds that are in a specific
5881
- # status by using the `Status` parameter. Use the pagination parameters
5882
- # to retrieve results in a set of sequential pages.
5975
+ # Retrieves build resources for all builds associated with the Amazon
5976
+ # Web Services account in use. You can limit results to builds that are
5977
+ # in a specific status by using the `Status` parameter. Use the
5978
+ # pagination parameters to retrieve results in a set of sequential
5979
+ # pages.
5883
5980
  #
5884
5981
  # <note markdown="1"> Build resources are not listed in any particular order.
5885
5982
  #
@@ -5963,9 +6060,9 @@ module Aws::GameLift
5963
6060
  req.send_request(options)
5964
6061
  end
5965
6062
 
5966
- # Retrieves a collection of fleet resources in an AWS Region. You can
5967
- # call this operation to get fleets in a previously selected default
5968
- # Region (see
6063
+ # Retrieves a collection of fleet resources in an Amazon Web Services
6064
+ # Region. You can call this operation to get fleets in a previously
6065
+ # selected default Region (see
5969
6066
  # [https://docs.aws.amazon.com/credref/latest/refdocs/setting-global-region.html][1]or
5970
6067
  # specify a Region in your request. You can filter the result set to
5971
6068
  # find only those fleets that are deployed with a specific build or
@@ -6066,8 +6163,9 @@ module Aws::GameLift
6066
6163
  # server groups.**
6067
6164
  #
6068
6165
  # Retrieves information on all game servers groups that exist in the
6069
- # current AWS account for the selected Region. Use the pagination
6070
- # parameters to retrieve results in a set of sequential segments.
6166
+ # current Amazon Web Services account for the selected Region. Use the
6167
+ # pagination parameters to retrieve results in a set of sequential
6168
+ # segments.
6071
6169
  #
6072
6170
  # **Learn more**
6073
6171
  #
@@ -6225,11 +6323,11 @@ module Aws::GameLift
6225
6323
  end
6226
6324
 
6227
6325
  # Retrieves script records for all Realtime scripts that are associated
6228
- # with the AWS account in use.
6326
+ # with the Amazon Web Services account in use.
6229
6327
  #
6230
6328
  # **Learn more**
6231
6329
  #
6232
- # [Amazon GameLift Realtime Servers][1]
6330
+ # [Amazon Web Services Realtime Servers][1]
6233
6331
  #
6234
6332
  # **Related actions**
6235
6333
  #
@@ -6290,9 +6388,9 @@ module Aws::GameLift
6290
6388
  end
6291
6389
 
6292
6390
  # Retrieves all tags that are assigned to a GameLift resource. Resource
6293
- # tags are used to organize AWS resources for a range of purposes. This
6294
- # operation handles the permissions necessary to manage tags for the
6295
- # following GameLift resource types:
6391
+ # tags are used to organize Amazon Web Services resources for a range of
6392
+ # purposes. This operation handles the permissions necessary to manage
6393
+ # tags for the following GameLift resource types:
6296
6394
  #
6297
6395
  # * Build
6298
6396
  #
@@ -6313,9 +6411,10 @@ module Aws::GameLift
6313
6411
  #
6314
6412
  # **Learn more**
6315
6413
  #
6316
- # [Tagging AWS Resources][1] in the *AWS General Reference*
6414
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
6415
+ # General Reference*
6317
6416
  #
6318
- # [ AWS Tagging Strategies][2]
6417
+ # [ Amazon Web Services Tagging Strategies][2]
6319
6418
  #
6320
6419
  # **Related actions**
6321
6420
  #
@@ -6366,13 +6465,13 @@ module Aws::GameLift
6366
6465
 
6367
6466
  # Creates or updates a scaling policy for a fleet. Scaling policies are
6368
6467
  # used to automatically scale a fleet's hosting capacity to meet player
6369
- # demand. An active scaling policy instructs Amazon GameLift to track a
6370
- # fleet metric and automatically change the fleet's capacity when a
6371
- # certain threshold is reached. There are two types of scaling policies:
6372
- # target-based and rule-based. Use a target-based policy to quickly and
6373
- # efficiently manage fleet scaling; this option is the most commonly
6374
- # used. Use rule-based policies when you need to exert fine-grained
6375
- # control over auto-scaling.
6468
+ # demand. An active scaling policy instructs Amazon Web Services to
6469
+ # track a fleet metric and automatically change the fleet's capacity
6470
+ # when a certain threshold is reached. There are two types of scaling
6471
+ # policies: target-based and rule-based. Use a target-based policy to
6472
+ # quickly and efficiently manage fleet scaling; this option is the most
6473
+ # commonly used. Use rule-based policies when you need to exert
6474
+ # fine-grained control over auto-scaling.
6376
6475
  #
6377
6476
  # Fleets can have multiple scaling policies of each type in force at the
6378
6477
  # same time; you can have one target-based policy, one or multiple
@@ -6397,15 +6496,15 @@ module Aws::GameLift
6397
6496
  # currently in use. This is the fleet's buffer; it measures the
6398
6497
  # additional player demand that the fleet could handle at current
6399
6498
  # capacity. With a target-based policy, you set your ideal buffer size
6400
- # and leave it to Amazon GameLift to take whatever action is needed to
6401
- # maintain that target.
6499
+ # and leave it to Amazon Web Services to take whatever action is needed
6500
+ # to maintain that target.
6402
6501
  #
6403
6502
  # For example, you might choose to maintain a 10% buffer for a fleet
6404
6503
  # that has the capacity to host 100 simultaneous game sessions. This
6405
- # policy tells Amazon GameLift to take action whenever the fleet's
6504
+ # policy tells Amazon Web Services to take action whenever the fleet's
6406
6505
  # available capacity falls below or rises above 10 game sessions. Amazon
6407
- # GameLift will start new instances or stop unused instances in order to
6408
- # return to the 10% buffer.
6506
+ # Web Services will start new instances or stop unused instances in
6507
+ # order to return to the 10% buffer.
6409
6508
  #
6410
6509
  # To create or update a target-based policy, specify a fleet ID and
6411
6510
  # name, and set the policy type to "TargetBased". Specify the metric
@@ -6501,9 +6600,9 @@ module Aws::GameLift
6501
6600
  # threshold before a scaling event is triggered.
6502
6601
  #
6503
6602
  # @option params [required, String] :metric_name
6504
- # Name of the Amazon GameLift-defined metric that is used to trigger a
6505
- # scaling adjustment. For detailed descriptions of fleet metrics, see
6506
- # [Monitor Amazon GameLift with Amazon CloudWatch][1].
6603
+ # Name of the Amazon Web Services-defined metric that is used to trigger
6604
+ # a scaling adjustment. For detailed descriptions of fleet metrics, see
6605
+ # [Monitor Amazon Web Services with Amazon CloudWatch][1].
6507
6606
  #
6508
6607
  # * **ActivatingGameSessions** -- Game sessions in the process of being
6509
6608
  # created.
@@ -6632,7 +6731,7 @@ module Aws::GameLift
6632
6731
  # @option params [required, String] :game_server_id
6633
6732
  # A custom string that uniquely identifies the game server to register.
6634
6733
  # Game server IDs are developer-defined and must be unique across all
6635
- # game server groups in your AWS account.
6734
+ # game server groups in your Amazon Web Services account.
6636
6735
  #
6637
6736
  # @option params [required, String] :instance_id
6638
6737
  # The unique identifier for the instance where the game server is
@@ -6688,8 +6787,8 @@ module Aws::GameLift
6688
6787
  end
6689
6788
 
6690
6789
  # Retrieves a fresh set of credentials for use when uploading a new set
6691
- # of game build files to Amazon GameLift's Amazon S3. This is done as
6692
- # part of the build creation process; see CreateBuild.
6790
+ # of game build files to Amazon Web Services's Amazon S3. This is done
6791
+ # as part of the build creation process; see CreateBuild.
6693
6792
  #
6694
6793
  # To request new credentials, specify the build ID as returned with an
6695
6794
  # initial `CreateBuild` request. If successful, a new set of credentials
@@ -6865,6 +6964,14 @@ module Aws::GameLift
6865
6964
  # Retrieves all active game sessions that match a set of search criteria
6866
6965
  # and sorts them into a specified order.
6867
6966
  #
6967
+ # This operation is not designed to be continually called to track game
6968
+ # session status. This practice can cause you to exceed your API limit,
6969
+ # which results in errors. Instead, you must configure configure an
6970
+ # Amazon Simple Notification Service (SNS) topic to receive
6971
+ # notifications from FlexMatch or queues. Continuously polling game
6972
+ # session status with `DescribeGameSessions` should only be used for
6973
+ # games in development with low game session usage.
6974
+ #
6868
6975
  # When searching for game sessions, you specify exactly where you want
6869
6976
  # to search and provide a search filter expression, a sort expression,
6870
6977
  # or both. A search request can search only one fleet, but it can search
@@ -6959,8 +7066,8 @@ module Aws::GameLift
6959
7066
  #
6960
7067
  # @option params [String] :location
6961
7068
  # A fleet location to search for game sessions. You can specify a
6962
- # fleet's home Region or a remote location. Use the AWS Region code
6963
- # format, such as `us-west-2`.
7069
+ # fleet's home Region or a remote location. Use the Amazon Web Services
7070
+ # Region code format, such as `us-west-2`.
6964
7071
  #
6965
7072
  # @option params [String] :filter_expression
6966
7073
  # String containing the search criteria for the session search. If no
@@ -7136,7 +7243,7 @@ module Aws::GameLift
7136
7243
  #
7137
7244
  # @option params [String] :location
7138
7245
  # The fleet location to restart fleet actions for. Specify a location in
7139
- # the form of an AWS Region code, such as `us-west-2`.
7246
+ # the form of an Amazon Web Services Region code, such as `us-west-2`.
7140
7247
  #
7141
7248
  # @return [Types::StartFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7142
7249
  #
@@ -7167,26 +7274,26 @@ module Aws::GameLift
7167
7274
 
7168
7275
  # Places a request for a new game session in a queue (see
7169
7276
  # CreateGameSessionQueue). When processing a placement request, Amazon
7170
- # GameLift searches for available resources on the queue's
7277
+ # Web Services searches for available resources on the queue's
7171
7278
  # destinations, scanning each until it finds resources or the placement
7172
7279
  # request times out.
7173
7280
  #
7174
7281
  # A game session placement request can also request player sessions.
7175
- # When a new game session is successfully created, Amazon GameLift
7282
+ # When a new game session is successfully created, Amazon Web Services
7176
7283
  # creates a player session for each player included in the request.
7177
7284
  #
7178
- # When placing a game session, by default Amazon GameLift tries each
7285
+ # When placing a game session, by default Amazon Web Services tries each
7179
7286
  # fleet in the order they are listed in the queue configuration.
7180
7287
  # Ideally, a queue's destinations are listed in preference order.
7181
7288
  #
7182
7289
  # Alternatively, when requesting a game session with players, you can
7183
7290
  # also provide latency data for each player in relevant Regions. Latency
7184
7291
  # data indicates the performance lag a player experiences when connected
7185
- # to a fleet in the Region. Amazon GameLift uses latency data to reorder
7186
- # the list of destinations to place the game session in a Region with
7187
- # minimal lag. If latency data is provided for multiple players, Amazon
7188
- # GameLift calculates each Region's average lag for all players and
7189
- # reorders to get the best game play across all players.
7292
+ # to a fleet in the Region. Amazon Web Services uses latency data to
7293
+ # reorder the list of destinations to place the game session in a Region
7294
+ # with minimal lag. If latency data is provided for multiple players,
7295
+ # Amazon Web Services calculates each Region's average lag for all
7296
+ # players and reorders to get the best game play across all players.
7190
7297
  #
7191
7298
  # To place a new game session request, specify the following:
7192
7299
  #
@@ -7253,7 +7360,7 @@ module Aws::GameLift
7253
7360
  #
7254
7361
  # @option params [Array<Types::PlayerLatency>] :player_latencies
7255
7362
  # A set of values, expressed in milliseconds, that indicates the amount
7256
- # of latency that a player experiences when connected to AWS Regions.
7363
+ # of latency that a player experiences when connected to @aws; Regions.
7257
7364
  # This information is used to try to place the new game session where it
7258
7365
  # can offer the best possible gameplay experience for the players.
7259
7366
  #
@@ -7372,6 +7479,9 @@ module Aws::GameLift
7372
7479
  # and returned with status set to QUEUED. Track the status of backfill
7373
7480
  # tickets using the same method for tracking tickets for new matches.
7374
7481
  #
7482
+ # Only game sessions created by FlexMatch are supported for match
7483
+ # backfill.
7484
+ #
7375
7485
  # **Learn more**
7376
7486
  #
7377
7487
  # [ Backfill existing games with FlexMatch][1]
@@ -7394,7 +7504,7 @@ module Aws::GameLift
7394
7504
  #
7395
7505
  # @option params [String] :ticket_id
7396
7506
  # A unique identifier for a matchmaking ticket. If no ticket ID is
7397
- # specified here, Amazon GameLift will generate one in the form of a
7507
+ # specified here, Amazon Web Services will generate one in the form of a
7398
7508
  # UUID. Use this identifier to track the match backfill ticket status
7399
7509
  # and retrieve match results.
7400
7510
  #
@@ -7420,6 +7530,9 @@ module Aws::GameLift
7420
7530
  # matchmaker data is in JSON syntax, formatted as a string. For more
7421
7531
  # details, see [ Match Data][1].
7422
7532
  #
7533
+ # The backfill request must specify the team membership for every
7534
+ # player. Do not specify team if you are not using backfill.
7535
+ #
7423
7536
  # * LatencyInMs -- If the matchmaker uses player latency, include a
7424
7537
  # latency value, in milliseconds, for the Region that the game session
7425
7538
  # is currently in. Do not include latency values for any other Region.
@@ -7506,7 +7619,7 @@ module Aws::GameLift
7506
7619
  # Track matchmaking events to respond as needed and acquire game session
7507
7620
  # connection information for successfully completed matches. Ticket
7508
7621
  # status updates are tracked using event notification through Amazon
7509
- # Simple Notification Service (SNS), which is defined in the matchmaking
7622
+ # Simple Notification Service, which is defined in the matchmaking
7510
7623
  # configuration.
7511
7624
  #
7512
7625
  # **Learn more**
@@ -7531,7 +7644,7 @@ module Aws::GameLift
7531
7644
  #
7532
7645
  # @option params [String] :ticket_id
7533
7646
  # A unique identifier for a matchmaking ticket. If no ticket ID is
7534
- # specified here, Amazon GameLift will generate one in the form of a
7647
+ # specified here, Amazon Web Services will generate one in the form of a
7535
7648
  # UUID. Use this identifier to track the matchmaking ticket status and
7536
7649
  # retrieve match results.
7537
7650
  #
@@ -7656,7 +7769,7 @@ module Aws::GameLift
7656
7769
  #
7657
7770
  # @option params [String] :location
7658
7771
  # The fleet location to stop fleet actions for. Specify a location in
7659
- # the form of an AWS Region code, such as `us-west-2`.
7772
+ # the form of an Amazon Web Services Region code, such as `us-west-2`.
7660
7773
  #
7661
7774
  # @return [Types::StopFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7662
7775
  #
@@ -7886,12 +7999,12 @@ module Aws::GameLift
7886
7999
  req.send_request(options)
7887
8000
  end
7888
8001
 
7889
- # Assigns a tag to a GameLift resource. AWS resource tags provide an
7890
- # additional management tool set. You can use tags to organize
7891
- # resources, create IAM permissions policies to manage access to groups
7892
- # of resources, customize AWS cost breakdowns, etc. This operation
7893
- # handles the permissions necessary to manage tags for the following
7894
- # GameLift resource types:
8002
+ # Assigns a tag to a GameLift resource. Amazon Web Services resource
8003
+ # tags provide an additional management tool set. You can use tags to
8004
+ # organize resources, create IAM permissions policies to manage access
8005
+ # to groups of resources, customize Amazon Web Services cost breakdowns,
8006
+ # etc. This operation handles the permissions necessary to manage tags
8007
+ # for the following GameLift resource types:
7895
8008
  #
7896
8009
  # * Build
7897
8010
  #
@@ -7914,9 +8027,10 @@ module Aws::GameLift
7914
8027
  #
7915
8028
  # **Learn more**
7916
8029
  #
7917
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8030
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8031
+ # General Reference*
7918
8032
  #
7919
- # [ AWS Tagging Strategies][2]
8033
+ # [ Amazon Web Services Tagging Strategies][2]
7920
8034
  #
7921
8035
  # **Related actions**
7922
8036
  #
@@ -7944,7 +8058,7 @@ module Aws::GameLift
7944
8058
  # A list of one or more tags to assign to the specified GameLift
7945
8059
  # resource. Tags are developer-defined and structured as key-value
7946
8060
  # pairs. The maximum tag limit may be lower than stated. See [ Tagging
7947
- # AWS Resources][1] for actual tagging limits.
8061
+ # Amazon Web Services Resources][1] for actual tagging limits.
7948
8062
  #
7949
8063
  #
7950
8064
  #
@@ -7974,9 +8088,9 @@ module Aws::GameLift
7974
8088
  end
7975
8089
 
7976
8090
  # Removes a tag that is assigned to a GameLift resource. Resource tags
7977
- # are used to organize AWS resources for a range of purposes. This
7978
- # operation handles the permissions necessary to manage tags for the
7979
- # following GameLift resource types:
8091
+ # are used to organize Amazon Web Services resources for a range of
8092
+ # purposes. This operation handles the permissions necessary to manage
8093
+ # tags for the following GameLift resource types:
7980
8094
  #
7981
8095
  # * Build
7982
8096
  #
@@ -7999,9 +8113,10 @@ module Aws::GameLift
7999
8113
  #
8000
8114
  # **Learn more**
8001
8115
  #
8002
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8116
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8117
+ # General Reference*
8003
8118
  #
8004
- # [ AWS Tagging Strategies][2]
8119
+ # [ Amazon Web Services Tagging Strategies][2]
8005
8120
  #
8006
8121
  # **Related actions**
8007
8122
  #
@@ -8027,8 +8142,9 @@ module Aws::GameLift
8027
8142
  #
8028
8143
  # @option params [required, Array<String>] :tag_keys
8029
8144
  # A list of one or more tag keys to remove from the specified GameLift
8030
- # resource. An AWS resource can have only one tag with a specific tag
8031
- # key, so specifying the tag key identifies which tag to remove.
8145
+ # resource. An Amazon Web Services resource can have only one tag with a
8146
+ # specific tag key, so specifying the tag key identifies which tag to
8147
+ # remove.
8032
8148
  #
8033
8149
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
8034
8150
  #
@@ -8280,12 +8396,12 @@ module Aws::GameLift
8280
8396
  # whether the capacity is changed manually or through automatic
8281
8397
  # scaling.
8282
8398
  #
8283
- # * Desired capacity: Manually set the number of EC2 instances to be
8284
- # maintained in a fleet location. Before changing a fleet's desired
8285
- # capacity, you may want to call DescribeEC2InstanceLimits to get the
8286
- # maximum capacity of the fleet's EC2 instance type. Alternatively,
8287
- # consider using automatic scaling to adjust capacity based on player
8288
- # demand.
8399
+ # * Desired capacity: Manually set the number of Amazon EC2 instances to
8400
+ # be maintained in a fleet location. Before changing a fleet's
8401
+ # desired capacity, you may want to call DescribeEC2InstanceLimits to
8402
+ # get the maximum capacity of the fleet's Amazon EC2 instance type.
8403
+ # Alternatively, consider using automatic scaling to adjust capacity
8404
+ # based on player demand.
8289
8405
  #
8290
8406
  # This operation can be used in the following ways:
8291
8407
  #
@@ -8329,9 +8445,9 @@ module Aws::GameLift
8329
8445
  # can use either the fleet ID or ARN value.
8330
8446
  #
8331
8447
  # @option params [Integer] :desired_instances
8332
- # The number of EC2 instances you want to maintain in the specified
8333
- # fleet location. This value must fall between the minimum and maximum
8334
- # size limits.
8448
+ # The number of Amazon EC2 instances you want to maintain in the
8449
+ # specified fleet location. This value must fall between the minimum and
8450
+ # maximum size limits.
8335
8451
  #
8336
8452
  # @option params [Integer] :min_size
8337
8453
  # The minimum number of instances that are allowed in the specified
@@ -8343,7 +8459,7 @@ module Aws::GameLift
8343
8459
  #
8344
8460
  # @option params [String] :location
8345
8461
  # The name of a remote location to update fleet capacity settings for,
8346
- # in the form of an AWS Region code such as `us-west-2`.
8462
+ # in the form of an Amazon Web Services Region code such as `us-west-2`.
8347
8463
  #
8348
8464
  # @return [Types::UpdateFleetCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8349
8465
  #
@@ -8598,24 +8714,24 @@ module Aws::GameLift
8598
8714
  #
8599
8715
  # @option params [String] :role_arn
8600
8716
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
8601
- # GameLift to access your EC2 Auto Scaling groups.
8717
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
8602
8718
  #
8603
8719
  #
8604
8720
  #
8605
8721
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
8606
8722
  #
8607
8723
  # @option params [Array<Types::InstanceDefinition>] :instance_definitions
8608
- # An updated list of EC2 instance types to use in the Auto Scaling
8609
- # group. The instance definitions must specify at least two different
8610
- # instance types that are supported by GameLift FleetIQ. This updated
8611
- # list replaces the entire current list of instance definitions for the
8612
- # game server group. For more information on instance types, see [EC2
8613
- # Instance Types][1] in the *Amazon EC2 User Guide*. You can optionally
8614
- # specify capacity weighting for each instance type. If no weight value
8615
- # is specified for an instance type, it is set to the default value
8616
- # "1". For more information about capacity weighting, see [ Instance
8617
- # Weighting for Amazon EC2 Auto Scaling][2] in the Amazon EC2 Auto
8618
- # Scaling User Guide.
8724
+ # An updated list of Amazon EC2 instance types to use in the Auto
8725
+ # Scaling group. The instance definitions must specify at least two
8726
+ # different instance types that are supported by GameLift FleetIQ. This
8727
+ # updated list replaces the entire current list of instance definitions
8728
+ # for the game server group. For more information on instance types, see
8729
+ # [EC2 Instance Types][1] in the *Amazon EC2 User Guide*. You can
8730
+ # optionally specify capacity weighting for each instance type. If no
8731
+ # weight value is specified for an instance type, it is set to the
8732
+ # default value "1". For more information about capacity weighting,
8733
+ # see [ Instance Weighting for Amazon EC2 Auto Scaling][2] in the Amazon
8734
+ # EC2 Auto Scaling User Guide.
8619
8735
  #
8620
8736
  #
8621
8737
  #
@@ -8630,8 +8746,8 @@ module Aws::GameLift
8630
8746
  # instances cannot be terminated while there are active game servers
8631
8747
  # running except in the event of a forced game server group deletion
8632
8748
  # (see ). An exception to this is with Spot Instances, which can be
8633
- # terminated by AWS regardless of protection status. This property is
8634
- # set to `NO_PROTECTION` by default.
8749
+ # terminated by Amazon Web Services regardless of protection status.
8750
+ # This property is set to `NO_PROTECTION` by default.
8635
8751
  #
8636
8752
  # @option params [String] :balancing_strategy
8637
8753
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -8803,14 +8919,18 @@ module Aws::GameLift
8803
8919
  #
8804
8920
  # **Related actions**
8805
8921
  #
8806
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
8807
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
8808
- # task][2]
8922
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
8923
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
8924
+ # APIs by task][6]
8809
8925
  #
8810
8926
  #
8811
8927
  #
8812
8928
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
8813
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
8929
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
8930
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
8931
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
8932
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
8933
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
8814
8934
  #
8815
8935
  # @option params [required, String] :name
8816
8936
  # A descriptive label that is associated with game session queue. Queue
@@ -8841,10 +8961,10 @@ module Aws::GameLift
8841
8961
  #
8842
8962
  # @option params [Types::FilterConfiguration] :filter_configuration
8843
8963
  # A list of locations where a queue is allowed to place new game
8844
- # sessions. Locations are specified in the form of AWS Region codes,
8845
- # such as `us-west-2`. If this parameter is not set, game sessions can
8846
- # be placed in any queue location. To remove an existing filter
8847
- # configuration, pass in an empty set.
8964
+ # sessions. Locations are specified in the form of Amazon Web Services
8965
+ # Region codes, such as `us-west-2`. If this parameter is not set, game
8966
+ # sessions can be placed in any queue location. To remove an existing
8967
+ # filter configuration, pass in an empty set.
8848
8968
  #
8849
8969
  # @option params [Types::PriorityConfiguration] :priority_configuration
8850
8970
  # Custom settings to use when prioritizing destinations and locations
@@ -9219,13 +9339,13 @@ module Aws::GameLift
9219
9339
  # the *Version* parameter to track updates to the script.
9220
9340
  #
9221
9341
  # If the call is successful, the updated metadata is stored in the
9222
- # script record and a revised script is uploaded to the Amazon GameLift
9223
- # service. Once the script is updated and acquired by a fleet instance,
9224
- # the new version is used for all new game sessions.
9342
+ # script record and a revised script is uploaded to the Amazon Web
9343
+ # Services service. Once the script is updated and acquired by a fleet
9344
+ # instance, the new version is used for all new game sessions.
9225
9345
  #
9226
9346
  # **Learn more**
9227
9347
  #
9228
- # [Amazon GameLift Realtime Servers][1]
9348
+ # [Amazon Web Services Realtime Servers][1]
9229
9349
  #
9230
9350
  # **Related actions**
9231
9351
  #
@@ -9253,21 +9373,22 @@ module Aws::GameLift
9253
9373
  # The location of the Amazon S3 bucket where a zipped file containing
9254
9374
  # your Realtime scripts is stored. The storage location must specify the
9255
9375
  # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
9256
- # that allows Amazon GameLift to access the Amazon S3 storage location.
9257
- # The S3 bucket must be in the same Region where you want to create a
9258
- # new script. By default, Amazon GameLift uploads the latest version of
9259
- # the zip file; if you have S3 object versioning turned on, you can use
9260
- # the `ObjectVersion` parameter to specify an earlier version.
9376
+ # that allows Amazon Web Services to access the Amazon S3 storage
9377
+ # location. The S3 bucket must be in the same Region where you want to
9378
+ # create a new script. By default, Amazon Web Services uploads the
9379
+ # latest version of the zip file; if you have S3 object versioning
9380
+ # turned on, you can use the `ObjectVersion` parameter to specify an
9381
+ # earlier version.
9261
9382
  #
9262
9383
  # @option params [String, StringIO, File] :zip_file
9263
9384
  # A data object containing your Realtime scripts and dependencies as a
9264
9385
  # zip file. The zip file can have one or multiple files. Maximum size of
9265
9386
  # a zip file is 5 MB.
9266
9387
  #
9267
- # When using the AWS CLI tool to create a script, this parameter is set
9268
- # to the zip file name. It must be prepended with the string
9269
- # "fileb://" to indicate that the file data is a binary object. For
9270
- # example: `--zip-file fileb://myRealtimeScript.zip`.
9388
+ # When using the Amazon Web Services CLI tool to create a script, this
9389
+ # parameter is set to the zip file name. It must be prepended with the
9390
+ # string "fileb://" to indicate that the file data is a binary object.
9391
+ # For example: `--zip-file fileb://myRealtimeScript.zip`.
9271
9392
  #
9272
9393
  # @return [Types::UpdateScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9273
9394
  #
@@ -9374,7 +9495,7 @@ module Aws::GameLift
9374
9495
  params: params,
9375
9496
  config: config)
9376
9497
  context[:gem_name] = 'aws-sdk-gamelift'
9377
- context[:gem_version] = '1.52.0'
9498
+ context[:gem_version] = '1.55.0'
9378
9499
  Seahorse::Client::Request.new(handlers, context)
9379
9500
  end
9380
9501