aws-sdk-gamelift 1.53.0 → 1.56.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,6 +27,7 @@ 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'
31
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
32
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::GameLift
75
76
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
76
77
  add_plugin(Aws::Plugins::TransferEncoding)
77
78
  add_plugin(Aws::Plugins::HttpChecksum)
79
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
78
80
  add_plugin(Aws::Plugins::DefaultsMode)
79
81
  add_plugin(Aws::Plugins::RecursionDetection)
80
82
  add_plugin(Aws::Plugins::SignatureV4)
@@ -545,12 +547,12 @@ module Aws::GameLift
545
547
  # for a fleet that is useful when redirecting player traffic from one
546
548
  # fleet to another, such as when updating your game build.
547
549
  #
548
- # Amazon GameLift supports two types of routing strategies for aliases:
549
- # simple and terminal. A simple alias points to an active fleet. A
550
- # terminal alias is used to display messaging or link to a URL instead
551
- # of routing players to an active fleet. For example, you might use a
552
- # terminal alias when a game version is no longer supported and you want
553
- # 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.
554
556
  #
555
557
  # To create a fleet alias, specify an alias name, routing strategy, and
556
558
  # optional description. Each simple alias can point to only one fleet,
@@ -580,12 +582,13 @@ module Aws::GameLift
580
582
  #
581
583
  # @option params [Array<Types::Tag>] :tags
582
584
  # A list of labels to assign to the new alias resource. Tags are
583
- # developer-defined key-value pairs. Tagging AWS resources are useful
584
- # for resource management, access management and cost allocation. For
585
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
586
- # Reference*. Once the resource is created, you can use TagResource,
587
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
588
- # 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
589
592
  # Reference for actual tagging limits.
590
593
  #
591
594
  #
@@ -635,12 +638,12 @@ module Aws::GameLift
635
638
  req.send_request(options)
636
639
  end
637
640
 
638
- # Creates a new Amazon GameLift build resource for your game server
641
+ # Creates a new Amazon Web Services build resource for your game server
639
642
  # binary files. Game server binaries must be combined into a zip file
640
- # for use with Amazon GameLift.
643
+ # for use with Amazon Web Services.
641
644
  #
642
645
  # When setting up a new game build for GameLift, we recommend using the
643
- # AWS CLI command <b> <a
646
+ # Amazon Web Services CLI command <b> <a
644
647
  # href="https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html">upload-build</a>
645
648
  # </b>. This helper command combines two tasks: (1) it uploads your
646
649
  # build files from a file directory to a GameLift Amazon S3 location,
@@ -649,11 +652,11 @@ module Aws::GameLift
649
652
  # The `CreateBuild` operation can used in the following scenarios:
650
653
  #
651
654
  # * To create a new game build with build files that are in an Amazon S3
652
- # location under an AWS account that you control. To use this option,
653
- # you must first give Amazon GameLift access to the Amazon S3 bucket.
654
- # With permissions in place, call `CreateBuild` and specify a build
655
- # name, operating system, and the Amazon S3 storage location of your
656
- # 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.
657
660
  #
658
661
  # * To directly upload your build files to a GameLift Amazon S3
659
662
  # location. To use this option, first call `CreateBuild` and specify a
@@ -702,8 +705,13 @@ module Aws::GameLift
702
705
  # this parameter only when creating a build with files stored in an
703
706
  # Amazon S3 bucket that you own. The storage location must specify an
704
707
  # Amazon S3 bucket name and key. The location must also specify a role
705
- # ARN that you set up to allow Amazon GameLift to access your Amazon S3
706
- # 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.
707
715
  #
708
716
  # @option params [String] :operating_system
709
717
  # The operating system that the game server binaries are built to run
@@ -715,12 +723,13 @@ module Aws::GameLift
715
723
  #
716
724
  # @option params [Array<Types::Tag>] :tags
717
725
  # A list of labels to assign to the new build resource. Tags are
718
- # developer-defined key-value pairs. Tagging AWS resources are useful
719
- # for resource management, access management and cost allocation. For
720
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
721
- # Reference*. Once the resource is created, you can use TagResource,
722
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
723
- # 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
724
733
  # Reference for actual tagging limits.
725
734
  #
726
735
  #
@@ -780,21 +789,23 @@ module Aws::GameLift
780
789
  req.send_request(options)
781
790
  end
782
791
 
783
- # Creates a fleet of Amazon Elastic Compute Cloud (Amazon EC2) instances
784
- # to host your custom game server or Realtime Servers. Use this
785
- # operation to configure the computing resources for your fleet and
786
- # 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.
787
797
  #
788
798
  # Most GameLift fleets can deploy instances to multiple locations,
789
799
  # including the home Region (where the fleet is created) and an optional
790
- # set of remote locations. Fleets that are created in the following AWS
791
- # Regions support multiple locations: us-east-1 (N. Virginia), us-west-2
792
- # (Oregon), eu-central-1 (Frankfurt), eu-west-1 (Ireland),
793
- # ap-southeast-2 (Sydney), ap-northeast-1 (Tokyo), and ap-northeast-2
794
- # (Seoul). Fleets that are created in other GameLift Regions can deploy
795
- # instances in the fleet's home Region only. All fleet instances use
796
- # the same configuration regardless of location; however, you can adjust
797
- # 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.
798
809
  #
799
810
  # To create a fleet, choose the hardware for your instances, specify a
800
811
  # game server build or Realtime script to deploy, and provide a runtime
@@ -804,6 +815,12 @@ module Aws::GameLift
804
815
  # creating a multi-location fleet, provide a list of additional remote
805
816
  # locations.
806
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
+ #
807
824
  # If successful, this operation creates a new Fleet resource and places
808
825
  # it in `NEW` status, which prompts GameLift to initiate the [fleet
809
826
  # creation workflow][1]. You can track fleet creation by checking fleet
@@ -878,11 +895,11 @@ module Aws::GameLift
878
895
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api-ref.html#gamelift-sdk-server-api-ref-dataypes-process
879
896
  #
880
897
  # @option params [required, String] :ec2_instance_type
881
- # The GameLift-supported EC2 instance type to use for all fleet
898
+ # The GameLift-supported Amazon EC2 instance type to use for all fleet
882
899
  # instances. Instance type determines the computing resources that will
883
900
  # be used to host your game servers, including CPU, memory, storage, and
884
- # networking capacity. See [Amazon EC2 Instance Types][1] for detailed
885
- # 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.
886
903
  #
887
904
  #
888
905
  #
@@ -927,23 +944,24 @@ module Aws::GameLift
927
944
  # of time.
928
945
  #
929
946
  # @option params [Array<String>] :metric_groups
930
- # The name of an AWS CloudWatch metric group to add this fleet to. A
931
- # metric group is used to aggregate the metrics for multiple fleets. You
932
- # can specify an existing metric group name or set a new name to create
933
- # a new metric group. A fleet can be included in only one metric group
934
- # 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.
935
952
  #
936
953
  # @option params [String] :peer_vpc_aws_account_id
937
954
  # Used when peering your GameLift fleet with a VPC, the unique
938
- # identifier for the AWS account that owns the VPC. You can find your
939
- # 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.
940
958
  #
941
959
  # @option params [String] :peer_vpc_id
942
960
  # A unique identifier for a VPC with resources to be accessed by your
943
961
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
944
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
945
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
946
- # 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].
947
965
  #
948
966
  #
949
967
  #
@@ -961,15 +979,15 @@ module Aws::GameLift
961
979
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
962
980
  #
963
981
  # @option params [String] :instance_role_arn
964
- # A unique identifier for an AWS IAM role that manages access to your
965
- # AWS services. With an instance role ARN set, any application that runs
966
- # on an instance in this fleet can assume the role, including install
967
- # scripts, server processes, and daemons (background processes). Create
968
- # a role or look up a role's ARN by using the [IAM dashboard][1] in the
969
- # AWS Management Console. Learn more about using on-box credentials for
970
- # your game servers at [ Access external resources from a game
971
- # server][2]. This property cannot be changed after the fleet is
972
- # 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.
973
991
  #
974
992
  #
975
993
  #
@@ -980,35 +998,33 @@ module Aws::GameLift
980
998
  # Prompts GameLift to generate a TLS/SSL certificate for the fleet. TLS
981
999
  # certificates are used for encrypting traffic between game clients and
982
1000
  # the game servers that are running on GameLift. By default, the
983
- # `CertificateConfiguration` is set to `DISABLED`. Learn more at
984
- # [Securing Client/Server Communication][1]. This property cannot be
985
- # changed after the fleet is created.
986
- #
987
- # Note: This feature requires the AWS Certificate Manager (ACM) service,
988
- # which is not available in all AWS regions. When working in a region
989
- # that does not support this feature, a fleet creation request with
990
- # certificate generation fails with a 4xx error.
1001
+ # `CertificateConfiguration` is set to `DISABLED`. This property cannot
1002
+ # be changed after the fleet is created.
991
1003
  #
992
- #
993
- #
994
- # [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.
995
1009
  #
996
1010
  # @option params [Array<Types::LocationConfiguration>] :locations
997
1011
  # A set of remote locations to deploy additional instances to and manage
998
1012
  # as part of the fleet. This parameter can only be used when creating
999
- # fleets in AWS Regions that support multiple locations. You can add any
1000
- # GameLift-supported AWS Region as a remote location, in the form of an
1001
- # AWS Region code such as `us-west-2`. To create a fleet with instances
1002
- # 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.
1003
1018
  #
1004
1019
  # @option params [Array<Types::Tag>] :tags
1005
1020
  # A list of labels to assign to the new fleet resource. Tags are
1006
- # developer-defined key-value pairs. Tagging AWS resources are useful
1007
- # for resource management, access management and cost allocation. For
1008
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
1009
- # Reference*. Once the fleet is created, you can use TagResource,
1010
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
1011
- # 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
1012
1028
  # Reference* for actual tagging limits.
1013
1029
  #
1014
1030
  #
@@ -1125,9 +1141,9 @@ module Aws::GameLift
1125
1141
  #
1126
1142
  # <note markdown="1"> This operation cannot be used with fleets that don't support remote
1127
1143
  # locations. Fleets can have multiple locations only if they reside in
1128
- # AWS Regions that support this feature (see CreateFleet for the
1129
- # complete list) and were created after the feature was released in
1130
- # 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.
1131
1147
  #
1132
1148
  # </note>
1133
1149
  #
@@ -1168,9 +1184,9 @@ module Aws::GameLift
1168
1184
  #
1169
1185
  # @option params [required, Array<Types::LocationConfiguration>] :locations
1170
1186
  # A list of locations to deploy additional instances to and manage as
1171
- # part of the fleet. You can add any GameLift-supported AWS Region as a
1172
- # remote location, in the form of an AWS Region code such as
1173
- # `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`.
1174
1190
  #
1175
1191
  # @return [Types::CreateFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1176
1192
  #
@@ -1210,31 +1226,33 @@ module Aws::GameLift
1210
1226
  # server groups.**
1211
1227
  #
1212
1228
  # Creates a GameLift FleetIQ game server group for managing game hosting
1213
- # on a collection of Amazon EC2 instances for game hosting. This
1214
- # operation creates the game server group, creates an Auto Scaling group
1215
- # in your AWS account, and establishes a link between the two groups.
1216
- # You can view the status of your game server groups in the GameLift
1217
- # console. Game server group metrics and events are emitted to Amazon
1218
- # 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.
1219
1235
  #
1220
1236
  # Before creating a new game server group, you must have the following:
1221
1237
  #
1222
- # * An Amazon EC2 launch template that specifies how to launch Amazon
1223
- # EC2 instances with your game server build. For more information, see
1224
- # [ Launching an Instance from a Launch Template][1] in the *Amazon
1225
- # 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*.
1226
1243
  #
1227
- # * An IAM role that extends limited access to your AWS account to allow
1228
- # GameLift FleetIQ to create and interact with the Auto Scaling group.
1229
- # For more information, see [Create IAM roles for cross-service
1230
- # 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*.
1231
1249
  #
1232
1250
  # To create a new game server group, specify a unique group name, IAM
1233
- # role and Amazon EC2 launch template, and provide a list of instance
1234
- # types that can be used in the group. You must also set initial maximum
1235
- # and minimum limits on the group's instance count. You can optionally
1236
- # set an Auto Scaling policy with target tracking based on a GameLift
1237
- # 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.
1238
1256
  #
1239
1257
  # Once the game server group and corresponding Auto Scaling group are
1240
1258
  # created, you have full access to change the Auto Scaling group's
@@ -1266,41 +1284,42 @@ module Aws::GameLift
1266
1284
  #
1267
1285
  # @option params [required, String] :game_server_group_name
1268
1286
  # An identifier for the new game server group. This value is used to
1269
- # generate unique ARN identifiers for the EC2 Auto Scaling group and the
1270
- # GameLift FleetIQ game server group. The name must be unique per Region
1271
- # 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.
1272
1290
  #
1273
1291
  # @option params [required, String] :role_arn
1274
1292
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
1275
- # GameLift to access your EC2 Auto Scaling groups.
1293
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
1276
1294
  #
1277
1295
  #
1278
1296
  #
1279
1297
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
1280
1298
  #
1281
1299
  # @option params [required, Integer] :min_size
1282
- # The minimum number of instances allowed in the EC2 Auto Scaling group.
1283
- # During automatic scaling events, GameLift FleetIQ and EC2 do not scale
1284
- # down the group below this minimum. In production, this value should be
1285
- # set to at least 1. After the Auto Scaling group is created, update
1286
- # this value directly in the Auto Scaling group using the AWS console or
1287
- # 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.
1288
1306
  #
1289
1307
  # @option params [required, Integer] :max_size
1290
- # The maximum number of instances allowed in the EC2 Auto Scaling group.
1291
- # During automatic scaling events, GameLift FleetIQ and EC2 do not scale
1292
- # up the group above this maximum. After the Auto Scaling group is
1293
- # created, update this value directly in the Auto Scaling group using
1294
- # 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.
1295
1313
  #
1296
1314
  # @option params [required, Types::LaunchTemplateSpecification] :launch_template
1297
- # The EC2 launch template that contains configuration settings and game
1298
- # server code to be deployed to all instances in the game server group.
1299
- # You can specify the template using either the template name or ID. For
1300
- # help with creating a launch template, see [Creating a Launch Template
1301
- # for an Auto Scaling Group][1] in the *Amazon EC2 Auto Scaling User
1302
- # Guide*. After the Auto Scaling group is created, update this value
1303
- # 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.
1304
1323
  #
1305
1324
  # <note markdown="1"> If you specify network interfaces in your launch template, you must
1306
1325
  # explicitly set the property `AssociatePublicIpAddress` to "true". If
@@ -1314,15 +1333,16 @@ module Aws::GameLift
1314
1333
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
1315
1334
  #
1316
1335
  # @option params [required, Array<Types::InstanceDefinition>] :instance_definitions
1317
- # The EC2 instance types and sizes to use in the Auto Scaling group. The
1318
- # instance definitions must specify at least two different instance
1319
- # types that are supported by GameLift FleetIQ. For more information on
1320
- # instance types, see [EC2 Instance Types][1] in the *Amazon EC2 User
1321
- # Guide*. You can optionally specify capacity weighting for each
1322
- # instance type. If no weight value is specified for an instance type,
1323
- # it is set to the default value "1". For more information about
1324
- # capacity weighting, see [ Instance Weighting for Amazon EC2 Auto
1325
- # 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.
1326
1346
  #
1327
1347
  #
1328
1348
  #
@@ -1335,7 +1355,7 @@ module Aws::GameLift
1335
1355
  # metric `"PercentUtilizedGameServers"` to maintain a buffer of idle
1336
1356
  # game servers that can immediately accommodate new games and players.
1337
1357
  # After the Auto Scaling group is created, update this value directly in
1338
- # the Auto Scaling group using the AWS console or APIs.
1358
+ # the Auto Scaling group using the Amazon Web Services console or APIs.
1339
1359
  #
1340
1360
  # @option params [String] :balancing_strategy
1341
1361
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -1368,8 +1388,8 @@ module Aws::GameLift
1368
1388
  # instances cannot be terminated while there are active game servers
1369
1389
  # running except in the event of a forced game server group deletion
1370
1390
  # (see ). An exception to this is with Spot Instances, which can be
1371
- # terminated by AWS regardless of protection status. This property is
1372
- # 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.
1373
1393
  #
1374
1394
  # @option params [Array<String>] :vpc_subnets
1375
1395
  # A list of virtual private cloud (VPC) subnets to use with instances in
@@ -1382,13 +1402,14 @@ module Aws::GameLift
1382
1402
  #
1383
1403
  # @option params [Array<Types::Tag>] :tags
1384
1404
  # A list of labels to assign to the new game server group resource. Tags
1385
- # are developer-defined key-value pairs. Tagging AWS resources is useful
1386
- # for resource management, access management, and cost allocation. For
1387
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
1388
- # Reference*. Once the resource is created, you can use TagResource,
1389
- # UntagResource, and ListTagsForResource to add, remove, and view tags,
1390
- # respectively. The maximum tag limit may be lower than stated. See the
1391
- # 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.
1392
1413
  #
1393
1414
  #
1394
1415
  #
@@ -1497,7 +1518,7 @@ module Aws::GameLift
1497
1518
  # days. To access the logs, call GetGameSessionLogUrl to download the
1498
1519
  # log files.
1499
1520
  #
1500
- # *Available in GameLift Local.*
1521
+ # *Available in Amazon Web Services Local.*
1501
1522
  #
1502
1523
  # **Learn more**
1503
1524
  #
@@ -1537,7 +1558,12 @@ module Aws::GameLift
1537
1558
  # @option params [Array<Types::GameProperty>] :game_properties
1538
1559
  # A set of custom properties for a game session, formatted as key:value
1539
1560
  # pairs. These properties are passed to a game server process in the
1540
- # 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
1541
1567
  #
1542
1568
  # @option params [String] :creator_id
1543
1569
  # A unique identifier for a player or entity creating the game session.
@@ -1569,13 +1595,18 @@ module Aws::GameLift
1569
1595
  # @option params [String] :game_session_data
1570
1596
  # A set of custom game session properties, formatted as a single string
1571
1597
  # value. This data is passed to a game server process in the GameSession
1572
- # 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
1573
1604
  #
1574
1605
  # @option params [String] :location
1575
1606
  # A fleet's remote location to place the new game session in. If this
1576
1607
  # parameter is not set, the new game session is placed in the fleet's
1577
- # home Region. Specify a remote location with an AWS Region code such as
1578
- # `us-west-2`.
1608
+ # home Region. Specify a remote location with an Amazon Web Services
1609
+ # Region code such as `us-west-2`.
1579
1610
  #
1580
1611
  # @return [Types::CreateGameSessionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1581
1612
  #
@@ -1642,10 +1673,10 @@ module Aws::GameLift
1642
1673
  # A game session queue is configured with a set of destinations
1643
1674
  # (GameLift fleets or aliases), which determine the locations where the
1644
1675
  # queue can place new game sessions. These destinations can span
1645
- # multiple fleet types (Spot and On-Demand), instance types, and AWS
1646
- # Regions. If the queue includes multi-location fleets, the queue is
1647
- # able to place game sessions in all of a fleet's remote locations. You
1648
- # 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.
1649
1680
  #
1650
1681
  # The queue configuration also determines how FleetIQ selects the best
1651
1682
  # available placement for a new game session. Before searching for an
@@ -1664,26 +1695,32 @@ module Aws::GameLift
1664
1695
  #
1665
1696
  # If successful, a new `GameSessionQueue` object is returned with an
1666
1697
  # assigned queue ARN. New game session requests, which are submitted to
1667
- # the queue with StartGameSessionPlacement or StartMatchmaking,
1698
+ # queue with [StartGameSessionPlacement][1] or [StartMatchmaking][2],
1668
1699
  # reference a queue's name or ARN.
1669
1700
  #
1670
1701
  # **Learn more**
1671
1702
  #
1672
- # [ Design a game session queue][1]
1703
+ # [ Design a game session queue][3]
1673
1704
  #
1674
- # [ Create a game session queue][2]
1705
+ # [ Create a game session queue][4]
1675
1706
  #
1676
1707
  # **Related actions**
1677
1708
  #
1678
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
1679
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
1680
- # task][3]
1709
+ # [CreateGameSessionQueue][5] \| [DescribeGameSessionQueues][6] \|
1710
+ # [UpdateGameSessionQueue][7] \| [DeleteGameSessionQueue][8] \| [All
1711
+ # APIs by task][9]
1681
1712
  #
1682
1713
  #
1683
1714
  #
1684
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-design.html
1685
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html
1686
- # [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
1687
1724
  #
1688
1725
  # @option params [required, String] :name
1689
1726
  # A descriptive label that is associated with game session queue. Queue
@@ -1711,9 +1748,9 @@ module Aws::GameLift
1711
1748
  #
1712
1749
  # @option params [Types::FilterConfiguration] :filter_configuration
1713
1750
  # A list of locations where a queue is allowed to place new game
1714
- # sessions. Locations are specified in the form of AWS Region codes,
1715
- # such as `us-west-2`. If this parameter is not set, game sessions can
1716
- # 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.
1717
1754
  #
1718
1755
  # @option params [Types::PriorityConfiguration] :priority_configuration
1719
1756
  # Custom settings to use when prioritizing destinations and locations
@@ -1737,13 +1774,14 @@ module Aws::GameLift
1737
1774
  #
1738
1775
  # @option params [Array<Types::Tag>] :tags
1739
1776
  # A list of labels to assign to the new game session queue resource.
1740
- # Tags are developer-defined key-value pairs. Tagging AWS resources are
1741
- # useful for resource management, access management and cost allocation.
1742
- # For more information, see [ Tagging AWS Resources][1] in the *AWS
1743
- # General Reference*. Once the resource is created, you can use
1744
- # TagResource, UntagResource, and ListTagsForResource to add, remove,
1745
- # and view tags. The maximum tag limit may be lower than stated. See the
1746
- # 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.
1747
1785
  #
1748
1786
  #
1749
1787
  #
@@ -1834,10 +1872,10 @@ module Aws::GameLift
1834
1872
  # queue to use when starting a game session for the match.
1835
1873
  #
1836
1874
  # In addition, you must set up an Amazon Simple Notification Service
1837
- # (SNS) topic to receive matchmaking notifications. Provide the topic
1838
- # ARN in the matchmaking configuration. An alternative method,
1839
- # continuously polling ticket status with DescribeMatchmaking, is only
1840
- # 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.
1841
1879
  #
1842
1880
  # **Learn more**
1843
1881
  #
@@ -1978,13 +2016,14 @@ module Aws::GameLift
1978
2016
  #
1979
2017
  # @option params [Array<Types::Tag>] :tags
1980
2018
  # A list of labels to assign to the new matchmaking configuration
1981
- # resource. Tags are developer-defined key-value pairs. Tagging AWS
1982
- # resources are useful for resource management, access management and
1983
- # cost allocation. For more information, see [ Tagging AWS Resources][1]
1984
- # in the *AWS General Reference*. Once the resource is created, you can
1985
- # use TagResource, UntagResource, and ListTagsForResource to add,
1986
- # remove, and view tags. The maximum tag limit may be lower than stated.
1987
- # 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.
1988
2027
  #
1989
2028
  #
1990
2029
  #
@@ -2106,13 +2145,14 @@ module Aws::GameLift
2106
2145
  #
2107
2146
  # @option params [Array<Types::Tag>] :tags
2108
2147
  # A list of labels to assign to the new matchmaking rule set resource.
2109
- # Tags are developer-defined key-value pairs. Tagging AWS resources are
2110
- # useful for resource management, access management and cost allocation.
2111
- # For more information, see [ Tagging AWS Resources][1] in the *AWS
2112
- # General Reference*. Once the resource is created, you can use
2113
- # TagResource, UntagResource, and ListTagsForResource to add, remove,
2114
- # and view tags. The maximum tag limit may be lower than stated. See the
2115
- # 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.
2116
2156
  #
2117
2157
  #
2118
2158
  #
@@ -2167,7 +2207,10 @@ module Aws::GameLift
2167
2207
  # validate the player reservation with the GameLift service. Player
2168
2208
  # sessions cannot be updated.
2169
2209
  #
2170
- # *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.*
2171
2214
  #
2172
2215
  # **Related actions**
2173
2216
  #
@@ -2242,7 +2285,10 @@ module Aws::GameLift
2242
2285
  # to validate the player reservation with the GameLift service. Player
2243
2286
  # sessions cannot be updated.
2244
2287
  #
2245
- # *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.*
2246
2292
  #
2247
2293
  # **Related actions**
2248
2294
  #
@@ -2262,10 +2308,10 @@ module Aws::GameLift
2262
2308
  #
2263
2309
  # @option params [Hash<String,String>] :player_data_map
2264
2310
  # Map of string pairs, each specifying a player ID and a set of
2265
- # developer-defined information related to the player. Amazon GameLift
2266
- # does not use this data, so it can be formatted as needed for use in
2267
- # the game. Any player data strings for player IDs that are not included
2268
- # 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.
2269
2315
  #
2270
2316
  # @return [Types::CreatePlayerSessionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2271
2317
  #
@@ -2320,23 +2366,24 @@ module Aws::GameLift
2320
2366
  # * A locally available directory. Use the *ZipFile* parameter for this
2321
2367
  # option.
2322
2368
  #
2323
- # * An Amazon Simple Storage Service (Amazon S3) bucket under your AWS
2324
- # account. Use the *StorageLocation* parameter for this option.
2325
- # You'll need to have an Identity Access Management (IAM) role that
2326
- # 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.
2327
2374
  #
2328
2375
  # If the call is successful, a new script record is created with a
2329
2376
  # unique script ID. If the script file is provided as a local file, the
2330
- # file is uploaded to an Amazon GameLift-owned S3 bucket and the script
2331
- # record's storage location reflects this location. If the script file
2332
- # is provided as an S3 bucket, Amazon GameLift accesses the file at this
2333
- # 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.
2334
2381
  #
2335
2382
  # **Learn more**
2336
2383
  #
2337
- # [Amazon GameLift Realtime Servers][1]
2384
+ # [Amazon Web Services Realtime Servers][1]
2338
2385
  #
2339
- # [Set Up a Role for Amazon GameLift Access][2]
2386
+ # [Set Up a Role for Amazon Web Services Access][2]
2340
2387
  #
2341
2388
  # **Related actions**
2342
2389
  #
@@ -2363,30 +2410,32 @@ module Aws::GameLift
2363
2410
  # The location of the Amazon S3 bucket where a zipped file containing
2364
2411
  # your Realtime scripts is stored. The storage location must specify the
2365
2412
  # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
2366
- # that allows Amazon GameLift to access the Amazon S3 storage location.
2367
- # The S3 bucket must be in the same Region where you want to create a
2368
- # new script. By default, Amazon GameLift uploads the latest version of
2369
- # the zip file; if you have S3 object versioning turned on, you can use
2370
- # 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.
2371
2419
  #
2372
2420
  # @option params [String, StringIO, File] :zip_file
2373
2421
  # A data object containing your Realtime scripts and dependencies as a
2374
2422
  # zip file. The zip file can have one or multiple files. Maximum size of
2375
2423
  # a zip file is 5 MB.
2376
2424
  #
2377
- # When using the AWS CLI tool to create a script, this parameter is set
2378
- # to the zip file name. It must be prepended with the string
2379
- # "fileb://" to indicate that the file data is a binary object. For
2380
- # 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`.
2381
2429
  #
2382
2430
  # @option params [Array<Types::Tag>] :tags
2383
2431
  # A list of labels to assign to the new script resource. Tags are
2384
- # developer-defined key-value pairs. Tagging AWS resources are useful
2385
- # for resource management, access management and cost allocation. For
2386
- # more information, see [ Tagging AWS Resources][1] in the *AWS General
2387
- # Reference*. Once the resource is created, you can use TagResource,
2388
- # UntagResource, and ListTagsForResource to add, remove, and view tags.
2389
- # 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
2390
2439
  # Reference for actual tagging limits.
2391
2440
  #
2392
2441
  #
@@ -2440,32 +2489,35 @@ module Aws::GameLift
2440
2489
  end
2441
2490
 
2442
2491
  # Requests authorization to create or delete a peer connection between
2443
- # the VPC for your Amazon GameLift fleet and a virtual private cloud
2444
- # (VPC) in your AWS account. VPC peering enables the game servers on
2445
- # your fleet to communicate directly with other AWS resources. Once
2446
- # you've received authorization, call CreateVpcPeeringConnection to
2447
- # establish the peering connection. For more information, see [VPC
2448
- # Peering with Amazon GameLift Fleets][1].
2449
- #
2450
- # You can peer with VPCs that are owned by any AWS account you have
2451
- # access to, including the account that you use to manage your Amazon
2452
- # GameLift fleets. You cannot peer with VPCs that are in different
2453
- # 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.
2454
2504
  #
2455
2505
  # To request authorization to create a connection, call this operation
2456
- # from the AWS account with the VPC that you want to peer to your Amazon
2457
- # GameLift fleet. For example, to enable your game servers to retrieve
2458
- # data from a DynamoDB table, use the account that manages that DynamoDB
2459
- # resource. Identify the following values: (1) The ID of the VPC that
2460
- # you want to peer with, and (2) the ID of the AWS account that you use
2461
- # to manage Amazon GameLift. If successful, VPC peering is authorized
2462
- # 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.
2463
2514
  #
2464
2515
  # To request authorization to delete a connection, call this operation
2465
- # from the AWS account with the VPC that is peered with your Amazon
2466
- # GameLift fleet. Identify the following values: (1) VPC ID that you
2467
- # want to delete the peering connection for, and (2) ID of the AWS
2468
- # 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.
2469
2521
  #
2470
2522
  # The authorization remains valid for 24 hours unless it is canceled by
2471
2523
  # a call to DeleteVpcPeeringAuthorization. You must create or delete the
@@ -2484,16 +2536,16 @@ module Aws::GameLift
2484
2536
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2485
2537
  #
2486
2538
  # @option params [required, String] :game_lift_aws_account_id
2487
- # A unique identifier for the AWS account that you use to manage your
2488
- # GameLift fleet. You can find your Account ID in the AWS Management
2489
- # 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.
2490
2542
  #
2491
2543
  # @option params [required, String] :peer_vpc_id
2492
2544
  # A unique identifier for a VPC with resources to be accessed by your
2493
2545
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
2494
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
2495
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
2496
- # 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].
2497
2549
  #
2498
2550
  #
2499
2551
  #
@@ -2529,13 +2581,14 @@ module Aws::GameLift
2529
2581
  end
2530
2582
 
2531
2583
  # Establishes a VPC peering connection between a virtual private cloud
2532
- # (VPC) in an AWS account with the VPC for your Amazon GameLift fleet.
2533
- # VPC peering enables the game servers on your fleet to communicate
2534
- # directly with other AWS resources. You can peer with VPCs in any AWS
2535
- # account that you have access to, including the account that you use to
2536
- # manage your Amazon GameLift fleets. You cannot peer with VPCs that are
2537
- # in different Regions. For more information, see [VPC Peering with
2538
- # 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].
2539
2592
  #
2540
2593
  # Before calling this operation to establish the peering connection, you
2541
2594
  # first need to call CreateVpcPeeringAuthorization and identify the VPC
@@ -2544,16 +2597,16 @@ module Aws::GameLift
2544
2597
  # operations handle all tasks necessary to peer the two VPCs, including
2545
2598
  # acceptance, updating routing tables, etc.
2546
2599
  #
2547
- # To establish the connection, call this operation from the AWS account
2548
- # that is used to manage the Amazon GameLift fleets. Identify the
2549
- # following values: (1) The ID of the fleet you want to be enable a VPC
2550
- # peering connection for; (2) The AWS account with the VPC that you want
2551
- # to peer with; and (3) The ID of the VPC you want to peer with. This
2552
- # operation is asynchronous. If successful, a VpcPeeringConnection
2553
- # request is created. You can use continuous polling to track the
2554
- # request's status using DescribeVpcPeeringConnections, or by
2555
- # monitoring fleet events for success or failure using
2556
- # 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.
2557
2610
  #
2558
2611
  # **Related actions**
2559
2612
  #
@@ -2569,19 +2622,21 @@ module Aws::GameLift
2569
2622
  #
2570
2623
  # @option params [required, String] :fleet_id
2571
2624
  # A unique identifier for the fleet. You can use either the fleet ID or
2572
- # 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.
2573
2627
  #
2574
2628
  # @option params [required, String] :peer_vpc_aws_account_id
2575
- # A unique identifier for the AWS account with the VPC that you want to
2576
- # peer your Amazon GameLift fleet with. You can find your Account ID in
2577
- # 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.
2578
2633
  #
2579
2634
  # @option params [required, String] :peer_vpc_id
2580
2635
  # A unique identifier for a VPC with resources to be accessed by your
2581
2636
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
2582
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
2583
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
2584
- # 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].
2585
2640
  #
2586
2641
  #
2587
2642
  #
@@ -2774,7 +2829,7 @@ module Aws::GameLift
2774
2829
  #
2775
2830
  # @option params [required, Array<String>] :locations
2776
2831
  # The list of fleet locations to delete. Specify locations in the form
2777
- # of an AWS Region code, such as `us-west-2`.
2832
+ # of an Amazon Web Services Region code, such as `us-west-2`.
2778
2833
  #
2779
2834
  # @return [Types::DeleteFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2780
2835
  #
@@ -2860,16 +2915,16 @@ module Aws::GameLift
2860
2915
  # @option params [String] :delete_option
2861
2916
  # The type of delete to perform. Options include the following:
2862
2917
  #
2863
- # * `SAFE_DELETE` – (default) Terminates the game server group and EC2
2864
- # Auto Scaling group only when it has no game servers that are in
2865
- # `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.
2866
2921
  #
2867
2922
  # * `FORCE_DELETE` – Terminates the game server group, including all
2868
2923
  # active game servers regardless of their utilization status, and the
2869
- # EC2 Auto Scaling group.
2924
+ # Amazon EC2 Auto Scaling group.
2870
2925
  #
2871
2926
  # * `RETAIN` – Does a safe delete of the game server group but retains
2872
- # the EC2 Auto Scaling group as is.
2927
+ # the Amazon EC2 Auto Scaling group as is.
2873
2928
  #
2874
2929
  # @return [Types::DeleteGameServerGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2875
2930
  #
@@ -2910,23 +2965,28 @@ module Aws::GameLift
2910
2965
  end
2911
2966
 
2912
2967
  # Deletes a game session queue. Once a queue is successfully deleted,
2913
- # unfulfilled StartGameSessionPlacement requests that reference the
2968
+ # unfulfilled [StartGameSessionPlacement][1] requests that reference the
2914
2969
  # queue will fail. To delete a queue, specify the queue name.
2915
2970
  #
2916
2971
  # **Learn more**
2917
2972
  #
2918
- # [ Using Multi-Region Queues][1]
2973
+ # [ Using Multi-Region Queues][2]
2919
2974
  #
2920
2975
  # **Related actions**
2921
2976
  #
2922
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
2923
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
2924
- # task][2]
2977
+ # [CreateGameSessionQueue][3] \| [DescribeGameSessionQueues][4] \|
2978
+ # [UpdateGameSessionQueue][5] \| [DeleteGameSessionQueue][6] \| [All
2979
+ # APIs by task][7]
2925
2980
  #
2926
2981
  #
2927
2982
  #
2928
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
2929
- # [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
2930
2990
  #
2931
2991
  # @option params [required, String] :name
2932
2992
  # A descriptive label that is associated with game session queue. Queue
@@ -3089,7 +3149,7 @@ module Aws::GameLift
3089
3149
  #
3090
3150
  # **Learn more**
3091
3151
  #
3092
- # [Amazon GameLift Realtime Servers][1]
3152
+ # [Amazon Web Services Realtime Servers][1]
3093
3153
  #
3094
3154
  # **Related actions**
3095
3155
  #
@@ -3138,16 +3198,16 @@ module Aws::GameLift
3138
3198
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3139
3199
  #
3140
3200
  # @option params [required, String] :game_lift_aws_account_id
3141
- # A unique identifier for the AWS account that you use to manage your
3142
- # GameLift fleet. You can find your Account ID in the AWS Management
3143
- # 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.
3144
3204
  #
3145
3205
  # @option params [required, String] :peer_vpc_id
3146
3206
  # A unique identifier for a VPC with resources to be accessed by your
3147
3207
  # GameLift fleet. The VPC must be in the same Region as your fleet. To
3148
- # look up a VPC ID, use the [VPC Dashboard][1] in the AWS Management
3149
- # Console. Learn more about VPC peering in [VPC Peering with GameLift
3150
- # 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].
3151
3211
  #
3152
3212
  #
3153
3213
  #
@@ -3178,10 +3238,10 @@ module Aws::GameLift
3178
3238
  # DescribeVpcPeeringAuthorizations or request a new one using
3179
3239
  # CreateVpcPeeringAuthorization.
3180
3240
  #
3181
- # Once a valid authorization exists, call this operation from the AWS
3182
- # account that is used to manage the Amazon GameLift fleets. Identify
3183
- # the connection to delete by the connection ID and fleet ID. If
3184
- # 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.
3185
3245
  #
3186
3246
  # **Related actions**
3187
3247
  #
@@ -3377,22 +3437,23 @@ module Aws::GameLift
3377
3437
  req.send_request(options)
3378
3438
  end
3379
3439
 
3380
- # The GameLift service limits and current utilization for an AWS Region
3381
- # or location. Instance limits control the number of instances, per
3382
- # instance type, per location, that your AWS account can use. Learn more
3383
- # at [Amazon EC2 Instance Types][1]. The information returned includes
3384
- # the maximum number of instances allowed and your account's current
3385
- # usage across all fleets. This information can affect your ability to
3386
- # scale your GameLift fleets. You can request a limit increase for your
3387
- # account by using the **Service limits** page in the GameLift console.
3440
+ # Retrieves the instance limits and current utilization for an Amazon
3441
+ # Web 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.
3388
3449
  #
3389
3450
  # Instance limits differ based on whether the instances are deployed in
3390
3451
  # a fleet's home Region or in a remote location. For remote locations,
3391
3452
  # limits also differ based on the combination of home Region and remote
3392
- # location. All requests must specify an AWS Region (either explicitly
3393
- # or as your default settings). To get the limit for a remote location,
3394
- # you must also specify the location. For example, the following
3395
- # 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:
3396
3457
  #
3397
3458
  # * Request specifies the Region `ap-northeast-1` with no location. The
3398
3459
  # result is limits and usage data on all instance types that are
@@ -3413,14 +3474,15 @@ module Aws::GameLift
3413
3474
  # This operation can be used in the following ways:
3414
3475
  #
3415
3476
  # * To get limit and usage data for all instance types that are deployed
3416
- # in an AWS Region by fleets that reside in the same Region: Specify
3417
- # the Region only. Optionally, specify a single instance type to
3418
- # 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.
3419
3480
  #
3420
3481
  # * To get limit and usage data for all instance types that are deployed
3421
- # to a remote location by fleets that reside in different AWS Region:
3422
- # Provide both the AWS Region and the remote location. Optionally,
3423
- # 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.
3424
3486
  #
3425
3487
  # If successful, an `EC2InstanceLimits` object is returned with limits
3426
3488
  # and usage data for each requested instance type.
@@ -3443,15 +3505,15 @@ module Aws::GameLift
3443
3505
  # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3444
3506
  #
3445
3507
  # @option params [String] :ec2_instance_type
3446
- # Name of an EC2 instance type that is supported in GameLift. A fleet
3447
- # instance type determines the computing resources of each instance in
3448
- # the fleet, including CPU, memory, storage, and networking capacity. Do
3449
- # not specify a value for this parameter to retrieve limits for all
3450
- # 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.
3451
3513
  #
3452
3514
  # @option params [String] :location
3453
3515
  # The name of a remote location to request instance limits for, in the
3454
- # 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`.
3455
3517
  #
3456
3518
  # @return [Types::DescribeEC2InstanceLimitsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3457
3519
  #
@@ -3839,7 +3901,8 @@ module Aws::GameLift
3839
3901
  #
3840
3902
  # @option params [Array<String>] :locations
3841
3903
  # A list of fleet locations to retrieve information for. Specify
3842
- # 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`.
3843
3906
  #
3844
3907
  # @option params [Integer] :limit
3845
3908
  # The maximum number of results to return. Use this parameter with
@@ -3929,7 +3992,8 @@ module Aws::GameLift
3929
3992
  #
3930
3993
  # @option params [required, String] :location
3931
3994
  # The fleet location to retrieve capacity information for. Specify a
3932
- # 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`.
3933
3997
  #
3934
3998
  # @return [Types::DescribeFleetLocationCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3935
3999
  #
@@ -4002,7 +4066,8 @@ module Aws::GameLift
4002
4066
  #
4003
4067
  # @option params [required, String] :location
4004
4068
  # The fleet location to retrieve utilization information for. Specify a
4005
- # 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`.
4006
4071
  #
4007
4072
  # @return [Types::DescribeFleetLocationUtilizationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4008
4073
  #
@@ -4077,7 +4142,7 @@ module Aws::GameLift
4077
4142
  #
4078
4143
  # @option params [String] :location
4079
4144
  # A remote location to check for status of port setting updates. Use the
4080
- # AWS Region code format, such as `us-west-2`.
4145
+ # Amazon Web Services Region code format, such as `us-west-2`.
4081
4146
  #
4082
4147
  # @return [Types::DescribeFleetPortSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4083
4148
  #
@@ -4398,10 +4463,10 @@ module Aws::GameLift
4398
4463
  # GameServerGroup name or ARN value.
4399
4464
  #
4400
4465
  # @option params [Array<String>] :instance_ids
4401
- # The EC2 instance IDs that you want to retrieve status on. EC2 instance
4402
- # IDs use a 17-character format, for example: `i-1234567890abcdef0`. To
4403
- # retrieve all instances in the game server group, leave this parameter
4404
- # 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.
4405
4470
  #
4406
4471
  # @option params [Integer] :limit
4407
4472
  # The maximum number of results to return. Use this parameter with
@@ -4469,7 +4534,8 @@ module Aws::GameLift
4469
4534
  #
4470
4535
  # * To retrieve details for a specific game session, provide the game
4471
4536
  # session ID. This approach looks for the game session ID in all
4472
- # 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.
4473
4539
  #
4474
4540
  # Use the pagination parameters to retrieve results as a set of
4475
4541
  # sequential pages.
@@ -4508,8 +4574,8 @@ module Aws::GameLift
4508
4574
  #
4509
4575
  # @option params [String] :location
4510
4576
  # A fleet location to get game sessions for. You can specify a fleet's
4511
- # home Region or a remote location. Use the AWS Region code format, such
4512
- # 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`.
4513
4579
  #
4514
4580
  # @option params [String] :status_filter
4515
4581
  # Game session status to filter results on. Possible game session
@@ -4586,6 +4652,14 @@ module Aws::GameLift
4586
4652
  #
4587
4653
  # To get game session placement details, specify the placement ID.
4588
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
+ #
4589
4663
  # If successful, a GameSessionPlacement object is returned.
4590
4664
  #
4591
4665
  # **Related actions**
@@ -4663,14 +4737,18 @@ module Aws::GameLift
4663
4737
  #
4664
4738
  # **Related actions**
4665
4739
  #
4666
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
4667
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
4668
- # task][2]
4740
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
4741
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
4742
+ # APIs by task][6]
4669
4743
  #
4670
4744
  #
4671
4745
  #
4672
4746
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-console.html
4673
- # [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
4674
4752
  #
4675
4753
  # @option params [Array<String>] :names
4676
4754
  # A list of queue names to retrieve information for. You can use either
@@ -4740,6 +4818,14 @@ module Aws::GameLift
4740
4818
  # retrieve the protection policy for game sessions, use
4741
4819
  # DescribeGameSessionDetails.
4742
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
+ #
4743
4829
  # This operation can be used in the following ways:
4744
4830
  #
4745
4831
  # * To retrieve all game sessions that are currently running on all
@@ -4754,7 +4840,7 @@ module Aws::GameLift
4754
4840
  #
4755
4841
  # * To retrieve a specific game session, provide the game session ID.
4756
4842
  # This approach looks for the game session ID in all fleets that
4757
- # reside in the AWS Region defined in the request.
4843
+ # reside in the Amazon Web Services Region defined in the request.
4758
4844
  #
4759
4845
  # Use the pagination parameters to retrieve results as a set of
4760
4846
  # sequential pages.
@@ -4762,7 +4848,15 @@ module Aws::GameLift
4762
4848
  # If successful, a `GameSession` object is returned for each game
4763
4849
  # session that matches the request.
4764
4850
  #
4765
- # *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.*
4766
4860
  #
4767
4861
  # **Learn more**
4768
4862
  #
@@ -4795,8 +4889,8 @@ module Aws::GameLift
4795
4889
  #
4796
4890
  # @option params [String] :location
4797
4891
  # A fleet location to get game session details for. You can specify a
4798
- # fleet's home Region or a remote location. Use the AWS Region code
4799
- # 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`.
4800
4894
  #
4801
4895
  # @option params [String] :status_filter
4802
4896
  # Game session status to filter results on. You can filter on the
@@ -4925,7 +5019,7 @@ module Aws::GameLift
4925
5019
  #
4926
5020
  # @option params [String] :location
4927
5021
  # The name of a location to retrieve instance information for, in the
4928
- # 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`.
4929
5023
  #
4930
5024
  # @return [Types::DescribeInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4931
5025
  #
@@ -4979,11 +5073,10 @@ module Aws::GameLift
4979
5073
  # This operation is not designed to be continually called to track
4980
5074
  # matchmaking ticket status. This practice can cause you to exceed your
4981
5075
  # API limit, which results in errors. Instead, as a best practice, set
4982
- # up an Amazon Simple Notification Service (SNS) to receive
4983
- # notifications, and provide the topic ARN in the matchmaking
4984
- # configuration. Continuously poling ticket status with
4985
- # DescribeMatchmaking should only be used for games in development with
4986
- # 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
+ # polling ticket status with DescribeMatchmaking should only be used for
5079
+ # games in development with low matchmaking usage.
4987
5080
  #
4988
5081
  #
4989
5082
  #
@@ -5250,7 +5343,7 @@ module Aws::GameLift
5250
5343
  # If successful, a `PlayerSession` object is returned for each session
5251
5344
  # that matches the request.
5252
5345
  #
5253
- # *Available in Amazon GameLift Local.*
5346
+ # *Available in Amazon Web Services Local.*
5254
5347
  #
5255
5348
  # **Related actions**
5256
5349
  #
@@ -5435,8 +5528,8 @@ module Aws::GameLift
5435
5528
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
5436
5529
  #
5437
5530
  # @option params [required, String] :fleet_id
5438
- # A unique identifier for the fleet to retrieve scaling policies for.
5439
- # 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.
5440
5533
  #
5441
5534
  # @option params [String] :status_filter
5442
5535
  # Scaling policy status to filter results on. A scaling policy is only
@@ -5470,7 +5563,8 @@ module Aws::GameLift
5470
5563
  # a value.
5471
5564
  #
5472
5565
  # @option params [String] :location
5473
- # 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.
5474
5568
  #
5475
5569
  # @return [Types::DescribeScalingPoliciesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5476
5570
  #
@@ -5524,7 +5618,7 @@ module Aws::GameLift
5524
5618
  #
5525
5619
  # **Learn more**
5526
5620
  #
5527
- # [Amazon GameLift Realtime Servers][1]
5621
+ # [Amazon Web Services Realtime Servers][1]
5528
5622
  #
5529
5623
  # **Related actions**
5530
5624
  #
@@ -5573,9 +5667,9 @@ module Aws::GameLift
5573
5667
  end
5574
5668
 
5575
5669
  # Retrieves valid VPC peering authorizations that are pending for the
5576
- # AWS account. This operation returns all VPC peering authorizations and
5577
- # requests for peering. This includes those initiated and received by
5578
- # 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.
5579
5673
  #
5580
5674
  # **Related actions**
5581
5675
  #
@@ -5614,12 +5708,12 @@ module Aws::GameLift
5614
5708
  # to get peering information for all fleets or for one specific fleet
5615
5709
  # ID.
5616
5710
  #
5617
- # To retrieve connection information, call this operation from the AWS
5618
- # account that is used to manage the Amazon GameLift fleets. Specify a
5619
- # fleet ID or leave the parameter empty to retrieve all connection
5620
- # records. If successful, the retrieved information includes both active
5621
- # and pending connections. Active connections identify the IpV4 CIDR
5622
- # 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.
5623
5717
  #
5624
5718
  # **Related actions**
5625
5719
  #
@@ -5672,8 +5766,8 @@ module Aws::GameLift
5672
5766
  # automatically stores the logs in Amazon S3 and retains them for 14
5673
5767
  # days. Use this URL to download the logs.
5674
5768
  #
5675
- # <note markdown="1"> See the [AWS Service Limits][1] page for maximum log file sizes. Log
5676
- # 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.
5677
5771
  #
5678
5772
  # </note>
5679
5773
  #
@@ -5726,9 +5820,9 @@ module Aws::GameLift
5726
5820
  # Remote Desktop client. For a Linux instance, GameLift returns a user
5727
5821
  # name and RSA private key, also as strings, for use with an SSH client.
5728
5822
  # The private key must be saved in the proper format to a `.pem` file
5729
- # before using. If you're making this request using the AWS CLI, saving
5730
- # the secret can be handled as part of the `GetInstanceAccess` request,
5731
- # 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.
5732
5826
  #
5733
5827
  # To request access to a specific instance, specify the IDs of both the
5734
5828
  # instance and the fleet it belongs to. You can retrieve a fleet's
@@ -5793,9 +5887,9 @@ module Aws::GameLift
5793
5887
  req.send_request(options)
5794
5888
  end
5795
5889
 
5796
- # Retrieves all aliases for this AWS account. You can filter the result
5797
- # set by alias name and/or routing strategy type. Use the pagination
5798
- # 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.
5799
5893
  #
5800
5894
  # <note markdown="1"> Returned aliases are not listed in any particular order.
5801
5895
  #
@@ -5878,10 +5972,11 @@ module Aws::GameLift
5878
5972
  req.send_request(options)
5879
5973
  end
5880
5974
 
5881
- # Retrieves build resources for all builds associated with the AWS
5882
- # account in use. You can limit results to builds that are in a specific
5883
- # status by using the `Status` parameter. Use the pagination parameters
5884
- # 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.
5885
5980
  #
5886
5981
  # <note markdown="1"> Build resources are not listed in any particular order.
5887
5982
  #
@@ -5965,9 +6060,9 @@ module Aws::GameLift
5965
6060
  req.send_request(options)
5966
6061
  end
5967
6062
 
5968
- # Retrieves a collection of fleet resources in an AWS Region. You can
5969
- # call this operation to get fleets in a previously selected default
5970
- # 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
5971
6066
  # [https://docs.aws.amazon.com/credref/latest/refdocs/setting-global-region.html][1]or
5972
6067
  # specify a Region in your request. You can filter the result set to
5973
6068
  # find only those fleets that are deployed with a specific build or
@@ -6068,8 +6163,9 @@ module Aws::GameLift
6068
6163
  # server groups.**
6069
6164
  #
6070
6165
  # Retrieves information on all game servers groups that exist in the
6071
- # current AWS account for the selected Region. Use the pagination
6072
- # 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.
6073
6169
  #
6074
6170
  # **Learn more**
6075
6171
  #
@@ -6227,11 +6323,11 @@ module Aws::GameLift
6227
6323
  end
6228
6324
 
6229
6325
  # Retrieves script records for all Realtime scripts that are associated
6230
- # with the AWS account in use.
6326
+ # with the Amazon Web Services account in use.
6231
6327
  #
6232
6328
  # **Learn more**
6233
6329
  #
6234
- # [Amazon GameLift Realtime Servers][1]
6330
+ # [Amazon Web Services Realtime Servers][1]
6235
6331
  #
6236
6332
  # **Related actions**
6237
6333
  #
@@ -6292,9 +6388,9 @@ module Aws::GameLift
6292
6388
  end
6293
6389
 
6294
6390
  # Retrieves all tags that are assigned to a GameLift resource. Resource
6295
- # tags are used to organize AWS resources for a range of purposes. This
6296
- # operation handles the permissions necessary to manage tags for the
6297
- # 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:
6298
6394
  #
6299
6395
  # * Build
6300
6396
  #
@@ -6315,9 +6411,10 @@ module Aws::GameLift
6315
6411
  #
6316
6412
  # **Learn more**
6317
6413
  #
6318
- # [Tagging AWS Resources][1] in the *AWS General Reference*
6414
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
6415
+ # General Reference*
6319
6416
  #
6320
- # [ AWS Tagging Strategies][2]
6417
+ # [ Amazon Web Services Tagging Strategies][2]
6321
6418
  #
6322
6419
  # **Related actions**
6323
6420
  #
@@ -6368,13 +6465,13 @@ module Aws::GameLift
6368
6465
 
6369
6466
  # Creates or updates a scaling policy for a fleet. Scaling policies are
6370
6467
  # used to automatically scale a fleet's hosting capacity to meet player
6371
- # demand. An active scaling policy instructs Amazon GameLift to track a
6372
- # fleet metric and automatically change the fleet's capacity when a
6373
- # certain threshold is reached. There are two types of scaling policies:
6374
- # target-based and rule-based. Use a target-based policy to quickly and
6375
- # efficiently manage fleet scaling; this option is the most commonly
6376
- # used. Use rule-based policies when you need to exert fine-grained
6377
- # 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.
6378
6475
  #
6379
6476
  # Fleets can have multiple scaling policies of each type in force at the
6380
6477
  # same time; you can have one target-based policy, one or multiple
@@ -6399,15 +6496,15 @@ module Aws::GameLift
6399
6496
  # currently in use. This is the fleet's buffer; it measures the
6400
6497
  # additional player demand that the fleet could handle at current
6401
6498
  # capacity. With a target-based policy, you set your ideal buffer size
6402
- # and leave it to Amazon GameLift to take whatever action is needed to
6403
- # maintain that target.
6499
+ # and leave it to Amazon Web Services to take whatever action is needed
6500
+ # to maintain that target.
6404
6501
  #
6405
6502
  # For example, you might choose to maintain a 10% buffer for a fleet
6406
6503
  # that has the capacity to host 100 simultaneous game sessions. This
6407
- # policy tells Amazon GameLift to take action whenever the fleet's
6504
+ # policy tells Amazon Web Services to take action whenever the fleet's
6408
6505
  # available capacity falls below or rises above 10 game sessions. Amazon
6409
- # GameLift will start new instances or stop unused instances in order to
6410
- # 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.
6411
6508
  #
6412
6509
  # To create or update a target-based policy, specify a fleet ID and
6413
6510
  # name, and set the policy type to "TargetBased". Specify the metric
@@ -6503,9 +6600,9 @@ module Aws::GameLift
6503
6600
  # threshold before a scaling event is triggered.
6504
6601
  #
6505
6602
  # @option params [required, String] :metric_name
6506
- # Name of the Amazon GameLift-defined metric that is used to trigger a
6507
- # scaling adjustment. For detailed descriptions of fleet metrics, see
6508
- # [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].
6509
6606
  #
6510
6607
  # * **ActivatingGameSessions** -- Game sessions in the process of being
6511
6608
  # created.
@@ -6634,7 +6731,7 @@ module Aws::GameLift
6634
6731
  # @option params [required, String] :game_server_id
6635
6732
  # A custom string that uniquely identifies the game server to register.
6636
6733
  # Game server IDs are developer-defined and must be unique across all
6637
- # game server groups in your AWS account.
6734
+ # game server groups in your Amazon Web Services account.
6638
6735
  #
6639
6736
  # @option params [required, String] :instance_id
6640
6737
  # The unique identifier for the instance where the game server is
@@ -6690,8 +6787,8 @@ module Aws::GameLift
6690
6787
  end
6691
6788
 
6692
6789
  # Retrieves a fresh set of credentials for use when uploading a new set
6693
- # of game build files to Amazon GameLift's Amazon S3. This is done as
6694
- # 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.
6695
6792
  #
6696
6793
  # To request new credentials, specify the build ID as returned with an
6697
6794
  # initial `CreateBuild` request. If successful, a new set of credentials
@@ -6867,6 +6964,14 @@ module Aws::GameLift
6867
6964
  # Retrieves all active game sessions that match a set of search criteria
6868
6965
  # and sorts them into a specified order.
6869
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
+ #
6870
6975
  # When searching for game sessions, you specify exactly where you want
6871
6976
  # to search and provide a search filter expression, a sort expression,
6872
6977
  # or both. A search request can search only one fleet, but it can search
@@ -6961,8 +7066,8 @@ module Aws::GameLift
6961
7066
  #
6962
7067
  # @option params [String] :location
6963
7068
  # A fleet location to search for game sessions. You can specify a
6964
- # fleet's home Region or a remote location. Use the AWS Region code
6965
- # 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`.
6966
7071
  #
6967
7072
  # @option params [String] :filter_expression
6968
7073
  # String containing the search criteria for the session search. If no
@@ -7138,7 +7243,7 @@ module Aws::GameLift
7138
7243
  #
7139
7244
  # @option params [String] :location
7140
7245
  # The fleet location to restart fleet actions for. Specify a location in
7141
- # 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`.
7142
7247
  #
7143
7248
  # @return [Types::StartFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7144
7249
  #
@@ -7169,26 +7274,26 @@ module Aws::GameLift
7169
7274
 
7170
7275
  # Places a request for a new game session in a queue (see
7171
7276
  # CreateGameSessionQueue). When processing a placement request, Amazon
7172
- # GameLift searches for available resources on the queue's
7277
+ # Web Services searches for available resources on the queue's
7173
7278
  # destinations, scanning each until it finds resources or the placement
7174
7279
  # request times out.
7175
7280
  #
7176
7281
  # A game session placement request can also request player sessions.
7177
- # When a new game session is successfully created, Amazon GameLift
7282
+ # When a new game session is successfully created, Amazon Web Services
7178
7283
  # creates a player session for each player included in the request.
7179
7284
  #
7180
- # When placing a game session, by default Amazon GameLift tries each
7285
+ # When placing a game session, by default Amazon Web Services tries each
7181
7286
  # fleet in the order they are listed in the queue configuration.
7182
7287
  # Ideally, a queue's destinations are listed in preference order.
7183
7288
  #
7184
7289
  # Alternatively, when requesting a game session with players, you can
7185
7290
  # also provide latency data for each player in relevant Regions. Latency
7186
7291
  # data indicates the performance lag a player experiences when connected
7187
- # to a fleet in the Region. Amazon GameLift uses latency data to reorder
7188
- # the list of destinations to place the game session in a Region with
7189
- # minimal lag. If latency data is provided for multiple players, Amazon
7190
- # GameLift calculates each Region's average lag for all players and
7191
- # 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.
7192
7297
  #
7193
7298
  # To place a new game session request, specify the following:
7194
7299
  #
@@ -7255,7 +7360,7 @@ module Aws::GameLift
7255
7360
  #
7256
7361
  # @option params [Array<Types::PlayerLatency>] :player_latencies
7257
7362
  # A set of values, expressed in milliseconds, that indicates the amount
7258
- # of latency that a player experiences when connected to AWS Regions.
7363
+ # of latency that a player experiences when connected to @aws; Regions.
7259
7364
  # This information is used to try to place the new game session where it
7260
7365
  # can offer the best possible gameplay experience for the players.
7261
7366
  #
@@ -7374,6 +7479,9 @@ module Aws::GameLift
7374
7479
  # and returned with status set to QUEUED. Track the status of backfill
7375
7480
  # tickets using the same method for tracking tickets for new matches.
7376
7481
  #
7482
+ # Only game sessions created by FlexMatch are supported for match
7483
+ # backfill.
7484
+ #
7377
7485
  # **Learn more**
7378
7486
  #
7379
7487
  # [ Backfill existing games with FlexMatch][1]
@@ -7396,7 +7504,7 @@ module Aws::GameLift
7396
7504
  #
7397
7505
  # @option params [String] :ticket_id
7398
7506
  # A unique identifier for a matchmaking ticket. If no ticket ID is
7399
- # 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
7400
7508
  # UUID. Use this identifier to track the match backfill ticket status
7401
7509
  # and retrieve match results.
7402
7510
  #
@@ -7422,6 +7530,9 @@ module Aws::GameLift
7422
7530
  # matchmaker data is in JSON syntax, formatted as a string. For more
7423
7531
  # details, see [ Match Data][1].
7424
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
+ #
7425
7536
  # * LatencyInMs -- If the matchmaker uses player latency, include a
7426
7537
  # latency value, in milliseconds, for the Region that the game session
7427
7538
  # is currently in. Do not include latency values for any other Region.
@@ -7508,7 +7619,7 @@ module Aws::GameLift
7508
7619
  # Track matchmaking events to respond as needed and acquire game session
7509
7620
  # connection information for successfully completed matches. Ticket
7510
7621
  # status updates are tracked using event notification through Amazon
7511
- # Simple Notification Service (SNS), which is defined in the matchmaking
7622
+ # Simple Notification Service, which is defined in the matchmaking
7512
7623
  # configuration.
7513
7624
  #
7514
7625
  # **Learn more**
@@ -7533,7 +7644,7 @@ module Aws::GameLift
7533
7644
  #
7534
7645
  # @option params [String] :ticket_id
7535
7646
  # A unique identifier for a matchmaking ticket. If no ticket ID is
7536
- # 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
7537
7648
  # UUID. Use this identifier to track the matchmaking ticket status and
7538
7649
  # retrieve match results.
7539
7650
  #
@@ -7658,7 +7769,7 @@ module Aws::GameLift
7658
7769
  #
7659
7770
  # @option params [String] :location
7660
7771
  # The fleet location to stop fleet actions for. Specify a location in
7661
- # 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`.
7662
7773
  #
7663
7774
  # @return [Types::StopFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7664
7775
  #
@@ -7888,12 +7999,12 @@ module Aws::GameLift
7888
7999
  req.send_request(options)
7889
8000
  end
7890
8001
 
7891
- # Assigns a tag to a GameLift resource. AWS resource tags provide an
7892
- # additional management tool set. You can use tags to organize
7893
- # resources, create IAM permissions policies to manage access to groups
7894
- # of resources, customize AWS cost breakdowns, etc. This operation
7895
- # handles the permissions necessary to manage tags for the following
7896
- # 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:
7897
8008
  #
7898
8009
  # * Build
7899
8010
  #
@@ -7916,9 +8027,10 @@ module Aws::GameLift
7916
8027
  #
7917
8028
  # **Learn more**
7918
8029
  #
7919
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8030
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8031
+ # General Reference*
7920
8032
  #
7921
- # [ AWS Tagging Strategies][2]
8033
+ # [ Amazon Web Services Tagging Strategies][2]
7922
8034
  #
7923
8035
  # **Related actions**
7924
8036
  #
@@ -7946,7 +8058,7 @@ module Aws::GameLift
7946
8058
  # A list of one or more tags to assign to the specified GameLift
7947
8059
  # resource. Tags are developer-defined and structured as key-value
7948
8060
  # pairs. The maximum tag limit may be lower than stated. See [ Tagging
7949
- # AWS Resources][1] for actual tagging limits.
8061
+ # Amazon Web Services Resources][1] for actual tagging limits.
7950
8062
  #
7951
8063
  #
7952
8064
  #
@@ -7976,9 +8088,9 @@ module Aws::GameLift
7976
8088
  end
7977
8089
 
7978
8090
  # Removes a tag that is assigned to a GameLift resource. Resource tags
7979
- # are used to organize AWS resources for a range of purposes. This
7980
- # operation handles the permissions necessary to manage tags for the
7981
- # 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:
7982
8094
  #
7983
8095
  # * Build
7984
8096
  #
@@ -8001,9 +8113,10 @@ module Aws::GameLift
8001
8113
  #
8002
8114
  # **Learn more**
8003
8115
  #
8004
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8116
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8117
+ # General Reference*
8005
8118
  #
8006
- # [ AWS Tagging Strategies][2]
8119
+ # [ Amazon Web Services Tagging Strategies][2]
8007
8120
  #
8008
8121
  # **Related actions**
8009
8122
  #
@@ -8029,8 +8142,9 @@ module Aws::GameLift
8029
8142
  #
8030
8143
  # @option params [required, Array<String>] :tag_keys
8031
8144
  # A list of one or more tag keys to remove from the specified GameLift
8032
- # resource. An AWS resource can have only one tag with a specific tag
8033
- # 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.
8034
8148
  #
8035
8149
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
8036
8150
  #
@@ -8282,12 +8396,12 @@ module Aws::GameLift
8282
8396
  # whether the capacity is changed manually or through automatic
8283
8397
  # scaling.
8284
8398
  #
8285
- # * Desired capacity: Manually set the number of EC2 instances to be
8286
- # maintained in a fleet location. Before changing a fleet's desired
8287
- # capacity, you may want to call DescribeEC2InstanceLimits to get the
8288
- # maximum capacity of the fleet's EC2 instance type. Alternatively,
8289
- # consider using automatic scaling to adjust capacity based on player
8290
- # 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.
8291
8405
  #
8292
8406
  # This operation can be used in the following ways:
8293
8407
  #
@@ -8331,9 +8445,9 @@ module Aws::GameLift
8331
8445
  # can use either the fleet ID or ARN value.
8332
8446
  #
8333
8447
  # @option params [Integer] :desired_instances
8334
- # The number of EC2 instances you want to maintain in the specified
8335
- # fleet location. This value must fall between the minimum and maximum
8336
- # 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.
8337
8451
  #
8338
8452
  # @option params [Integer] :min_size
8339
8453
  # The minimum number of instances that are allowed in the specified
@@ -8345,7 +8459,7 @@ module Aws::GameLift
8345
8459
  #
8346
8460
  # @option params [String] :location
8347
8461
  # The name of a remote location to update fleet capacity settings for,
8348
- # 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`.
8349
8463
  #
8350
8464
  # @return [Types::UpdateFleetCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8351
8465
  #
@@ -8600,24 +8714,24 @@ module Aws::GameLift
8600
8714
  #
8601
8715
  # @option params [String] :role_arn
8602
8716
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
8603
- # GameLift to access your EC2 Auto Scaling groups.
8717
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
8604
8718
  #
8605
8719
  #
8606
8720
  #
8607
8721
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
8608
8722
  #
8609
8723
  # @option params [Array<Types::InstanceDefinition>] :instance_definitions
8610
- # An updated list of EC2 instance types to use in the Auto Scaling
8611
- # group. The instance definitions must specify at least two different
8612
- # instance types that are supported by GameLift FleetIQ. This updated
8613
- # list replaces the entire current list of instance definitions for the
8614
- # game server group. For more information on instance types, see [EC2
8615
- # Instance Types][1] in the *Amazon EC2 User Guide*. You can optionally
8616
- # specify capacity weighting for each instance type. If no weight value
8617
- # is specified for an instance type, it is set to the default value
8618
- # "1". For more information about capacity weighting, see [ Instance
8619
- # Weighting for Amazon EC2 Auto Scaling][2] in the Amazon EC2 Auto
8620
- # 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.
8621
8735
  #
8622
8736
  #
8623
8737
  #
@@ -8632,8 +8746,8 @@ module Aws::GameLift
8632
8746
  # instances cannot be terminated while there are active game servers
8633
8747
  # running except in the event of a forced game server group deletion
8634
8748
  # (see ). An exception to this is with Spot Instances, which can be
8635
- # terminated by AWS regardless of protection status. This property is
8636
- # 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.
8637
8751
  #
8638
8752
  # @option params [String] :balancing_strategy
8639
8753
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -8805,14 +8919,18 @@ module Aws::GameLift
8805
8919
  #
8806
8920
  # **Related actions**
8807
8921
  #
8808
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
8809
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
8810
- # task][2]
8922
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
8923
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
8924
+ # APIs by task][6]
8811
8925
  #
8812
8926
  #
8813
8927
  #
8814
8928
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
8815
- # [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
8816
8934
  #
8817
8935
  # @option params [required, String] :name
8818
8936
  # A descriptive label that is associated with game session queue. Queue
@@ -8843,10 +8961,10 @@ module Aws::GameLift
8843
8961
  #
8844
8962
  # @option params [Types::FilterConfiguration] :filter_configuration
8845
8963
  # A list of locations where a queue is allowed to place new game
8846
- # sessions. Locations are specified in the form of AWS Region codes,
8847
- # such as `us-west-2`. If this parameter is not set, game sessions can
8848
- # be placed in any queue location. To remove an existing filter
8849
- # 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.
8850
8968
  #
8851
8969
  # @option params [Types::PriorityConfiguration] :priority_configuration
8852
8970
  # Custom settings to use when prioritizing destinations and locations
@@ -9221,13 +9339,13 @@ module Aws::GameLift
9221
9339
  # the *Version* parameter to track updates to the script.
9222
9340
  #
9223
9341
  # If the call is successful, the updated metadata is stored in the
9224
- # script record and a revised script is uploaded to the Amazon GameLift
9225
- # service. Once the script is updated and acquired by a fleet instance,
9226
- # 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.
9227
9345
  #
9228
9346
  # **Learn more**
9229
9347
  #
9230
- # [Amazon GameLift Realtime Servers][1]
9348
+ # [Amazon Web Services Realtime Servers][1]
9231
9349
  #
9232
9350
  # **Related actions**
9233
9351
  #
@@ -9255,21 +9373,22 @@ module Aws::GameLift
9255
9373
  # The location of the Amazon S3 bucket where a zipped file containing
9256
9374
  # your Realtime scripts is stored. The storage location must specify the
9257
9375
  # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
9258
- # that allows Amazon GameLift to access the Amazon S3 storage location.
9259
- # The S3 bucket must be in the same Region where you want to create a
9260
- # new script. By default, Amazon GameLift uploads the latest version of
9261
- # the zip file; if you have S3 object versioning turned on, you can use
9262
- # 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.
9263
9382
  #
9264
9383
  # @option params [String, StringIO, File] :zip_file
9265
9384
  # A data object containing your Realtime scripts and dependencies as a
9266
9385
  # zip file. The zip file can have one or multiple files. Maximum size of
9267
9386
  # a zip file is 5 MB.
9268
9387
  #
9269
- # When using the AWS CLI tool to create a script, this parameter is set
9270
- # to the zip file name. It must be prepended with the string
9271
- # "fileb://" to indicate that the file data is a binary object. For
9272
- # 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`.
9273
9392
  #
9274
9393
  # @return [Types::UpdateScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9275
9394
  #
@@ -9376,7 +9495,7 @@ module Aws::GameLift
9376
9495
  params: params,
9377
9496
  config: config)
9378
9497
  context[:gem_name] = 'aws-sdk-gamelift'
9379
- context[:gem_version] = '1.53.0'
9498
+ context[:gem_version] = '1.56.0'
9380
9499
  Seahorse::Client::Request.new(handlers, context)
9381
9500
  end
9382
9501