aws-sdk-gamelift 1.53.0 → 1.56.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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