aws-sdk-gamelift 1.53.0 → 1.54.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -545,12 +545,12 @@ module Aws::GameLift
545
545
  # for a fleet that is useful when redirecting player traffic from one
546
546
  # fleet to another, such as when updating your game build.
547
547
  #
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.
548
+ # Amazon Web Services supports two types of routing strategies for
549
+ # aliases: simple and terminal. A simple alias points to an active
550
+ # fleet. A terminal alias is used to display messaging or link to a URL
551
+ # instead of routing players to an active fleet. For example, you might
552
+ # use a terminal alias when a game version is no longer supported and
553
+ # you want to direct players to an upgrade site.
554
554
  #
555
555
  # To create a fleet alias, specify an alias name, routing strategy, and
556
556
  # optional description. Each simple alias can point to only one fleet,
@@ -580,12 +580,13 @@ module Aws::GameLift
580
580
  #
581
581
  # @option params [Array<Types::Tag>] :tags
582
582
  # 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
583
+ # developer-defined key-value pairs. Tagging Amazon Web Services
584
+ # resources are useful for resource management, access management and
585
+ # cost allocation. For more information, see [ Tagging Amazon Web
586
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
587
+ # Once the resource is created, you can use TagResource, UntagResource,
588
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
589
+ # limit may be lower than stated. See the Amazon Web Services General
589
590
  # Reference for actual tagging limits.
590
591
  #
591
592
  #
@@ -635,12 +636,12 @@ module Aws::GameLift
635
636
  req.send_request(options)
636
637
  end
637
638
 
638
- # Creates a new Amazon GameLift build resource for your game server
639
+ # Creates a new Amazon Web Services build resource for your game server
639
640
  # binary files. Game server binaries must be combined into a zip file
640
- # for use with Amazon GameLift.
641
+ # for use with Amazon Web Services.
641
642
  #
642
643
  # When setting up a new game build for GameLift, we recommend using the
643
- # AWS CLI command <b> <a
644
+ # Amazon Web Services CLI command <b> <a
644
645
  # href="https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html">upload-build</a>
645
646
  # </b>. This helper command combines two tasks: (1) it uploads your
646
647
  # build files from a file directory to a GameLift Amazon S3 location,
@@ -649,11 +650,11 @@ module Aws::GameLift
649
650
  # The `CreateBuild` operation can used in the following scenarios:
650
651
  #
651
652
  # * 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.
653
+ # location under an Amazon Web Services account that you control. To
654
+ # use this option, you must first give Amazon Web Services access to
655
+ # the Amazon S3 bucket. With permissions in place, call `CreateBuild`
656
+ # and specify a build name, operating system, and the Amazon S3
657
+ # storage location of your game build.
657
658
  #
658
659
  # * To directly upload your build files to a GameLift Amazon S3
659
660
  # location. To use this option, first call `CreateBuild` and specify a
@@ -702,8 +703,13 @@ module Aws::GameLift
702
703
  # this parameter only when creating a build with files stored in an
703
704
  # Amazon S3 bucket that you own. The storage location must specify an
704
705
  # 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.
706
+ # ARN that you set up to allow Amazon Web Services to access your Amazon
707
+ # S3 bucket. The S3 bucket and your new build must be in the same
708
+ # Region.
709
+ #
710
+ # If a `StorageLocation` is specified, the size of your file can be
711
+ # found in your Amazon S3 bucket. Amazon Web Services will report a
712
+ # `SizeOnDisk` of 0.
707
713
  #
708
714
  # @option params [String] :operating_system
709
715
  # The operating system that the game server binaries are built to run
@@ -715,12 +721,13 @@ module Aws::GameLift
715
721
  #
716
722
  # @option params [Array<Types::Tag>] :tags
717
723
  # 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
724
+ # developer-defined key-value pairs. Tagging Amazon Web Services
725
+ # resources are useful for resource management, access management and
726
+ # cost allocation. For more information, see [ Tagging Amazon Web
727
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
728
+ # Once the resource is created, you can use TagResource, UntagResource,
729
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
730
+ # limit may be lower than stated. See the Amazon Web Services General
724
731
  # Reference for actual tagging limits.
725
732
  #
726
733
  #
@@ -780,21 +787,23 @@ module Aws::GameLift
780
787
  req.send_request(options)
781
788
  end
782
789
 
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.
790
+ # Creates a fleet of Amazon Elastic Compute Cloud (Amazon Elastic
791
+ # Compute Cloud) instances to host your custom game server or Realtime
792
+ # Servers. Use this operation to configure the computing resources for
793
+ # your fleet and provide instructions for running game servers on each
794
+ # instance.
787
795
  #
788
796
  # Most GameLift fleets can deploy instances to multiple locations,
789
797
  # 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.
798
+ # set of remote locations. Fleets that are created in the following
799
+ # Amazon Web Services Regions support multiple locations: us-east-1 (N.
800
+ # Virginia), us-west-2 (Oregon), eu-central-1 (Frankfurt), eu-west-1
801
+ # (Ireland), ap-southeast-2 (Sydney), ap-northeast-1 (Tokyo), and
802
+ # ap-northeast-2 (Seoul). Fleets that are created in other GameLift
803
+ # Regions can deploy instances in the fleet's home Region only. All
804
+ # fleet instances use the same configuration regardless of location;
805
+ # however, you can adjust capacity settings and turn auto-scaling on/off
806
+ # for each location.
798
807
  #
799
808
  # To create a fleet, choose the hardware for your instances, specify a
800
809
  # game server build or Realtime script to deploy, and provide a runtime
@@ -804,6 +813,12 @@ module Aws::GameLift
804
813
  # creating a multi-location fleet, provide a list of additional remote
805
814
  # locations.
806
815
  #
816
+ # If you need to debug your fleet, fetch logs, view performance metrics
817
+ # or other actions on the fleet, create the development fleet with port
818
+ # 22/3389 open. As a best practice, we recommend opening ports for
819
+ # remote access only when you need them and closing them when you're
820
+ # finished.
821
+ #
807
822
  # If successful, this operation creates a new Fleet resource and places
808
823
  # it in `NEW` status, which prompts GameLift to initiate the [fleet
809
824
  # creation workflow][1]. You can track fleet creation by checking fleet
@@ -878,11 +893,11 @@ module Aws::GameLift
878
893
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api-ref.html#gamelift-sdk-server-api-ref-dataypes-process
879
894
  #
880
895
  # @option params [required, String] :ec2_instance_type
881
- # The GameLift-supported EC2 instance type to use for all fleet
896
+ # The GameLift-supported Amazon EC2 instance type to use for all fleet
882
897
  # instances. Instance type determines the computing resources that will
883
898
  # 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.
899
+ # networking capacity. See [Amazon Elastic Compute Cloud Instance
900
+ # Types][1] for detailed descriptions of Amazon EC2 instance types.
886
901
  #
887
902
  #
888
903
  #
@@ -927,23 +942,24 @@ module Aws::GameLift
927
942
  # of time.
928
943
  #
929
944
  # @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.
945
+ # The name of an Amazon Web Services CloudWatch metric group to add this
946
+ # fleet to. A metric group is used to aggregate the metrics for multiple
947
+ # fleets. You can specify an existing metric group name or set a new
948
+ # name to create a new metric group. A fleet can be included in only one
949
+ # metric group at a time.
935
950
  #
936
951
  # @option params [String] :peer_vpc_aws_account_id
937
952
  # 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.
953
+ # identifier for the Amazon Web Services account that owns the VPC. You
954
+ # can find your account ID in the Amazon Web Services Management Console
955
+ # under account settings.
940
956
  #
941
957
  # @option params [String] :peer_vpc_id
942
958
  # A unique identifier for a VPC with resources to be accessed by your
943
959
  # 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].
960
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
961
+ # Services Management Console. Learn more about VPC peering in [VPC
962
+ # Peering with GameLift Fleets][2].
947
963
  #
948
964
  #
949
965
  #
@@ -961,15 +977,15 @@ module Aws::GameLift
961
977
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
962
978
  #
963
979
  # @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.
980
+ # A unique identifier for an IAM role that manages access to your Amazon
981
+ # Web Services services. With an instance role ARN set, any application
982
+ # that runs on an instance in this fleet can assume the role, including
983
+ # install scripts, server processes, and daemons (background processes).
984
+ # Create a role or look up a role's ARN by using the [IAM dashboard][1]
985
+ # in the Amazon Web Services Management Console. Learn more about using
986
+ # on-box credentials for your game servers at [ Access external
987
+ # resources from a game server][2]. This property cannot be changed
988
+ # after the fleet is created.
973
989
  #
974
990
  #
975
991
  #
@@ -980,35 +996,33 @@ module Aws::GameLift
980
996
  # Prompts GameLift to generate a TLS/SSL certificate for the fleet. TLS
981
997
  # certificates are used for encrypting traffic between game clients and
982
998
  # 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.
999
+ # `CertificateConfiguration` is set to `DISABLED`. This property cannot
1000
+ # be changed after the fleet is created.
991
1001
  #
992
- #
993
- #
994
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-howitworks.html#gamelift-howitworks-security
1002
+ # Note: This feature requires the Amazon Web Services Certificate
1003
+ # Manager (ACM) service, which is not available in all Amazon Web
1004
+ # Services regions. When working in a region that does not support this
1005
+ # feature, a fleet creation request with certificate generation fails
1006
+ # with a 4xx error.
995
1007
  #
996
1008
  # @option params [Array<Types::LocationConfiguration>] :locations
997
1009
  # A set of remote locations to deploy additional instances to and manage
998
1010
  # 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.
1011
+ # fleets in Amazon Web Services Regions that support multiple locations.
1012
+ # You can add any GameLift-supported Amazon Web Services Region as a
1013
+ # remote location, in the form of an Amazon Web Services Region code
1014
+ # such as `us-west-2`. To create a fleet with instances in the home
1015
+ # Region only, omit this parameter.
1003
1016
  #
1004
1017
  # @option params [Array<Types::Tag>] :tags
1005
1018
  # 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
1019
+ # developer-defined key-value pairs. Tagging Amazon Web Services
1020
+ # resources are useful for resource management, access management and
1021
+ # cost allocation. For more information, see [ Tagging Amazon Web
1022
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
1023
+ # Once the fleet is created, you can use TagResource, UntagResource, and
1024
+ # ListTagsForResource to add, remove, and view tags. The maximum tag
1025
+ # limit may be lower than stated. See the *Amazon Web Services General
1012
1026
  # Reference* for actual tagging limits.
1013
1027
  #
1014
1028
  #
@@ -1125,9 +1139,9 @@ module Aws::GameLift
1125
1139
  #
1126
1140
  # <note markdown="1"> This operation cannot be used with fleets that don't support remote
1127
1141
  # 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.
1142
+ # Amazon Web Services Regions that support this feature (see CreateFleet
1143
+ # for the complete list) and were created after the feature was released
1144
+ # in March 2021.
1131
1145
  #
1132
1146
  # </note>
1133
1147
  #
@@ -1168,9 +1182,9 @@ module Aws::GameLift
1168
1182
  #
1169
1183
  # @option params [required, Array<Types::LocationConfiguration>] :locations
1170
1184
  # 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`.
1185
+ # part of the fleet. You can add any GameLift-supported Amazon Web
1186
+ # Services Region as a remote location, in the form of an Amazon Web
1187
+ # Services Region code such as `us-west-2`.
1174
1188
  #
1175
1189
  # @return [Types::CreateFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1176
1190
  #
@@ -1210,31 +1224,33 @@ module Aws::GameLift
1210
1224
  # server groups.**
1211
1225
  #
1212
1226
  # 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.
1227
+ # on a collection of Amazon Elastic Compute Cloud instances for game
1228
+ # hosting. This operation creates the game server group, creates an Auto
1229
+ # Scaling group in your Amazon Web Services account, and establishes a
1230
+ # link between the two groups. You can view the status of your game
1231
+ # server groups in the GameLift console. Game server group metrics and
1232
+ # events are emitted to Amazon CloudWatch.
1219
1233
  #
1220
1234
  # Before creating a new game server group, you must have the following:
1221
1235
  #
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*.
1236
+ # * An Amazon Elastic Compute Cloud launch template that specifies how
1237
+ # to launch Amazon Elastic Compute Cloud instances with your game
1238
+ # server build. For more information, see [ Launching an Instance from
1239
+ # a Launch Template][1] in the *Amazon Elastic Compute Cloud User
1240
+ # Guide*.
1226
1241
  #
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*.
1242
+ # * An IAM role that extends limited access to your Amazon Web Services
1243
+ # account to allow GameLift FleetIQ to create and interact with the
1244
+ # Auto Scaling group. For more information, see [Create IAM roles for
1245
+ # cross-service interaction][2] in the *GameLift FleetIQ Developer
1246
+ # Guide*.
1231
1247
  #
1232
1248
  # 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.
1249
+ # role and Amazon Elastic Compute Cloud launch template, and provide a
1250
+ # list of instance types that can be used in the group. You must also
1251
+ # set initial maximum and minimum limits on the group's instance count.
1252
+ # You can optionally set an Auto Scaling policy with target tracking
1253
+ # based on a GameLift FleetIQ metric.
1238
1254
  #
1239
1255
  # Once the game server group and corresponding Auto Scaling group are
1240
1256
  # created, you have full access to change the Auto Scaling group's
@@ -1266,41 +1282,42 @@ module Aws::GameLift
1266
1282
  #
1267
1283
  # @option params [required, String] :game_server_group_name
1268
1284
  # 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.
1285
+ # generate unique ARN identifiers for the Amazon EC2 Auto Scaling group
1286
+ # and the GameLift FleetIQ game server group. The name must be unique
1287
+ # per Region per Amazon Web Services account.
1272
1288
  #
1273
1289
  # @option params [required, String] :role_arn
1274
1290
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
1275
- # GameLift to access your EC2 Auto Scaling groups.
1291
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
1276
1292
  #
1277
1293
  #
1278
1294
  #
1279
1295
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
1280
1296
  #
1281
1297
  # @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.
1298
+ # The minimum number of instances allowed in the Amazon EC2 Auto Scaling
1299
+ # group. During automatic scaling events, GameLift FleetIQ and Amazon
1300
+ # EC2 do not scale down the group below this minimum. In production,
1301
+ # this value should be set to at least 1. After the Auto Scaling group
1302
+ # is created, update this value directly in the Auto Scaling group using
1303
+ # the Amazon Web Services console or APIs.
1288
1304
  #
1289
1305
  # @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.
1306
+ # The maximum number of instances allowed in the Amazon EC2 Auto Scaling
1307
+ # group. During automatic scaling events, GameLift FleetIQ and EC2 do
1308
+ # not scale up the group above this maximum. After the Auto Scaling
1309
+ # group is created, update this value directly in the Auto Scaling group
1310
+ # using the Amazon Web Services console or APIs.
1295
1311
  #
1296
1312
  # @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.
1313
+ # The Amazon EC2 launch template that contains configuration settings
1314
+ # and game server code to be deployed to all instances in the game
1315
+ # server group. You can specify the template using either the template
1316
+ # name or ID. For help with creating a launch template, see [Creating a
1317
+ # Launch Template for an Auto Scaling Group][1] in the *Amazon Elastic
1318
+ # Compute Cloud Auto Scaling User Guide*. After the Auto Scaling group
1319
+ # is created, update this value directly in the Auto Scaling group using
1320
+ # the Amazon Web Services console or APIs.
1304
1321
  #
1305
1322
  # <note markdown="1"> If you specify network interfaces in your launch template, you must
1306
1323
  # explicitly set the property `AssociatePublicIpAddress` to "true". If
@@ -1314,15 +1331,16 @@ module Aws::GameLift
1314
1331
  # [1]: https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-launch-template.html
1315
1332
  #
1316
1333
  # @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.
1334
+ # The Amazon EC2 instance types and sizes to use in the Auto Scaling
1335
+ # group. The instance definitions must specify at least two different
1336
+ # instance types that are supported by GameLift FleetIQ. For more
1337
+ # information on instance types, see [EC2 Instance Types][1] in the
1338
+ # *Amazon Elastic Compute Cloud User Guide*. You can optionally specify
1339
+ # capacity weighting for each instance type. If no weight value is
1340
+ # specified for an instance type, it is set to the default value "1".
1341
+ # For more information about capacity weighting, see [ Instance
1342
+ # Weighting for Amazon EC2 Auto Scaling][2] in the Amazon EC2 Auto
1343
+ # Scaling User Guide.
1326
1344
  #
1327
1345
  #
1328
1346
  #
@@ -1335,7 +1353,7 @@ module Aws::GameLift
1335
1353
  # metric `"PercentUtilizedGameServers"` to maintain a buffer of idle
1336
1354
  # game servers that can immediately accommodate new games and players.
1337
1355
  # After the Auto Scaling group is created, update this value directly in
1338
- # the Auto Scaling group using the AWS console or APIs.
1356
+ # the Auto Scaling group using the Amazon Web Services console or APIs.
1339
1357
  #
1340
1358
  # @option params [String] :balancing_strategy
1341
1359
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -1368,8 +1386,8 @@ module Aws::GameLift
1368
1386
  # instances cannot be terminated while there are active game servers
1369
1387
  # running except in the event of a forced game server group deletion
1370
1388
  # (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.
1389
+ # terminated by Amazon Web Services regardless of protection status.
1390
+ # This property is set to `NO_PROTECTION` by default.
1373
1391
  #
1374
1392
  # @option params [Array<String>] :vpc_subnets
1375
1393
  # A list of virtual private cloud (VPC) subnets to use with instances in
@@ -1382,13 +1400,14 @@ module Aws::GameLift
1382
1400
  #
1383
1401
  # @option params [Array<Types::Tag>] :tags
1384
1402
  # 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.
1403
+ # are developer-defined key-value pairs. Tagging Amazon Web Services
1404
+ # resources is useful for resource management, access management, and
1405
+ # cost allocation. For more information, see [ Tagging Amazon Web
1406
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
1407
+ # Once the resource is created, you can use TagResource, UntagResource,
1408
+ # and ListTagsForResource to add, remove, and view tags, respectively.
1409
+ # The maximum tag limit may be lower than stated. See the Amazon Web
1410
+ # Services General Reference for actual tagging limits.
1392
1411
  #
1393
1412
  #
1394
1413
  #
@@ -1497,7 +1516,7 @@ module Aws::GameLift
1497
1516
  # days. To access the logs, call GetGameSessionLogUrl to download the
1498
1517
  # log files.
1499
1518
  #
1500
- # *Available in GameLift Local.*
1519
+ # *Available in Amazon Web Services Local.*
1501
1520
  #
1502
1521
  # **Learn more**
1503
1522
  #
@@ -1537,7 +1556,12 @@ module Aws::GameLift
1537
1556
  # @option params [Array<Types::GameProperty>] :game_properties
1538
1557
  # A set of custom properties for a game session, formatted as key:value
1539
1558
  # pairs. These properties are passed to a game server process in the
1540
- # GameSession object with a request to start a new game session.
1559
+ # GameSession object with a request to start a new game session (see
1560
+ # [Start a Game Session][1]).
1561
+ #
1562
+ #
1563
+ #
1564
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
1541
1565
  #
1542
1566
  # @option params [String] :creator_id
1543
1567
  # A unique identifier for a player or entity creating the game session.
@@ -1569,13 +1593,18 @@ module Aws::GameLift
1569
1593
  # @option params [String] :game_session_data
1570
1594
  # A set of custom game session properties, formatted as a single string
1571
1595
  # value. This data is passed to a game server process in the GameSession
1572
- # object with a request to start a new game session.
1596
+ # object with a request to start a new game session (see [Start a Game
1597
+ # Session][1]).
1598
+ #
1599
+ #
1600
+ #
1601
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-startsession
1573
1602
  #
1574
1603
  # @option params [String] :location
1575
1604
  # A fleet's remote location to place the new game session in. If this
1576
1605
  # 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`.
1606
+ # home Region. Specify a remote location with an Amazon Web Services
1607
+ # Region code such as `us-west-2`.
1579
1608
  #
1580
1609
  # @return [Types::CreateGameSessionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1581
1610
  #
@@ -1642,10 +1671,10 @@ module Aws::GameLift
1642
1671
  # A game session queue is configured with a set of destinations
1643
1672
  # (GameLift fleets or aliases), which determine the locations where the
1644
1673
  # 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.
1674
+ # multiple fleet types (Spot and On-Demand), instance types, and Amazon
1675
+ # Web Services Regions. If the queue includes multi-location fleets, the
1676
+ # queue is able to place game sessions in all of a fleet's remote
1677
+ # locations. You can opt to filter out individual locations if needed.
1649
1678
  #
1650
1679
  # The queue configuration also determines how FleetIQ selects the best
1651
1680
  # available placement for a new game session. Before searching for an
@@ -1664,26 +1693,32 @@ module Aws::GameLift
1664
1693
  #
1665
1694
  # If successful, a new `GameSessionQueue` object is returned with an
1666
1695
  # assigned queue ARN. New game session requests, which are submitted to
1667
- # the queue with StartGameSessionPlacement or StartMatchmaking,
1696
+ # queue with [StartGameSessionPlacement][1] or [StartMatchmaking][2],
1668
1697
  # reference a queue's name or ARN.
1669
1698
  #
1670
1699
  # **Learn more**
1671
1700
  #
1672
- # [ Design a game session queue][1]
1701
+ # [ Design a game session queue][3]
1673
1702
  #
1674
- # [ Create a game session queue][2]
1703
+ # [ Create a game session queue][4]
1675
1704
  #
1676
1705
  # **Related actions**
1677
1706
  #
1678
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
1679
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
1680
- # task][3]
1707
+ # [CreateGameSessionQueue][5] \| [DescribeGameSessionQueues][6] \|
1708
+ # [UpdateGameSessionQueue][7] \| [DeleteGameSessionQueue][8] \| [All
1709
+ # APIs by task][9]
1681
1710
  #
1682
1711
  #
1683
1712
  #
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
1713
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartGameSessionPlacement.html
1714
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartMatchmaking.html
1715
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-design.html
1716
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-creating.html
1717
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
1718
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
1719
+ # [7]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
1720
+ # [8]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
1721
+ # [9]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
1687
1722
  #
1688
1723
  # @option params [required, String] :name
1689
1724
  # A descriptive label that is associated with game session queue. Queue
@@ -1711,9 +1746,9 @@ module Aws::GameLift
1711
1746
  #
1712
1747
  # @option params [Types::FilterConfiguration] :filter_configuration
1713
1748
  # 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.
1749
+ # sessions. Locations are specified in the form of Amazon Web Services
1750
+ # Region codes, such as `us-west-2`. If this parameter is not set, game
1751
+ # sessions can be placed in any queue location.
1717
1752
  #
1718
1753
  # @option params [Types::PriorityConfiguration] :priority_configuration
1719
1754
  # Custom settings to use when prioritizing destinations and locations
@@ -1737,13 +1772,14 @@ module Aws::GameLift
1737
1772
  #
1738
1773
  # @option params [Array<Types::Tag>] :tags
1739
1774
  # 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.
1775
+ # Tags are developer-defined key-value pairs. Tagging Amazon Web
1776
+ # Services resources are useful for resource management, access
1777
+ # management and cost allocation. For more information, see [ Tagging
1778
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
1779
+ # Reference*. Once the resource is created, you can use TagResource,
1780
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
1781
+ # The maximum tag limit may be lower than stated. See the Amazon Web
1782
+ # Services General Reference for actual tagging limits.
1747
1783
  #
1748
1784
  #
1749
1785
  #
@@ -1834,10 +1870,10 @@ module Aws::GameLift
1834
1870
  # queue to use when starting a game session for the match.
1835
1871
  #
1836
1872
  # 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.
1873
+ # topic to receive matchmaking notifications. Provide the topic ARN in
1874
+ # the matchmaking configuration. An alternative method, continuously
1875
+ # polling ticket status with DescribeMatchmaking, is only suitable for
1876
+ # games in development with low matchmaking usage.
1841
1877
  #
1842
1878
  # **Learn more**
1843
1879
  #
@@ -1978,13 +2014,14 @@ module Aws::GameLift
1978
2014
  #
1979
2015
  # @option params [Array<Types::Tag>] :tags
1980
2016
  # 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.
2017
+ # resource. Tags are developer-defined key-value pairs. Tagging Amazon
2018
+ # Web Services resources are useful for resource management, access
2019
+ # management and cost allocation. For more information, see [ Tagging
2020
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
2021
+ # Reference*. Once the resource is created, you can use TagResource,
2022
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
2023
+ # The maximum tag limit may be lower than stated. See the Amazon Web
2024
+ # Services General Reference for actual tagging limits.
1988
2025
  #
1989
2026
  #
1990
2027
  #
@@ -2106,13 +2143,14 @@ module Aws::GameLift
2106
2143
  #
2107
2144
  # @option params [Array<Types::Tag>] :tags
2108
2145
  # 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.
2146
+ # Tags are developer-defined key-value pairs. Tagging Amazon Web
2147
+ # Services resources are useful for resource management, access
2148
+ # management and cost allocation. For more information, see [ Tagging
2149
+ # Amazon Web Services Resources][1] in the *Amazon Web Services General
2150
+ # Reference*. Once the resource is created, you can use TagResource,
2151
+ # UntagResource, and ListTagsForResource to add, remove, and view tags.
2152
+ # The maximum tag limit may be lower than stated. See the Amazon Web
2153
+ # Services General Reference for actual tagging limits.
2116
2154
  #
2117
2155
  #
2118
2156
  #
@@ -2167,7 +2205,10 @@ module Aws::GameLift
2167
2205
  # validate the player reservation with the GameLift service. Player
2168
2206
  # sessions cannot be updated.
2169
2207
  #
2170
- # *Available in Amazon GameLift Local.*
2208
+ # The maximum number of players per game session is 200. It is not
2209
+ # adjustable.
2210
+ #
2211
+ # *Available in Amazon Web Services Local.*
2171
2212
  #
2172
2213
  # **Related actions**
2173
2214
  #
@@ -2242,7 +2283,10 @@ module Aws::GameLift
2242
2283
  # to validate the player reservation with the GameLift service. Player
2243
2284
  # sessions cannot be updated.
2244
2285
  #
2245
- # *Available in Amazon GameLift Local.*
2286
+ # The maximum number of players per game session is 200. It is not
2287
+ # adjustable.
2288
+ #
2289
+ # *Available in Amazon Web Services Local.*
2246
2290
  #
2247
2291
  # **Related actions**
2248
2292
  #
@@ -2262,10 +2306,10 @@ module Aws::GameLift
2262
2306
  #
2263
2307
  # @option params [Hash<String,String>] :player_data_map
2264
2308
  # 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.
2309
+ # developer-defined information related to the player. Amazon Web
2310
+ # Services does not use this data, so it can be formatted as needed for
2311
+ # use in the game. Any player data strings for player IDs that are not
2312
+ # included in the `PlayerIds` parameter are ignored.
2269
2313
  #
2270
2314
  # @return [Types::CreatePlayerSessionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2271
2315
  #
@@ -2320,23 +2364,24 @@ module Aws::GameLift
2320
2364
  # * A locally available directory. Use the *ZipFile* parameter for this
2321
2365
  # option.
2322
2366
  #
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.
2367
+ # * An Amazon Simple Storage Service (Amazon S3) bucket under your
2368
+ # Amazon Web Services account. Use the *StorageLocation* parameter for
2369
+ # this option. You'll need to have an Identity Access Management
2370
+ # (IAM) role that allows the Amazon Web Services service to access
2371
+ # your S3 bucket.
2327
2372
  #
2328
2373
  # If the call is successful, a new script record is created with a
2329
2374
  # 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.
2375
+ # file is uploaded to an Amazon Web Services-owned S3 bucket and the
2376
+ # script record's storage location reflects this location. If the
2377
+ # script file is provided as an S3 bucket, Amazon Web Services accesses
2378
+ # the file at this storage location as needed for deployment.
2334
2379
  #
2335
2380
  # **Learn more**
2336
2381
  #
2337
- # [Amazon GameLift Realtime Servers][1]
2382
+ # [Amazon Web Services Realtime Servers][1]
2338
2383
  #
2339
- # [Set Up a Role for Amazon GameLift Access][2]
2384
+ # [Set Up a Role for Amazon Web Services Access][2]
2340
2385
  #
2341
2386
  # **Related actions**
2342
2387
  #
@@ -2363,30 +2408,32 @@ module Aws::GameLift
2363
2408
  # The location of the Amazon S3 bucket where a zipped file containing
2364
2409
  # your Realtime scripts is stored. The storage location must specify the
2365
2410
  # 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.
2411
+ # that allows Amazon Web Services to access the Amazon S3 storage
2412
+ # location. The S3 bucket must be in the same Region where you want to
2413
+ # create a new script. By default, Amazon Web Services uploads the
2414
+ # latest version of the zip file; if you have S3 object versioning
2415
+ # turned on, you can use the `ObjectVersion` parameter to specify an
2416
+ # earlier version.
2371
2417
  #
2372
2418
  # @option params [String, StringIO, File] :zip_file
2373
2419
  # A data object containing your Realtime scripts and dependencies as a
2374
2420
  # zip file. The zip file can have one or multiple files. Maximum size of
2375
2421
  # a zip file is 5 MB.
2376
2422
  #
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`.
2423
+ # When using the Amazon Web Services CLI tool to create a script, this
2424
+ # parameter is set to the zip file name. It must be prepended with the
2425
+ # string "fileb://" to indicate that the file data is a binary object.
2426
+ # For example: `--zip-file fileb://myRealtimeScript.zip`.
2381
2427
  #
2382
2428
  # @option params [Array<Types::Tag>] :tags
2383
2429
  # 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
2430
+ # developer-defined key-value pairs. Tagging Amazon Web Services
2431
+ # resources are useful for resource management, access management and
2432
+ # cost allocation. For more information, see [ Tagging Amazon Web
2433
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
2434
+ # Once the resource is created, you can use TagResource, UntagResource,
2435
+ # and ListTagsForResource to add, remove, and view tags. The maximum tag
2436
+ # limit may be lower than stated. See the Amazon Web Services General
2390
2437
  # Reference for actual tagging limits.
2391
2438
  #
2392
2439
  #
@@ -2440,32 +2487,35 @@ module Aws::GameLift
2440
2487
  end
2441
2488
 
2442
2489
  # 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.
2490
+ # the VPC for your Amazon Web Services fleet and a virtual private cloud
2491
+ # (VPC) in your Amazon Web Services account. VPC peering enables the
2492
+ # game servers on your fleet to communicate directly with other Amazon
2493
+ # Web Services resources. Once you've received authorization, call
2494
+ # CreateVpcPeeringConnection to establish the peering connection. For
2495
+ # more information, see [VPC Peering with Amazon Web Services
2496
+ # Fleets][1].
2497
+ #
2498
+ # You can peer with VPCs that are owned by any Amazon Web Services
2499
+ # account you have access to, including the account that you use to
2500
+ # manage your Amazon Web Services fleets. You cannot peer with VPCs that
2501
+ # are in different Regions.
2454
2502
  #
2455
2503
  # 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.
2504
+ # from the Amazon Web Services account with the VPC that you want to
2505
+ # peer to your Amazon Web Services fleet. For example, to enable your
2506
+ # game servers to retrieve data from a DynamoDB table, use the account
2507
+ # that manages that DynamoDB resource. Identify the following values:
2508
+ # (1) The ID of the VPC that you want to peer with, and (2) the ID of
2509
+ # the Amazon Web Services account that you use to manage Amazon Web
2510
+ # Services. If successful, VPC peering is authorized for the specified
2511
+ # VPC.
2463
2512
  #
2464
2513
  # 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.
2514
+ # from the Amazon Web Services account with the VPC that is peered with
2515
+ # your Amazon Web Services fleet. Identify the following values: (1) VPC
2516
+ # ID that you want to delete the peering connection for, and (2) ID of
2517
+ # the Amazon Web Services account that you use to manage Amazon Web
2518
+ # Services.
2469
2519
  #
2470
2520
  # The authorization remains valid for 24 hours unless it is canceled by
2471
2521
  # a call to DeleteVpcPeeringAuthorization. You must create or delete the
@@ -2484,16 +2534,16 @@ module Aws::GameLift
2484
2534
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2485
2535
  #
2486
2536
  # @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.
2537
+ # A unique identifier for the Amazon Web Services account that you use
2538
+ # to manage your GameLift fleet. You can find your Account ID in the
2539
+ # Amazon Web Services Management Console under account settings.
2490
2540
  #
2491
2541
  # @option params [required, String] :peer_vpc_id
2492
2542
  # A unique identifier for a VPC with resources to be accessed by your
2493
2543
  # 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].
2544
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
2545
+ # Services Management Console. Learn more about VPC peering in [VPC
2546
+ # Peering with GameLift Fleets][2].
2497
2547
  #
2498
2548
  #
2499
2549
  #
@@ -2529,13 +2579,14 @@ module Aws::GameLift
2529
2579
  end
2530
2580
 
2531
2581
  # 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].
2582
+ # (VPC) in an Amazon Web Services account with the VPC for your Amazon
2583
+ # Web Services fleet. VPC peering enables the game servers on your fleet
2584
+ # to communicate directly with other Amazon Web Services resources. You
2585
+ # can peer with VPCs in any Amazon Web Services account that you have
2586
+ # access to, including the account that you use to manage your Amazon
2587
+ # Web Services fleets. You cannot peer with VPCs that are in different
2588
+ # Regions. For more information, see [VPC Peering with Amazon Web
2589
+ # Services Fleets][1].
2539
2590
  #
2540
2591
  # Before calling this operation to establish the peering connection, you
2541
2592
  # first need to call CreateVpcPeeringAuthorization and identify the VPC
@@ -2544,16 +2595,16 @@ module Aws::GameLift
2544
2595
  # operations handle all tasks necessary to peer the two VPCs, including
2545
2596
  # acceptance, updating routing tables, etc.
2546
2597
  #
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.
2598
+ # To establish the connection, call this operation from the Amazon Web
2599
+ # Services account that is used to manage the Amazon Web Services
2600
+ # fleets. Identify the following values: (1) The ID of the fleet you
2601
+ # want to be enable a VPC peering connection for; (2) The Amazon Web
2602
+ # Services account with the VPC that you want to peer with; and (3) The
2603
+ # ID of the VPC you want to peer with. This operation is asynchronous.
2604
+ # If successful, a VpcPeeringConnection request is created. You can use
2605
+ # continuous polling to track the request's status using
2606
+ # DescribeVpcPeeringConnections, or by monitoring fleet events for
2607
+ # success or failure using DescribeFleetEvents.
2557
2608
  #
2558
2609
  # **Related actions**
2559
2610
  #
@@ -2569,19 +2620,21 @@ module Aws::GameLift
2569
2620
  #
2570
2621
  # @option params [required, String] :fleet_id
2571
2622
  # 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.
2623
+ # ARN value. This tells Amazon Web Services which GameLift VPC to peer
2624
+ # with.
2573
2625
  #
2574
2626
  # @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.
2627
+ # A unique identifier for the Amazon Web Services account with the VPC
2628
+ # that you want to peer your Amazon Web Services fleet with. You can
2629
+ # find your Account ID in the Amazon Web Services Management Console
2630
+ # under account settings.
2578
2631
  #
2579
2632
  # @option params [required, String] :peer_vpc_id
2580
2633
  # A unique identifier for a VPC with resources to be accessed by your
2581
2634
  # 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].
2635
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
2636
+ # Services Management Console. Learn more about VPC peering in [VPC
2637
+ # Peering with GameLift Fleets][2].
2585
2638
  #
2586
2639
  #
2587
2640
  #
@@ -2774,7 +2827,7 @@ module Aws::GameLift
2774
2827
  #
2775
2828
  # @option params [required, Array<String>] :locations
2776
2829
  # The list of fleet locations to delete. Specify locations in the form
2777
- # of an AWS Region code, such as `us-west-2`.
2830
+ # of an Amazon Web Services Region code, such as `us-west-2`.
2778
2831
  #
2779
2832
  # @return [Types::DeleteFleetLocationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2780
2833
  #
@@ -2860,16 +2913,16 @@ module Aws::GameLift
2860
2913
  # @option params [String] :delete_option
2861
2914
  # The type of delete to perform. Options include the following:
2862
2915
  #
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.
2916
+ # * `SAFE_DELETE` – (default) Terminates the game server group and
2917
+ # Amazon EC2 Auto Scaling group only when it has no game servers that
2918
+ # are in `UTILIZED` status.
2866
2919
  #
2867
2920
  # * `FORCE_DELETE` – Terminates the game server group, including all
2868
2921
  # active game servers regardless of their utilization status, and the
2869
- # EC2 Auto Scaling group.
2922
+ # Amazon EC2 Auto Scaling group.
2870
2923
  #
2871
2924
  # * `RETAIN` – Does a safe delete of the game server group but retains
2872
- # the EC2 Auto Scaling group as is.
2925
+ # the Amazon EC2 Auto Scaling group as is.
2873
2926
  #
2874
2927
  # @return [Types::DeleteGameServerGroupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2875
2928
  #
@@ -2910,23 +2963,28 @@ module Aws::GameLift
2910
2963
  end
2911
2964
 
2912
2965
  # Deletes a game session queue. Once a queue is successfully deleted,
2913
- # unfulfilled StartGameSessionPlacement requests that reference the
2966
+ # unfulfilled [StartGameSessionPlacement][1] requests that reference the
2914
2967
  # queue will fail. To delete a queue, specify the queue name.
2915
2968
  #
2916
2969
  # **Learn more**
2917
2970
  #
2918
- # [ Using Multi-Region Queues][1]
2971
+ # [ Using Multi-Region Queues][2]
2919
2972
  #
2920
2973
  # **Related actions**
2921
2974
  #
2922
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
2923
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
2924
- # task][2]
2975
+ # [CreateGameSessionQueue][3] \| [DescribeGameSessionQueues][4] \|
2976
+ # [UpdateGameSessionQueue][5] \| [DeleteGameSessionQueue][6] \| [All
2977
+ # APIs by task][7]
2925
2978
  #
2926
2979
  #
2927
2980
  #
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
2981
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartGameSessionPlacement.html
2982
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/queues-intro.html
2983
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
2984
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
2985
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
2986
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
2987
+ # [7]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2930
2988
  #
2931
2989
  # @option params [required, String] :name
2932
2990
  # A descriptive label that is associated with game session queue. Queue
@@ -3089,7 +3147,7 @@ module Aws::GameLift
3089
3147
  #
3090
3148
  # **Learn more**
3091
3149
  #
3092
- # [Amazon GameLift Realtime Servers][1]
3150
+ # [Amazon Web Services Realtime Servers][1]
3093
3151
  #
3094
3152
  # **Related actions**
3095
3153
  #
@@ -3138,16 +3196,16 @@ module Aws::GameLift
3138
3196
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3139
3197
  #
3140
3198
  # @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.
3199
+ # A unique identifier for the Amazon Web Services account that you use
3200
+ # to manage your GameLift fleet. You can find your Account ID in the
3201
+ # Amazon Web Services Management Console under account settings.
3144
3202
  #
3145
3203
  # @option params [required, String] :peer_vpc_id
3146
3204
  # A unique identifier for a VPC with resources to be accessed by your
3147
3205
  # 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].
3206
+ # look up a VPC ID, use the [VPC Dashboard][1] in the Amazon Web
3207
+ # Services Management Console. Learn more about VPC peering in [VPC
3208
+ # Peering with GameLift Fleets][2].
3151
3209
  #
3152
3210
  #
3153
3211
  #
@@ -3178,10 +3236,10 @@ module Aws::GameLift
3178
3236
  # DescribeVpcPeeringAuthorizations or request a new one using
3179
3237
  # CreateVpcPeeringAuthorization.
3180
3238
  #
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.
3239
+ # Once a valid authorization exists, call this operation from the Amazon
3240
+ # Web Services account that is used to manage the Amazon Web Services
3241
+ # fleets. Identify the connection to delete by the connection ID and
3242
+ # fleet ID. If successful, the connection is removed.
3185
3243
  #
3186
3244
  # **Related actions**
3187
3245
  #
@@ -3377,22 +3435,23 @@ module Aws::GameLift
3377
3435
  req.send_request(options)
3378
3436
  end
3379
3437
 
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.
3438
+ # The GameLift service limits and current utilization for an Amazon Web
3439
+ # Services Region or location. Instance limits control the number of
3440
+ # instances, per instance type, per location, that your Amazon Web
3441
+ # Services account can use. Learn more at [Amazon EC2 Instance
3442
+ # Types][1]. The information returned includes the maximum number of
3443
+ # instances allowed and your account's current usage across all fleets.
3444
+ # This information can affect your ability to scale your GameLift
3445
+ # fleets. You can request a limit increase for your account by using the
3446
+ # **Service limits** page in the GameLift console.
3388
3447
  #
3389
3448
  # Instance limits differ based on whether the instances are deployed in
3390
3449
  # a fleet's home Region or in a remote location. For remote locations,
3391
3450
  # 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:
3451
+ # location. All requests must specify an Amazon Web Services Region
3452
+ # (either explicitly or as your default settings). To get the limit for
3453
+ # a remote location, you must also specify the location. For example,
3454
+ # the following requests all return different results:
3396
3455
  #
3397
3456
  # * Request specifies the Region `ap-northeast-1` with no location. The
3398
3457
  # result is limits and usage data on all instance types that are
@@ -3413,14 +3472,15 @@ module Aws::GameLift
3413
3472
  # This operation can be used in the following ways:
3414
3473
  #
3415
3474
  # * 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.
3475
+ # in an Amazon Web Services Region by fleets that reside in the same
3476
+ # Region: Specify the Region only. Optionally, specify a single
3477
+ # instance type to retrieve information for.
3419
3478
  #
3420
3479
  # * 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.
3480
+ # to a remote location by fleets that reside in different Amazon Web
3481
+ # Services Region: Provide both the Amazon Web Services Region and the
3482
+ # remote location. Optionally, specify a single instance type to
3483
+ # retrieve information for.
3424
3484
  #
3425
3485
  # If successful, an `EC2InstanceLimits` object is returned with limits
3426
3486
  # and usage data for each requested instance type.
@@ -3443,15 +3503,15 @@ module Aws::GameLift
3443
3503
  # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
3444
3504
  #
3445
3505
  # @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.
3506
+ # Name of an Amazon EC2 instance type that is supported in GameLift. A
3507
+ # fleet instance type determines the computing resources of each
3508
+ # instance in the fleet, including CPU, memory, storage, and networking
3509
+ # capacity. Do not specify a value for this parameter to retrieve limits
3510
+ # for all instance types.
3451
3511
  #
3452
3512
  # @option params [String] :location
3453
3513
  # 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`.
3514
+ # form of an Amazon Web Services Region code such as `us-west-2`.
3455
3515
  #
3456
3516
  # @return [Types::DescribeEC2InstanceLimitsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3457
3517
  #
@@ -3839,7 +3899,8 @@ module Aws::GameLift
3839
3899
  #
3840
3900
  # @option params [Array<String>] :locations
3841
3901
  # 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`.
3902
+ # locations in the form of an Amazon Web Services Region code, such as
3903
+ # `us-west-2`.
3843
3904
  #
3844
3905
  # @option params [Integer] :limit
3845
3906
  # The maximum number of results to return. Use this parameter with
@@ -3929,7 +3990,8 @@ module Aws::GameLift
3929
3990
  #
3930
3991
  # @option params [required, String] :location
3931
3992
  # 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`.
3993
+ # location in the form of an Amazon Web Services Region code, such as
3994
+ # `us-west-2`.
3933
3995
  #
3934
3996
  # @return [Types::DescribeFleetLocationCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3935
3997
  #
@@ -4002,7 +4064,8 @@ module Aws::GameLift
4002
4064
  #
4003
4065
  # @option params [required, String] :location
4004
4066
  # 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`.
4067
+ # location in the form of an Amazon Web Services Region code, such as
4068
+ # `us-west-2`.
4006
4069
  #
4007
4070
  # @return [Types::DescribeFleetLocationUtilizationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4008
4071
  #
@@ -4077,7 +4140,7 @@ module Aws::GameLift
4077
4140
  #
4078
4141
  # @option params [String] :location
4079
4142
  # A remote location to check for status of port setting updates. Use the
4080
- # AWS Region code format, such as `us-west-2`.
4143
+ # Amazon Web Services Region code format, such as `us-west-2`.
4081
4144
  #
4082
4145
  # @return [Types::DescribeFleetPortSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4083
4146
  #
@@ -4398,10 +4461,10 @@ module Aws::GameLift
4398
4461
  # GameServerGroup name or ARN value.
4399
4462
  #
4400
4463
  # @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.
4464
+ # The Amazon EC2 instance IDs that you want to retrieve status on.
4465
+ # Amazon EC2 instance IDs use a 17-character format, for example:
4466
+ # `i-1234567890abcdef0`. To retrieve all instances in the game server
4467
+ # group, leave this parameter empty.
4405
4468
  #
4406
4469
  # @option params [Integer] :limit
4407
4470
  # The maximum number of results to return. Use this parameter with
@@ -4469,7 +4532,8 @@ module Aws::GameLift
4469
4532
  #
4470
4533
  # * To retrieve details for a specific game session, provide the game
4471
4534
  # session ID. This approach looks for the game session ID in all
4472
- # fleets that reside in the AWS Region defined in the request.
4535
+ # fleets that reside in the Amazon Web Services Region defined in the
4536
+ # request.
4473
4537
  #
4474
4538
  # Use the pagination parameters to retrieve results as a set of
4475
4539
  # sequential pages.
@@ -4508,8 +4572,8 @@ module Aws::GameLift
4508
4572
  #
4509
4573
  # @option params [String] :location
4510
4574
  # 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`.
4575
+ # home Region or a remote location. Use the Amazon Web Services Region
4576
+ # code format, such as `us-west-2`.
4513
4577
  #
4514
4578
  # @option params [String] :status_filter
4515
4579
  # Game session status to filter results on. Possible game session
@@ -4586,6 +4650,14 @@ module Aws::GameLift
4586
4650
  #
4587
4651
  # To get game session placement details, specify the placement ID.
4588
4652
  #
4653
+ # This operation is not designed to be continually called to track game
4654
+ # session status. This practice can cause you to exceed your API limit,
4655
+ # which results in errors. Instead, you must configure configure an
4656
+ # Amazon Simple Notification Service (SNS) topic to receive
4657
+ # notifications from FlexMatch or queues. Continuously polling with
4658
+ # `DescribeGameSessionPlacement` should only be used for games in
4659
+ # development with low game session usage.
4660
+ #
4589
4661
  # If successful, a GameSessionPlacement object is returned.
4590
4662
  #
4591
4663
  # **Related actions**
@@ -4663,14 +4735,18 @@ module Aws::GameLift
4663
4735
  #
4664
4736
  # **Related actions**
4665
4737
  #
4666
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
4667
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
4668
- # task][2]
4738
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
4739
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
4740
+ # APIs by task][6]
4669
4741
  #
4670
4742
  #
4671
4743
  #
4672
4744
  # [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
4745
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
4746
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
4747
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
4748
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
4749
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
4674
4750
  #
4675
4751
  # @option params [Array<String>] :names
4676
4752
  # A list of queue names to retrieve information for. You can use either
@@ -4740,6 +4816,14 @@ module Aws::GameLift
4740
4816
  # retrieve the protection policy for game sessions, use
4741
4817
  # DescribeGameSessionDetails.
4742
4818
  #
4819
+ # This operation is not designed to be continually called to track game
4820
+ # session status. This practice can cause you to exceed your API limit,
4821
+ # which results in errors. Instead, you must configure configure an
4822
+ # Amazon Simple Notification Service (SNS) topic to receive
4823
+ # notifications from FlexMatch or queues. Continuously polling with
4824
+ # `DescribeGameSessions` should only be used for games in development
4825
+ # with low game session usage.
4826
+ #
4743
4827
  # This operation can be used in the following ways:
4744
4828
  #
4745
4829
  # * To retrieve all game sessions that are currently running on all
@@ -4754,7 +4838,7 @@ module Aws::GameLift
4754
4838
  #
4755
4839
  # * To retrieve a specific game session, provide the game session ID.
4756
4840
  # This approach looks for the game session ID in all fleets that
4757
- # reside in the AWS Region defined in the request.
4841
+ # reside in the Amazon Web Services Region defined in the request.
4758
4842
  #
4759
4843
  # Use the pagination parameters to retrieve results as a set of
4760
4844
  # sequential pages.
@@ -4762,7 +4846,15 @@ module Aws::GameLift
4762
4846
  # If successful, a `GameSession` object is returned for each game
4763
4847
  # session that matches the request.
4764
4848
  #
4765
- # *Available in GameLift Local.*
4849
+ # This operation is not designed to be continually called to track
4850
+ # matchmaking ticket status. This practice can cause you to exceed your
4851
+ # API limit, which results in errors. Instead, as a best practice, set
4852
+ # up an Amazon Simple Notification Service to receive notifications, and
4853
+ # provide the topic ARN in the matchmaking configuration. Continuously
4854
+ # poling ticket status with DescribeGameSessions should only be used for
4855
+ # games in development with low matchmaking usage.
4856
+ #
4857
+ # *Available in Amazon Web Services Local.*
4766
4858
  #
4767
4859
  # **Learn more**
4768
4860
  #
@@ -4795,8 +4887,8 @@ module Aws::GameLift
4795
4887
  #
4796
4888
  # @option params [String] :location
4797
4889
  # 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`.
4890
+ # fleet's home Region or a remote location. Use the Amazon Web Services
4891
+ # Region code format, such as `us-west-2`.
4800
4892
  #
4801
4893
  # @option params [String] :status_filter
4802
4894
  # Game session status to filter results on. You can filter on the
@@ -4925,7 +5017,7 @@ module Aws::GameLift
4925
5017
  #
4926
5018
  # @option params [String] :location
4927
5019
  # The name of a location to retrieve instance information for, in the
4928
- # form of an AWS Region code such as `us-west-2`.
5020
+ # form of an Amazon Web Services Region code such as `us-west-2`.
4929
5021
  #
4930
5022
  # @return [Types::DescribeInstancesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4931
5023
  #
@@ -4979,11 +5071,10 @@ module Aws::GameLift
4979
5071
  # This operation is not designed to be continually called to track
4980
5072
  # matchmaking ticket status. This practice can cause you to exceed your
4981
5073
  # 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.
5074
+ # up an Amazon Simple Notification Service to receive notifications, and
5075
+ # provide the topic ARN in the matchmaking configuration. Continuously
5076
+ # poling ticket status with DescribeMatchmaking should only be used for
5077
+ # games in development with low matchmaking usage.
4987
5078
  #
4988
5079
  #
4989
5080
  #
@@ -5250,7 +5341,7 @@ module Aws::GameLift
5250
5341
  # If successful, a `PlayerSession` object is returned for each session
5251
5342
  # that matches the request.
5252
5343
  #
5253
- # *Available in Amazon GameLift Local.*
5344
+ # *Available in Amazon Web Services Local.*
5254
5345
  #
5255
5346
  # **Related actions**
5256
5347
  #
@@ -5435,8 +5526,8 @@ module Aws::GameLift
5435
5526
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
5436
5527
  #
5437
5528
  # @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.
5529
+ # A unique identifier for the fleet for which to retrieve scaling
5530
+ # policies. You can use either the fleet ID or ARN value.
5440
5531
  #
5441
5532
  # @option params [String] :status_filter
5442
5533
  # Scaling policy status to filter results on. A scaling policy is only
@@ -5470,7 +5561,8 @@ module Aws::GameLift
5470
5561
  # a value.
5471
5562
  #
5472
5563
  # @option params [String] :location
5473
- # CONTENT TODO
5564
+ # The fleet location. If you don't specify this value, the response
5565
+ # contains the scaling policies of every location in the fleet.
5474
5566
  #
5475
5567
  # @return [Types::DescribeScalingPoliciesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5476
5568
  #
@@ -5524,7 +5616,7 @@ module Aws::GameLift
5524
5616
  #
5525
5617
  # **Learn more**
5526
5618
  #
5527
- # [Amazon GameLift Realtime Servers][1]
5619
+ # [Amazon Web Services Realtime Servers][1]
5528
5620
  #
5529
5621
  # **Related actions**
5530
5622
  #
@@ -5573,9 +5665,9 @@ module Aws::GameLift
5573
5665
  end
5574
5666
 
5575
5667
  # 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.
5668
+ # Amazon Web Services account. This operation returns all VPC peering
5669
+ # authorizations and requests for peering. This includes those initiated
5670
+ # and received by this account.
5579
5671
  #
5580
5672
  # **Related actions**
5581
5673
  #
@@ -5614,12 +5706,12 @@ module Aws::GameLift
5614
5706
  # to get peering information for all fleets or for one specific fleet
5615
5707
  # ID.
5616
5708
  #
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.
5709
+ # To retrieve connection information, call this operation from the
5710
+ # Amazon Web Services account that is used to manage the Amazon Web
5711
+ # Services fleets. Specify a fleet ID or leave the parameter empty to
5712
+ # retrieve all connection records. If successful, the retrieved
5713
+ # information includes both active and pending connections. Active
5714
+ # connections identify the IpV4 CIDR block that the VPC uses to connect.
5623
5715
  #
5624
5716
  # **Related actions**
5625
5717
  #
@@ -5672,8 +5764,8 @@ module Aws::GameLift
5672
5764
  # automatically stores the logs in Amazon S3 and retains them for 14
5673
5765
  # days. Use this URL to download the logs.
5674
5766
  #
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.
5767
+ # <note markdown="1"> See the [Amazon Web Services Service Limits][1] page for maximum log
5768
+ # file sizes. Log files that exceed this limit are not saved.
5677
5769
  #
5678
5770
  # </note>
5679
5771
  #
@@ -5726,9 +5818,9 @@ module Aws::GameLift
5726
5818
  # Remote Desktop client. For a Linux instance, GameLift returns a user
5727
5819
  # name and RSA private key, also as strings, for use with an SSH client.
5728
5820
  # 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.
5821
+ # before using. If you're making this request using the CLI, saving the
5822
+ # secret can be handled as part of the `GetInstanceAccess` request, as
5823
+ # shown in one of the examples for this operation.
5732
5824
  #
5733
5825
  # To request access to a specific instance, specify the IDs of both the
5734
5826
  # instance and the fleet it belongs to. You can retrieve a fleet's
@@ -5793,9 +5885,9 @@ module Aws::GameLift
5793
5885
  req.send_request(options)
5794
5886
  end
5795
5887
 
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.
5888
+ # Retrieves all aliases for this Amazon Web Services account. You can
5889
+ # filter the result set by alias name and/or routing strategy type. Use
5890
+ # the pagination parameters to retrieve results in sequential pages.
5799
5891
  #
5800
5892
  # <note markdown="1"> Returned aliases are not listed in any particular order.
5801
5893
  #
@@ -5878,10 +5970,11 @@ module Aws::GameLift
5878
5970
  req.send_request(options)
5879
5971
  end
5880
5972
 
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.
5973
+ # Retrieves build resources for all builds associated with the Amazon
5974
+ # Web Services account in use. You can limit results to builds that are
5975
+ # in a specific status by using the `Status` parameter. Use the
5976
+ # pagination parameters to retrieve results in a set of sequential
5977
+ # pages.
5885
5978
  #
5886
5979
  # <note markdown="1"> Build resources are not listed in any particular order.
5887
5980
  #
@@ -5965,9 +6058,9 @@ module Aws::GameLift
5965
6058
  req.send_request(options)
5966
6059
  end
5967
6060
 
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
6061
+ # Retrieves a collection of fleet resources in an Amazon Web Services
6062
+ # Region. You can call this operation to get fleets in a previously
6063
+ # selected default Region (see
5971
6064
  # [https://docs.aws.amazon.com/credref/latest/refdocs/setting-global-region.html][1]or
5972
6065
  # specify a Region in your request. You can filter the result set to
5973
6066
  # find only those fleets that are deployed with a specific build or
@@ -6068,8 +6161,9 @@ module Aws::GameLift
6068
6161
  # server groups.**
6069
6162
  #
6070
6163
  # 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.
6164
+ # current Amazon Web Services account for the selected Region. Use the
6165
+ # pagination parameters to retrieve results in a set of sequential
6166
+ # segments.
6073
6167
  #
6074
6168
  # **Learn more**
6075
6169
  #
@@ -6227,11 +6321,11 @@ module Aws::GameLift
6227
6321
  end
6228
6322
 
6229
6323
  # Retrieves script records for all Realtime scripts that are associated
6230
- # with the AWS account in use.
6324
+ # with the Amazon Web Services account in use.
6231
6325
  #
6232
6326
  # **Learn more**
6233
6327
  #
6234
- # [Amazon GameLift Realtime Servers][1]
6328
+ # [Amazon Web Services Realtime Servers][1]
6235
6329
  #
6236
6330
  # **Related actions**
6237
6331
  #
@@ -6292,9 +6386,9 @@ module Aws::GameLift
6292
6386
  end
6293
6387
 
6294
6388
  # 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:
6389
+ # tags are used to organize Amazon Web Services resources for a range of
6390
+ # purposes. This operation handles the permissions necessary to manage
6391
+ # tags for the following GameLift resource types:
6298
6392
  #
6299
6393
  # * Build
6300
6394
  #
@@ -6315,9 +6409,10 @@ module Aws::GameLift
6315
6409
  #
6316
6410
  # **Learn more**
6317
6411
  #
6318
- # [Tagging AWS Resources][1] in the *AWS General Reference*
6412
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
6413
+ # General Reference*
6319
6414
  #
6320
- # [ AWS Tagging Strategies][2]
6415
+ # [ Amazon Web Services Tagging Strategies][2]
6321
6416
  #
6322
6417
  # **Related actions**
6323
6418
  #
@@ -6368,13 +6463,13 @@ module Aws::GameLift
6368
6463
 
6369
6464
  # Creates or updates a scaling policy for a fleet. Scaling policies are
6370
6465
  # 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.
6466
+ # demand. An active scaling policy instructs Amazon Web Services to
6467
+ # track a fleet metric and automatically change the fleet's capacity
6468
+ # when a certain threshold is reached. There are two types of scaling
6469
+ # policies: target-based and rule-based. Use a target-based policy to
6470
+ # quickly and efficiently manage fleet scaling; this option is the most
6471
+ # commonly used. Use rule-based policies when you need to exert
6472
+ # fine-grained control over auto-scaling.
6378
6473
  #
6379
6474
  # Fleets can have multiple scaling policies of each type in force at the
6380
6475
  # same time; you can have one target-based policy, one or multiple
@@ -6399,15 +6494,15 @@ module Aws::GameLift
6399
6494
  # currently in use. This is the fleet's buffer; it measures the
6400
6495
  # additional player demand that the fleet could handle at current
6401
6496
  # 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.
6497
+ # and leave it to Amazon Web Services to take whatever action is needed
6498
+ # to maintain that target.
6404
6499
  #
6405
6500
  # For example, you might choose to maintain a 10% buffer for a fleet
6406
6501
  # that has the capacity to host 100 simultaneous game sessions. This
6407
- # policy tells Amazon GameLift to take action whenever the fleet's
6502
+ # policy tells Amazon Web Services to take action whenever the fleet's
6408
6503
  # 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.
6504
+ # Web Services will start new instances or stop unused instances in
6505
+ # order to return to the 10% buffer.
6411
6506
  #
6412
6507
  # To create or update a target-based policy, specify a fleet ID and
6413
6508
  # name, and set the policy type to "TargetBased". Specify the metric
@@ -6503,9 +6598,9 @@ module Aws::GameLift
6503
6598
  # threshold before a scaling event is triggered.
6504
6599
  #
6505
6600
  # @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].
6601
+ # Name of the Amazon Web Services-defined metric that is used to trigger
6602
+ # a scaling adjustment. For detailed descriptions of fleet metrics, see
6603
+ # [Monitor Amazon Web Services with Amazon CloudWatch][1].
6509
6604
  #
6510
6605
  # * **ActivatingGameSessions** -- Game sessions in the process of being
6511
6606
  # created.
@@ -6634,7 +6729,7 @@ module Aws::GameLift
6634
6729
  # @option params [required, String] :game_server_id
6635
6730
  # A custom string that uniquely identifies the game server to register.
6636
6731
  # Game server IDs are developer-defined and must be unique across all
6637
- # game server groups in your AWS account.
6732
+ # game server groups in your Amazon Web Services account.
6638
6733
  #
6639
6734
  # @option params [required, String] :instance_id
6640
6735
  # The unique identifier for the instance where the game server is
@@ -6690,8 +6785,8 @@ module Aws::GameLift
6690
6785
  end
6691
6786
 
6692
6787
  # 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.
6788
+ # of game build files to Amazon Web Services's Amazon S3. This is done
6789
+ # as part of the build creation process; see CreateBuild.
6695
6790
  #
6696
6791
  # To request new credentials, specify the build ID as returned with an
6697
6792
  # initial `CreateBuild` request. If successful, a new set of credentials
@@ -6867,6 +6962,14 @@ module Aws::GameLift
6867
6962
  # Retrieves all active game sessions that match a set of search criteria
6868
6963
  # and sorts them into a specified order.
6869
6964
  #
6965
+ # This operation is not designed to be continually called to track game
6966
+ # session status. This practice can cause you to exceed your API limit,
6967
+ # which results in errors. Instead, you must configure configure an
6968
+ # Amazon Simple Notification Service (SNS) topic to receive
6969
+ # notifications from FlexMatch or queues. Continuously polling game
6970
+ # session status with `DescribeGameSessions` should only be used for
6971
+ # games in development with low game session usage.
6972
+ #
6870
6973
  # When searching for game sessions, you specify exactly where you want
6871
6974
  # to search and provide a search filter expression, a sort expression,
6872
6975
  # or both. A search request can search only one fleet, but it can search
@@ -6961,8 +7064,8 @@ module Aws::GameLift
6961
7064
  #
6962
7065
  # @option params [String] :location
6963
7066
  # 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`.
7067
+ # fleet's home Region or a remote location. Use the Amazon Web Services
7068
+ # Region code format, such as `us-west-2`.
6966
7069
  #
6967
7070
  # @option params [String] :filter_expression
6968
7071
  # String containing the search criteria for the session search. If no
@@ -7138,7 +7241,7 @@ module Aws::GameLift
7138
7241
  #
7139
7242
  # @option params [String] :location
7140
7243
  # 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`.
7244
+ # the form of an Amazon Web Services Region code, such as `us-west-2`.
7142
7245
  #
7143
7246
  # @return [Types::StartFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7144
7247
  #
@@ -7169,26 +7272,26 @@ module Aws::GameLift
7169
7272
 
7170
7273
  # Places a request for a new game session in a queue (see
7171
7274
  # CreateGameSessionQueue). When processing a placement request, Amazon
7172
- # GameLift searches for available resources on the queue's
7275
+ # Web Services searches for available resources on the queue's
7173
7276
  # destinations, scanning each until it finds resources or the placement
7174
7277
  # request times out.
7175
7278
  #
7176
7279
  # A game session placement request can also request player sessions.
7177
- # When a new game session is successfully created, Amazon GameLift
7280
+ # When a new game session is successfully created, Amazon Web Services
7178
7281
  # creates a player session for each player included in the request.
7179
7282
  #
7180
- # When placing a game session, by default Amazon GameLift tries each
7283
+ # When placing a game session, by default Amazon Web Services tries each
7181
7284
  # fleet in the order they are listed in the queue configuration.
7182
7285
  # Ideally, a queue's destinations are listed in preference order.
7183
7286
  #
7184
7287
  # Alternatively, when requesting a game session with players, you can
7185
7288
  # also provide latency data for each player in relevant Regions. Latency
7186
7289
  # 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.
7290
+ # to a fleet in the Region. Amazon Web Services uses latency data to
7291
+ # reorder the list of destinations to place the game session in a Region
7292
+ # with minimal lag. If latency data is provided for multiple players,
7293
+ # Amazon Web Services calculates each Region's average lag for all
7294
+ # players and reorders to get the best game play across all players.
7192
7295
  #
7193
7296
  # To place a new game session request, specify the following:
7194
7297
  #
@@ -7255,7 +7358,7 @@ module Aws::GameLift
7255
7358
  #
7256
7359
  # @option params [Array<Types::PlayerLatency>] :player_latencies
7257
7360
  # A set of values, expressed in milliseconds, that indicates the amount
7258
- # of latency that a player experiences when connected to AWS Regions.
7361
+ # of latency that a player experiences when connected to @aws; Regions.
7259
7362
  # This information is used to try to place the new game session where it
7260
7363
  # can offer the best possible gameplay experience for the players.
7261
7364
  #
@@ -7374,6 +7477,9 @@ module Aws::GameLift
7374
7477
  # and returned with status set to QUEUED. Track the status of backfill
7375
7478
  # tickets using the same method for tracking tickets for new matches.
7376
7479
  #
7480
+ # Only game sessions created by FlexMatch are supported for match
7481
+ # backfill.
7482
+ #
7377
7483
  # **Learn more**
7378
7484
  #
7379
7485
  # [ Backfill existing games with FlexMatch][1]
@@ -7396,7 +7502,7 @@ module Aws::GameLift
7396
7502
  #
7397
7503
  # @option params [String] :ticket_id
7398
7504
  # 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
7505
+ # specified here, Amazon Web Services will generate one in the form of a
7400
7506
  # UUID. Use this identifier to track the match backfill ticket status
7401
7507
  # and retrieve match results.
7402
7508
  #
@@ -7422,6 +7528,9 @@ module Aws::GameLift
7422
7528
  # matchmaker data is in JSON syntax, formatted as a string. For more
7423
7529
  # details, see [ Match Data][1].
7424
7530
  #
7531
+ # The backfill request must specify the team membership for every
7532
+ # player. Do not specify team if you are not using backfill.
7533
+ #
7425
7534
  # * LatencyInMs -- If the matchmaker uses player latency, include a
7426
7535
  # latency value, in milliseconds, for the Region that the game session
7427
7536
  # is currently in. Do not include latency values for any other Region.
@@ -7508,7 +7617,7 @@ module Aws::GameLift
7508
7617
  # Track matchmaking events to respond as needed and acquire game session
7509
7618
  # connection information for successfully completed matches. Ticket
7510
7619
  # status updates are tracked using event notification through Amazon
7511
- # Simple Notification Service (SNS), which is defined in the matchmaking
7620
+ # Simple Notification Service, which is defined in the matchmaking
7512
7621
  # configuration.
7513
7622
  #
7514
7623
  # **Learn more**
@@ -7533,7 +7642,7 @@ module Aws::GameLift
7533
7642
  #
7534
7643
  # @option params [String] :ticket_id
7535
7644
  # 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
7645
+ # specified here, Amazon Web Services will generate one in the form of a
7537
7646
  # UUID. Use this identifier to track the matchmaking ticket status and
7538
7647
  # retrieve match results.
7539
7648
  #
@@ -7658,7 +7767,7 @@ module Aws::GameLift
7658
7767
  #
7659
7768
  # @option params [String] :location
7660
7769
  # 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`.
7770
+ # the form of an Amazon Web Services Region code, such as `us-west-2`.
7662
7771
  #
7663
7772
  # @return [Types::StopFleetActionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7664
7773
  #
@@ -7888,12 +7997,12 @@ module Aws::GameLift
7888
7997
  req.send_request(options)
7889
7998
  end
7890
7999
 
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:
8000
+ # Assigns a tag to a GameLift resource. Amazon Web Services resource
8001
+ # tags provide an additional management tool set. You can use tags to
8002
+ # organize resources, create IAM permissions policies to manage access
8003
+ # to groups of resources, customize Amazon Web Services cost breakdowns,
8004
+ # etc. This operation handles the permissions necessary to manage tags
8005
+ # for the following GameLift resource types:
7897
8006
  #
7898
8007
  # * Build
7899
8008
  #
@@ -7916,9 +8025,10 @@ module Aws::GameLift
7916
8025
  #
7917
8026
  # **Learn more**
7918
8027
  #
7919
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8028
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8029
+ # General Reference*
7920
8030
  #
7921
- # [ AWS Tagging Strategies][2]
8031
+ # [ Amazon Web Services Tagging Strategies][2]
7922
8032
  #
7923
8033
  # **Related actions**
7924
8034
  #
@@ -7946,7 +8056,7 @@ module Aws::GameLift
7946
8056
  # A list of one or more tags to assign to the specified GameLift
7947
8057
  # resource. Tags are developer-defined and structured as key-value
7948
8058
  # pairs. The maximum tag limit may be lower than stated. See [ Tagging
7949
- # AWS Resources][1] for actual tagging limits.
8059
+ # Amazon Web Services Resources][1] for actual tagging limits.
7950
8060
  #
7951
8061
  #
7952
8062
  #
@@ -7976,9 +8086,9 @@ module Aws::GameLift
7976
8086
  end
7977
8087
 
7978
8088
  # 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:
8089
+ # are used to organize Amazon Web Services resources for a range of
8090
+ # purposes. This operation handles the permissions necessary to manage
8091
+ # tags for the following GameLift resource types:
7982
8092
  #
7983
8093
  # * Build
7984
8094
  #
@@ -8001,9 +8111,10 @@ module Aws::GameLift
8001
8111
  #
8002
8112
  # **Learn more**
8003
8113
  #
8004
- # [Tagging AWS Resources][1] in the *AWS General Reference*
8114
+ # [Tagging Amazon Web Services Resources][1] in the *Amazon Web Services
8115
+ # General Reference*
8005
8116
  #
8006
- # [ AWS Tagging Strategies][2]
8117
+ # [ Amazon Web Services Tagging Strategies][2]
8007
8118
  #
8008
8119
  # **Related actions**
8009
8120
  #
@@ -8029,8 +8140,9 @@ module Aws::GameLift
8029
8140
  #
8030
8141
  # @option params [required, Array<String>] :tag_keys
8031
8142
  # 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.
8143
+ # resource. An Amazon Web Services resource can have only one tag with a
8144
+ # specific tag key, so specifying the tag key identifies which tag to
8145
+ # remove.
8034
8146
  #
8035
8147
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
8036
8148
  #
@@ -8282,12 +8394,12 @@ module Aws::GameLift
8282
8394
  # whether the capacity is changed manually or through automatic
8283
8395
  # scaling.
8284
8396
  #
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.
8397
+ # * Desired capacity: Manually set the number of Amazon EC2 instances to
8398
+ # be maintained in a fleet location. Before changing a fleet's
8399
+ # desired capacity, you may want to call DescribeEC2InstanceLimits to
8400
+ # get the maximum capacity of the fleet's Amazon EC2 instance type.
8401
+ # Alternatively, consider using automatic scaling to adjust capacity
8402
+ # based on player demand.
8291
8403
  #
8292
8404
  # This operation can be used in the following ways:
8293
8405
  #
@@ -8331,9 +8443,9 @@ module Aws::GameLift
8331
8443
  # can use either the fleet ID or ARN value.
8332
8444
  #
8333
8445
  # @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.
8446
+ # The number of Amazon EC2 instances you want to maintain in the
8447
+ # specified fleet location. This value must fall between the minimum and
8448
+ # maximum size limits.
8337
8449
  #
8338
8450
  # @option params [Integer] :min_size
8339
8451
  # The minimum number of instances that are allowed in the specified
@@ -8345,7 +8457,7 @@ module Aws::GameLift
8345
8457
  #
8346
8458
  # @option params [String] :location
8347
8459
  # 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`.
8460
+ # in the form of an Amazon Web Services Region code such as `us-west-2`.
8349
8461
  #
8350
8462
  # @return [Types::UpdateFleetCapacityOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8351
8463
  #
@@ -8600,24 +8712,24 @@ module Aws::GameLift
8600
8712
  #
8601
8713
  # @option params [String] :role_arn
8602
8714
  # The Amazon Resource Name ([ARN][1]) for an IAM role that allows Amazon
8603
- # GameLift to access your EC2 Auto Scaling groups.
8715
+ # Web Services to access your Amazon EC2 Auto Scaling groups.
8604
8716
  #
8605
8717
  #
8606
8718
  #
8607
8719
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
8608
8720
  #
8609
8721
  # @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.
8722
+ # An updated list of Amazon EC2 instance types to use in the Auto
8723
+ # Scaling group. The instance definitions must specify at least two
8724
+ # different instance types that are supported by GameLift FleetIQ. This
8725
+ # updated list replaces the entire current list of instance definitions
8726
+ # for the game server group. For more information on instance types, see
8727
+ # [EC2 Instance Types][1] in the *Amazon EC2 User Guide*. You can
8728
+ # optionally specify capacity weighting for each instance type. If no
8729
+ # weight value is specified for an instance type, it is set to the
8730
+ # default value "1". For more information about capacity weighting,
8731
+ # see [ Instance Weighting for Amazon EC2 Auto Scaling][2] in the Amazon
8732
+ # EC2 Auto Scaling User Guide.
8621
8733
  #
8622
8734
  #
8623
8735
  #
@@ -8632,8 +8744,8 @@ module Aws::GameLift
8632
8744
  # instances cannot be terminated while there are active game servers
8633
8745
  # running except in the event of a forced game server group deletion
8634
8746
  # (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.
8747
+ # terminated by Amazon Web Services regardless of protection status.
8748
+ # This property is set to `NO_PROTECTION` by default.
8637
8749
  #
8638
8750
  # @option params [String] :balancing_strategy
8639
8751
  # Indicates how GameLift FleetIQ balances the use of Spot Instances and
@@ -8805,14 +8917,18 @@ module Aws::GameLift
8805
8917
  #
8806
8918
  # **Related actions**
8807
8919
  #
8808
- # CreateGameSessionQueue \| DescribeGameSessionQueues \|
8809
- # UpdateGameSessionQueue \| DeleteGameSessionQueue \| [All APIs by
8810
- # task][2]
8920
+ # [CreateGameSessionQueue][2] \| [DescribeGameSessionQueues][3] \|
8921
+ # [UpdateGameSessionQueue][4] \| [DeleteGameSessionQueue][5] \| [All
8922
+ # APIs by task][6]
8811
8923
  #
8812
8924
  #
8813
8925
  #
8814
8926
  # [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
8927
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSessionQueue.html
8928
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeGameSessionQueues.html
8929
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSessionQueue.html
8930
+ # [5]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_DeleteGameSessionQueue.html
8931
+ # [6]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
8816
8932
  #
8817
8933
  # @option params [required, String] :name
8818
8934
  # A descriptive label that is associated with game session queue. Queue
@@ -8843,10 +8959,10 @@ module Aws::GameLift
8843
8959
  #
8844
8960
  # @option params [Types::FilterConfiguration] :filter_configuration
8845
8961
  # 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.
8962
+ # sessions. Locations are specified in the form of Amazon Web Services
8963
+ # Region codes, such as `us-west-2`. If this parameter is not set, game
8964
+ # sessions can be placed in any queue location. To remove an existing
8965
+ # filter configuration, pass in an empty set.
8850
8966
  #
8851
8967
  # @option params [Types::PriorityConfiguration] :priority_configuration
8852
8968
  # Custom settings to use when prioritizing destinations and locations
@@ -9221,13 +9337,13 @@ module Aws::GameLift
9221
9337
  # the *Version* parameter to track updates to the script.
9222
9338
  #
9223
9339
  # 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.
9340
+ # script record and a revised script is uploaded to the Amazon Web
9341
+ # Services service. Once the script is updated and acquired by a fleet
9342
+ # instance, the new version is used for all new game sessions.
9227
9343
  #
9228
9344
  # **Learn more**
9229
9345
  #
9230
- # [Amazon GameLift Realtime Servers][1]
9346
+ # [Amazon Web Services Realtime Servers][1]
9231
9347
  #
9232
9348
  # **Related actions**
9233
9349
  #
@@ -9255,21 +9371,22 @@ module Aws::GameLift
9255
9371
  # The location of the Amazon S3 bucket where a zipped file containing
9256
9372
  # your Realtime scripts is stored. The storage location must specify the
9257
9373
  # 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.
9374
+ # that allows Amazon Web Services to access the Amazon S3 storage
9375
+ # location. The S3 bucket must be in the same Region where you want to
9376
+ # create a new script. By default, Amazon Web Services uploads the
9377
+ # latest version of the zip file; if you have S3 object versioning
9378
+ # turned on, you can use the `ObjectVersion` parameter to specify an
9379
+ # earlier version.
9263
9380
  #
9264
9381
  # @option params [String, StringIO, File] :zip_file
9265
9382
  # A data object containing your Realtime scripts and dependencies as a
9266
9383
  # zip file. The zip file can have one or multiple files. Maximum size of
9267
9384
  # a zip file is 5 MB.
9268
9385
  #
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`.
9386
+ # When using the Amazon Web Services CLI tool to create a script, this
9387
+ # parameter is set to the zip file name. It must be prepended with the
9388
+ # string "fileb://" to indicate that the file data is a binary object.
9389
+ # For example: `--zip-file fileb://myRealtimeScript.zip`.
9273
9390
  #
9274
9391
  # @return [Types::UpdateScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9275
9392
  #
@@ -9376,7 +9493,7 @@ module Aws::GameLift
9376
9493
  params: params,
9377
9494
  config: config)
9378
9495
  context[:gem_name] = 'aws-sdk-gamelift'
9379
- context[:gem_version] = '1.53.0'
9496
+ context[:gem_version] = '1.54.0'
9380
9497
  Seahorse::Client::Request.new(handlers, context)
9381
9498
  end
9382
9499