aws-sdk-gamelift 1.15.0 → 1.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: c21cd244f14a7d3500a4833540b4b2f1f7768321
4
- data.tar.gz: e5afeb77dca8f0670ce40c6e7f47c1491d2e1090
3
+ metadata.gz: e48c62250e666e53c0f491df9ae2375ccdf9e0aa
4
+ data.tar.gz: 617527e55b0c21872aa602dd2dd683c63a5b4249
5
5
  SHA512:
6
- metadata.gz: e7039a440301ffffde3d233325c1d06f90cef08d81ae581641cb40406d7c9e77d0a352fbd742b44a139d7f25291e6d25421ec43ef2ce9ebf0d05b290d0e9bc09
7
- data.tar.gz: 6b1f0180c9043c5c50c93a23ce585a228418346c57d4da27639e90df71856992c7eef3d9b768f915a44a043e13b572b5cb212c9da073e13f198afc617c18a639
6
+ metadata.gz: d50cda69f5befe6bbb7648a52c458a7e94104b8ec2dea24263b2b7511fbedef2b796ee2b5a370ecd9e9e531fca027eb98915b1e5526deb1a4b65aa4a1c913aec
7
+ data.tar.gz: 667fecf7462b9b12561473032daeca25bf321b6d898635c2acd21b7e58f101d53aa77a8a336f72517a63a93e86b7f2731a770ed2fda4a2464f5b7e36364f26e0
@@ -42,6 +42,6 @@ require_relative 'aws-sdk-gamelift/customizations'
42
42
  # @service
43
43
  module Aws::GameLift
44
44
 
45
- GEM_VERSION = '1.15.0'
45
+ GEM_VERSION = '1.16.0'
46
46
 
47
47
  end
@@ -209,6 +209,49 @@ module Aws::GameLift
209
209
  # When `true`, request parameters are validated before
210
210
  # sending the request.
211
211
  #
212
+ # @option options [URI::HTTP,String] :http_proxy A proxy to send
213
+ # requests through. Formatted like 'http://proxy.com:123'.
214
+ #
215
+ # @option options [Float] :http_open_timeout (15) The number of
216
+ # seconds to wait when opening a HTTP session before rasing a
217
+ # `Timeout::Error`.
218
+ #
219
+ # @option options [Integer] :http_read_timeout (60) The default
220
+ # number of seconds to wait for response data. This value can
221
+ # safely be set
222
+ # per-request on the session yeidled by {#session_for}.
223
+ #
224
+ # @option options [Float] :http_idle_timeout (5) The number of
225
+ # seconds a connection is allowed to sit idble before it is
226
+ # considered stale. Stale connections are closed and removed
227
+ # from the pool before making a request.
228
+ #
229
+ # @option options [Float] :http_continue_timeout (1) The number of
230
+ # seconds to wait for a 100-continue response before sending the
231
+ # request body. This option has no effect unless the request has
232
+ # "Expect" header set to "100-continue". Defaults to `nil` which
233
+ # disables this behaviour. This value can safely be set per
234
+ # request on the session yeidled by {#session_for}.
235
+ #
236
+ # @option options [Boolean] :http_wire_trace (false) When `true`,
237
+ # HTTP debug output will be sent to the `:logger`.
238
+ #
239
+ # @option options [Boolean] :ssl_verify_peer (true) When `true`,
240
+ # SSL peer certificates are verified when establishing a
241
+ # connection.
242
+ #
243
+ # @option options [String] :ssl_ca_bundle Full path to the SSL
244
+ # certificate authority bundle file that should be used when
245
+ # verifying peer certificates. If you do not pass
246
+ # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
247
+ # will be used if available.
248
+ #
249
+ # @option options [String] :ssl_ca_directory Full path of the
250
+ # directory that contains the unbundled SSL certificate
251
+ # authority files for verifying peer certificates. If you do
252
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
253
+ # system default will be used if available.
254
+ #
212
255
  def initialize(*args)
213
256
  super
214
257
  end
@@ -428,17 +471,18 @@ module Aws::GameLift
428
471
  # need to be unique. You can use UpdateBuild to change this value later.
429
472
  #
430
473
  # @option params [String] :version
431
- # Version that is associated with this build. Version strings do not
432
- # need to be unique. You can use UpdateBuild to change this value later.
474
+ # Version that is associated with a build or script. Version strings do
475
+ # not need to be unique. You can use UpdateBuild to change this value
476
+ # later.
433
477
  #
434
478
  # @option params [Types::S3Location] :storage_location
435
479
  # Information indicating where your game build files are stored. Use
436
480
  # this parameter only when creating a build with files stored in an
437
481
  # Amazon S3 bucket that you own. The storage location must specify an
438
- # Amazon S3 bucket name and key, as well as a role ARN that you set up
439
- # to allow Amazon GameLift to access your Amazon S3 bucket. The S3
440
- # bucket must be in the same region that you want to create a new build
441
- # in.
482
+ # Amazon S3 bucket name and key, as well as a the ARN for a role that
483
+ # you set up to allow Amazon GameLift to access your Amazon S3 bucket.
484
+ # The S3 bucket must be in the same region that you want to create a new
485
+ # build in.
442
486
  #
443
487
  # @option params [String] :operating_system
444
488
  # Operating system that the game server binaries are built to run on.
@@ -463,6 +507,7 @@ module Aws::GameLift
463
507
  # bucket: "NonEmptyString",
464
508
  # key: "NonEmptyString",
465
509
  # role_arn: "NonEmptyString",
510
+ # object_version: "NonEmptyString",
466
511
  # },
467
512
  # operating_system: "WINDOWS_2012", # accepts WINDOWS_2012, AMAZON_LINUX
468
513
  # })
@@ -482,6 +527,7 @@ module Aws::GameLift
482
527
  # resp.storage_location.bucket #=> String
483
528
  # resp.storage_location.key #=> String
484
529
  # resp.storage_location.role_arn #=> String
530
+ # resp.storage_location.object_version #=> String
485
531
  #
486
532
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateBuild AWS API Documentation
487
533
  #
@@ -492,18 +538,26 @@ module Aws::GameLift
492
538
  req.send_request(options)
493
539
  end
494
540
 
495
- # Creates a new fleet to run your game servers. A fleet is a set of
496
- # Amazon Elastic Compute Cloud (Amazon EC2) instances, each of which can
497
- # run multiple server processes to host game sessions. You set up a
498
- # fleet to use instances with certain hardware specifications (see
499
- # [Amazon EC2 Instance Types][1]), and deploy your game build to the
500
- # fleet.
541
+ # Creates a new fleet to run your game servers. whether they are custom
542
+ # game builds or Realtime Servers with game-specific script. A fleet is
543
+ # a set of Amazon Elastic Compute Cloud (Amazon EC2) instances, each of
544
+ # which can host multiple game sessions. When creating a fleet, you
545
+ # choose the hardware specifications, set some configuration options,
546
+ # and specify the game server to deploy on the new fleet.
501
547
  #
502
548
  # To create a new fleet, you must provide the following: (1) a fleet
503
- # name, (2) an EC2 instance type, (3) the build ID for your game build,
504
- # and (4) a run-time configuration, which specifies the server processes
505
- # to run on each instance in the fleet. If fleet type is not set, the
506
- # new fleet will use on-demand instances by default.
549
+ # name, (2) an EC2 instance type and fleet type (spot or on-demand), (3)
550
+ # the build ID for your game build or script ID if using Realtime
551
+ # Servers, and (4) a run-time configuration, which determines how game
552
+ # servers will run on each instance in the fleet.
553
+ #
554
+ # <note markdown="1"> When creating a Realtime Servers fleet, we recommend using a minimal
555
+ # version of the Realtime script (see this [ working code example ][1]).
556
+ # This will make it much easier to troubleshoot any fleet creation
557
+ # issues. Once the fleet is active, you can update your Realtime script
558
+ # as needed.
559
+ #
560
+ # </note>
507
561
  #
508
562
  # If the `CreateFleet` call is successful, Amazon GameLift performs the
509
563
  # following tasks. You can track the process of a fleet by checking the
@@ -517,8 +571,8 @@ module Aws::GameLift
517
571
  # Sets the fleet's target capacity to 1 (desired instances), which
518
572
  # triggers Amazon GameLift to start one new EC2 instance.
519
573
  #
520
- # * Downloads the game build to the new instance and installs it.
521
- # Statuses: `DOWNLOADING`, `VALIDATING`, `BUILDING`.
574
+ # * Downloads the game build or Realtime script to the new instance and
575
+ # installs it. Statuses: `DOWNLOADING`, `VALIDATING`, `BUILDING`.
522
576
  #
523
577
  # * Starts launching server processes on the instance. If the fleet is
524
578
  # configured to run multiple server processes per instance, Amazon
@@ -530,7 +584,9 @@ module Aws::GameLift
530
584
  #
531
585
  # **Learn more**
532
586
  #
533
- # [ Working with Fleets][2].
587
+ # [ Working with Fleets][2]
588
+ #
589
+ # [ Debug Fleet Creation Issues][3]
534
590
  #
535
591
  # **Related operations**
536
592
  #
@@ -574,8 +630,9 @@ module Aws::GameLift
574
630
  #
575
631
  #
576
632
  #
577
- # [1]: http://aws.amazon.com/ec2/instance-types/
633
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-script.html#realtime-script-examples
578
634
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html
635
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html
579
636
  #
580
637
  # @option params [required, String] :name
581
638
  # Descriptive label that is associated with a fleet. Fleet names do not
@@ -584,11 +641,17 @@ module Aws::GameLift
584
641
  # @option params [String] :description
585
642
  # Human-readable description of a fleet.
586
643
  #
587
- # @option params [required, String] :build_id
644
+ # @option params [String] :build_id
588
645
  # Unique identifier for a build to be deployed on the new fleet. The
589
- # build must have been successfully uploaded to Amazon GameLift and be
590
- # in a `READY` status. This fleet setting cannot be changed once the
591
- # fleet is created.
646
+ # custom game server build must have been successfully uploaded to
647
+ # Amazon GameLift and be in a `READY` status. This fleet setting cannot
648
+ # be changed once the fleet is created.
649
+ #
650
+ # @option params [String] :script_id
651
+ # Unique identifier for a Realtime script to be deployed on the new
652
+ # fleet. The Realtime script must have been successfully uploaded to
653
+ # Amazon GameLift. This fleet setting cannot be changed once the fleet
654
+ # is created.
592
655
  #
593
656
  # @option params [String] :server_launch_path
594
657
  # This parameter is no longer used. Instead, specify a server launch
@@ -626,10 +689,12 @@ module Aws::GameLift
626
689
  #
627
690
  # @option params [Array<Types::IpPermission>] :ec2_inbound_permissions
628
691
  # Range of IP addresses and port settings that permit inbound traffic to
629
- # access server processes running on the fleet. If no inbound
630
- # permissions are set, including both IP address range and port range,
631
- # the server processes in the fleet cannot accept connections. You can
632
- # specify one or more sets of permissions for a fleet.
692
+ # access game sessions that running on the fleet. For fleets using a
693
+ # custom game build, this parameter is required before game sessions
694
+ # running on the fleet can accept connections. For Realtime Servers
695
+ # fleets, Amazon GameLift automatically sets TCP and UDP ranges for use
696
+ # by the Realtime servers. You can specify multiple permission settings
697
+ # or add more by updating the fleet.
633
698
  #
634
699
  # @option params [String] :new_game_session_protection_policy
635
700
  # Game session protection policy to apply to all instances in this
@@ -647,17 +712,13 @@ module Aws::GameLift
647
712
  #
648
713
  # @option params [Types::RuntimeConfiguration] :runtime_configuration
649
714
  # Instructions for launching server processes on each instance in the
650
- # fleet. The run-time configuration for a fleet has a collection of
651
- # server process configurations, one for each type of server process to
652
- # run on an instance. A server process configuration specifies the
653
- # location of the server executable, launch parameters, and the number
654
- # of concurrent processes with that configuration to maintain on each
655
- # instance. A CreateFleet request must include a run-time configuration
656
- # with at least one server process configuration; otherwise the request
657
- # fails with an invalid request exception. (This parameter replaces the
658
- # parameters `ServerLaunchPath` and `ServerLaunchParameters`; requests
659
- # that contain values for these parameters instead of a run-time
660
- # configuration will continue to work.)
715
+ # fleet. Server processes run either a custom game build executable or a
716
+ # Realtime Servers script. The run-time configuration lists the types of
717
+ # server processes to run on an instance and includes the following
718
+ # configuration settings: the server executable or launch script file,
719
+ # launch parameters, and the number of processes to run concurrently on
720
+ # each instance. A CreateFleet request must include a run-time
721
+ # configuration with at least one server process configuration.
661
722
  #
662
723
  # @option params [Types::ResourceCreationLimitPolicy] :resource_creation_limit_policy
663
724
  # Policy that limits the number of game sessions an individual player
@@ -690,26 +751,22 @@ module Aws::GameLift
690
751
  # @option params [String] :fleet_type
691
752
  # Indicates whether to use on-demand instances or spot instances for
692
753
  # this fleet. If empty, the default is ON\_DEMAND. Both categories of
693
- # instances use identical hardware and configurations, based on the
694
- # instance type selected for this fleet. You can acquire on-demand
695
- # instances at any time for a fixed price and keep them as long as you
696
- # need them. Spot instances have lower prices, but spot pricing is
697
- # variable, and while in use they can be interrupted (with a two-minute
698
- # notification). Learn more about Amazon GameLift spot instances with at
699
- # [ Set up Access to External Services][1].
754
+ # instances use identical hardware and configurations based on the
755
+ # instance type selected for this fleet. Learn more about [ On-Demand
756
+ # versus Spot Instances][1].
700
757
  #
701
758
  #
702
759
  #
703
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-credentials.html
760
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
704
761
  #
705
762
  # @option params [String] :instance_role_arn
706
763
  # Unique identifier for an AWS IAM role that manages access to your AWS
707
- # services. Any application that runs on an instance in this fleet can
708
- # assume the role, including install scripts, server processs, daemons
709
- # (background processes). Create a role or look up a role's ARN using
710
- # the [IAM dashboard][1] in the AWS Management Console. Learn more about
711
- # using on-box credentials for your game servers at [ Access external
712
- # resources from a game server][2].
764
+ # services. With an instance role ARN set, any application that runs on
765
+ # an instance in this fleet can assume the role, including install
766
+ # scripts, server processes, daemons (background processes). Create a
767
+ # role or look up a role's ARN using the [IAM dashboard][1] in the AWS
768
+ # Management Console. Learn more about using on-box credentials for your
769
+ # game servers at [ Access external resources from a game server][2].
713
770
  #
714
771
  #
715
772
  #
@@ -725,7 +782,8 @@ module Aws::GameLift
725
782
  # resp = client.create_fleet({
726
783
  # name: "NonZeroAndMaxString", # required
727
784
  # description: "NonZeroAndMaxString",
728
- # build_id: "BuildId", # required
785
+ # build_id: "BuildId",
786
+ # script_id: "ScriptId",
729
787
  # server_launch_path: "NonZeroAndMaxString",
730
788
  # server_launch_parameters: "NonZeroAndMaxString",
731
789
  # log_paths: ["NonZeroAndMaxString"],
@@ -773,6 +831,7 @@ module Aws::GameLift
773
831
  # resp.fleet_attributes.termination_time #=> Time
774
832
  # resp.fleet_attributes.status #=> String, one of "NEW", "DOWNLOADING", "VALIDATING", "BUILDING", "ACTIVATING", "ACTIVE", "DELETING", "ERROR", "TERMINATED"
775
833
  # resp.fleet_attributes.build_id #=> String
834
+ # resp.fleet_attributes.script_id #=> String
776
835
  # resp.fleet_attributes.server_launch_path #=> String
777
836
  # resp.fleet_attributes.server_launch_parameters #=> String
778
837
  # resp.fleet_attributes.log_paths #=> Array
@@ -1341,16 +1400,18 @@ module Aws::GameLift
1341
1400
  req.send_request(options)
1342
1401
  end
1343
1402
 
1344
- # Adds a player to a game session and creates a player session record.
1345
- # Before a player can be added, a game session must have an `ACTIVE`
1346
- # status, have a creation policy of `ALLOW_ALL`, and have an open player
1347
- # slot. To add a group of players to a game session, use
1348
- # CreatePlayerSessions.
1403
+ # Reserves an open player slot in an active game session. Before a
1404
+ # player can be added, a game session must have an `ACTIVE` status, have
1405
+ # a creation policy of `ALLOW_ALL`, and have an open player slot. To add
1406
+ # a group of players to a game session, use CreatePlayerSessions. When
1407
+ # the player connects to the game server and references a player session
1408
+ # ID, the game server contacts the Amazon GameLift service to validate
1409
+ # the player reservation and accept the player.
1349
1410
  #
1350
1411
  # To create a player session, specify a game session ID, player ID, and
1351
- # optionally a string of player data. If successful, the player is added
1352
- # to the game session and a new PlayerSession object is returned. Player
1353
- # sessions cannot be updated.
1412
+ # optionally a string of player data. If successful, a slot is reserved
1413
+ # in the game session for the player and a new PlayerSession object is
1414
+ # returned. Player sessions cannot be updated.
1354
1415
  #
1355
1416
  # *Available in Amazon GameLift Local.*
1356
1417
  #
@@ -1413,16 +1474,18 @@ module Aws::GameLift
1413
1474
  req.send_request(options)
1414
1475
  end
1415
1476
 
1416
- # Adds a group of players to a game session. This action is useful with
1417
- # a team matching feature. Before players can be added, a game session
1418
- # must have an `ACTIVE` status, have a creation policy of `ALLOW_ALL`,
1419
- # and have an open player slot. To add a single player to a game
1420
- # session, use CreatePlayerSession.
1477
+ # Reserves open slots in a game session for a group of players. Before
1478
+ # players can be added, a game session must have an `ACTIVE` status,
1479
+ # have a creation policy of `ALLOW_ALL`, and have an open player slot.
1480
+ # To add a single player to a game session, use CreatePlayerSession.
1481
+ # When a player connects to the game server and references a player
1482
+ # session ID, the game server contacts the Amazon GameLift service to
1483
+ # validate the player reservation and accept the player.
1421
1484
  #
1422
1485
  # To create player sessions, specify a game session ID, a list of player
1423
- # IDs, and optionally a set of player data strings. If successful, the
1424
- # players are added to the game session and a set of new PlayerSession
1425
- # objects is returned. Player sessions cannot be updated.
1486
+ # IDs, and optionally a set of player data strings. If successful, a
1487
+ # slot is reserved in the game session for each player and a set of new
1488
+ # PlayerSession objects is returned. Player sessions cannot be updated.
1426
1489
  #
1427
1490
  # *Available in Amazon GameLift Local.*
1428
1491
  #
@@ -1490,6 +1553,124 @@ module Aws::GameLift
1490
1553
  req.send_request(options)
1491
1554
  end
1492
1555
 
1556
+ # Creates a new script record for your Realtime Servers script. Realtime
1557
+ # scripts are JavaScript that provide configuration settings and
1558
+ # optional custom game logic for your game. The script is deployed when
1559
+ # you create a Realtime Servers fleet to host your game sessions. Script
1560
+ # logic is executed during an active game session.
1561
+ #
1562
+ # To create a new script record, specify a script name and provide the
1563
+ # script file(s). The script files and all dependencies must be zipped
1564
+ # into a single file. You can pull the zip file from either of these
1565
+ # locations:
1566
+ #
1567
+ # * A locally available directory. Use the *ZipFile* parameter for this
1568
+ # option.
1569
+ #
1570
+ # * An Amazon Simple Storage Service (Amazon S3) bucket under your AWS
1571
+ # account. Use the *StorageLocation* parameter for this option.
1572
+ # You'll need to have an Identity Access Management (IAM) role that
1573
+ # allows the Amazon GameLift service to access your S3 bucket.
1574
+ #
1575
+ # If the call is successful, a new script record is created with a
1576
+ # unique script ID. If the script file is provided as a local file, the
1577
+ # file is uploaded to an Amazon GameLift-owned S3 bucket and the script
1578
+ # record's storage location reflects this location. If the script file
1579
+ # is provided as an S3 bucket, Amazon GameLift accesses the file at this
1580
+ # storage location as needed for deployment.
1581
+ #
1582
+ # **Learn more**
1583
+ #
1584
+ # [Amazon GameLift Realtime Servers][1]
1585
+ #
1586
+ # [Set Up a Role for Amazon GameLift Access][2]
1587
+ #
1588
+ # **Related operations**
1589
+ #
1590
+ # * CreateScript
1591
+ #
1592
+ # * ListScripts
1593
+ #
1594
+ # * DescribeScript
1595
+ #
1596
+ # * UpdateScript
1597
+ #
1598
+ # * DeleteScript
1599
+ #
1600
+ #
1601
+ #
1602
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html
1603
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
1604
+ #
1605
+ # @option params [String] :name
1606
+ # Descriptive label that is associated with a script. Script names do
1607
+ # not need to be unique. You can use UpdateScript to change this value
1608
+ # later.
1609
+ #
1610
+ # @option params [String] :version
1611
+ # Version that is associated with a build or script. Version strings do
1612
+ # not need to be unique. You can use UpdateScript to change this value
1613
+ # later.
1614
+ #
1615
+ # @option params [Types::S3Location] :storage_location
1616
+ # Location of the Amazon S3 bucket where a zipped file containing your
1617
+ # Realtime scripts is stored. The storage location must specify the
1618
+ # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
1619
+ # that allows Amazon GameLift to access the Amazon S3 storage location.
1620
+ # The S3 bucket must be in the same region where you want to create a
1621
+ # new script. By default, Amazon GameLift uploads the latest version of
1622
+ # the zip file; if you have S3 object versioning turned on, you can use
1623
+ # the `ObjectVersion` parameter to specify an earlier version.
1624
+ #
1625
+ # @option params [String, IO] :zip_file
1626
+ # Data object containing your Realtime scripts and dependencies as a zip
1627
+ # file. The zip file can have one or multiple files. Maximum size of a
1628
+ # zip file is 5 MB.
1629
+ #
1630
+ # When using the AWS CLI tool to create a script, this parameter is set
1631
+ # to the zip file name. It must be prepended with the string
1632
+ # "fileb://" to indicate that the file data is a binary object. For
1633
+ # example: `--zip-file fileb://myRealtimeScript.zip`.
1634
+ #
1635
+ # @return [Types::CreateScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1636
+ #
1637
+ # * {Types::CreateScriptOutput#script #script} => Types::Script
1638
+ #
1639
+ # @example Request syntax with placeholder values
1640
+ #
1641
+ # resp = client.create_script({
1642
+ # name: "NonZeroAndMaxString",
1643
+ # version: "NonZeroAndMaxString",
1644
+ # storage_location: {
1645
+ # bucket: "NonEmptyString",
1646
+ # key: "NonEmptyString",
1647
+ # role_arn: "NonEmptyString",
1648
+ # object_version: "NonEmptyString",
1649
+ # },
1650
+ # zip_file: "data",
1651
+ # })
1652
+ #
1653
+ # @example Response structure
1654
+ #
1655
+ # resp.script.script_id #=> String
1656
+ # resp.script.name #=> String
1657
+ # resp.script.version #=> String
1658
+ # resp.script.size_on_disk #=> Integer
1659
+ # resp.script.creation_time #=> Time
1660
+ # resp.script.storage_location.bucket #=> String
1661
+ # resp.script.storage_location.key #=> String
1662
+ # resp.script.storage_location.role_arn #=> String
1663
+ # resp.script.storage_location.object_version #=> String
1664
+ #
1665
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateScript AWS API Documentation
1666
+ #
1667
+ # @overload create_script(params = {})
1668
+ # @param [Hash] params ({})
1669
+ def create_script(params = {}, options = {})
1670
+ req = build_request(:create_script, params)
1671
+ req.send_request(options)
1672
+ end
1673
+
1493
1674
  # Requests authorization to create or delete a peer connection between
1494
1675
  # the VPC for your Amazon GameLift fleet and a virtual private cloud
1495
1676
  # (VPC) in your AWS account. VPC peering enables the game servers on
@@ -2006,6 +2187,56 @@ module Aws::GameLift
2006
2187
  req.send_request(options)
2007
2188
  end
2008
2189
 
2190
+ # Deletes a Realtime script. This action permanently deletes the script
2191
+ # record. If script files were uploaded, they are also deleted (files
2192
+ # stored in an S3 bucket are not deleted).
2193
+ #
2194
+ # To delete a script, specify the script ID. Before deleting a script,
2195
+ # be sure to terminate all fleets that are deployed with the script
2196
+ # being deleted. Fleet instances periodically check for script updates,
2197
+ # and if the script record no longer exists, the instance will go into
2198
+ # an error state and be unable to host game sessions.
2199
+ #
2200
+ # **Learn more**
2201
+ #
2202
+ # [Amazon GameLift Realtime Servers][1]
2203
+ #
2204
+ # **Related operations**
2205
+ #
2206
+ # * CreateScript
2207
+ #
2208
+ # * ListScripts
2209
+ #
2210
+ # * DescribeScript
2211
+ #
2212
+ # * UpdateScript
2213
+ #
2214
+ # * DeleteScript
2215
+ #
2216
+ #
2217
+ #
2218
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html
2219
+ #
2220
+ # @option params [required, String] :script_id
2221
+ # Unique identifier for a Realtime script to delete.
2222
+ #
2223
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2224
+ #
2225
+ # @example Request syntax with placeholder values
2226
+ #
2227
+ # resp = client.delete_script({
2228
+ # script_id: "ScriptId", # required
2229
+ # })
2230
+ #
2231
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteScript AWS API Documentation
2232
+ #
2233
+ # @overload delete_script(params = {})
2234
+ # @param [Hash] params ({})
2235
+ def delete_script(params = {}, options = {})
2236
+ req = build_request(:delete_script, params)
2237
+ req.send_request(options)
2238
+ end
2239
+
2009
2240
  # Cancels a pending VPC peering authorization for the specified VPC. If
2010
2241
  # the authorization has already been used to create a peering
2011
2242
  # connection, call DeleteVpcPeeringConnection to remove the connection.
@@ -2420,6 +2651,7 @@ module Aws::GameLift
2420
2651
  # resp.fleet_attributes[0].termination_time #=> Time
2421
2652
  # resp.fleet_attributes[0].status #=> String, one of "NEW", "DOWNLOADING", "VALIDATING", "BUILDING", "ACTIVATING", "ACTIVE", "DELETING", "ERROR", "TERMINATED"
2422
2653
  # resp.fleet_attributes[0].build_id #=> String
2654
+ # resp.fleet_attributes[0].script_id #=> String
2423
2655
  # resp.fleet_attributes[0].server_launch_path #=> String
2424
2656
  # resp.fleet_attributes[0].server_launch_parameters #=> String
2425
2657
  # resp.fleet_attributes[0].log_paths #=> Array
@@ -3818,6 +4050,65 @@ module Aws::GameLift
3818
4050
  req.send_request(options)
3819
4051
  end
3820
4052
 
4053
+ # Retrieves properties for a Realtime script.
4054
+ #
4055
+ # To request a script record, specify the script ID. If successful, an
4056
+ # object containing the script properties is returned.
4057
+ #
4058
+ # **Learn more**
4059
+ #
4060
+ # [Amazon GameLift Realtime Servers][1]
4061
+ #
4062
+ # **Related operations**
4063
+ #
4064
+ # * CreateScript
4065
+ #
4066
+ # * ListScripts
4067
+ #
4068
+ # * DescribeScript
4069
+ #
4070
+ # * UpdateScript
4071
+ #
4072
+ # * DeleteScript
4073
+ #
4074
+ #
4075
+ #
4076
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html
4077
+ #
4078
+ # @option params [required, String] :script_id
4079
+ # Unique identifier for a Realtime script to retrieve properties for.
4080
+ #
4081
+ # @return [Types::DescribeScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4082
+ #
4083
+ # * {Types::DescribeScriptOutput#script #script} => Types::Script
4084
+ #
4085
+ # @example Request syntax with placeholder values
4086
+ #
4087
+ # resp = client.describe_script({
4088
+ # script_id: "ScriptId", # required
4089
+ # })
4090
+ #
4091
+ # @example Response structure
4092
+ #
4093
+ # resp.script.script_id #=> String
4094
+ # resp.script.name #=> String
4095
+ # resp.script.version #=> String
4096
+ # resp.script.size_on_disk #=> Integer
4097
+ # resp.script.creation_time #=> Time
4098
+ # resp.script.storage_location.bucket #=> String
4099
+ # resp.script.storage_location.key #=> String
4100
+ # resp.script.storage_location.role_arn #=> String
4101
+ # resp.script.storage_location.object_version #=> String
4102
+ #
4103
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeScript AWS API Documentation
4104
+ #
4105
+ # @overload describe_script(params = {})
4106
+ # @param [Hash] params ({})
4107
+ def describe_script(params = {}, options = {})
4108
+ req = build_request(:describe_script, params)
4109
+ req.send_request(options)
4110
+ end
4111
+
3821
4112
  # Retrieves valid VPC peering authorizations that are pending for the
3822
4113
  # AWS account. This operation returns all VPC peering authorizations and
3823
4114
  # requests for peering. This includes those initiated and received by
@@ -4212,16 +4503,17 @@ module Aws::GameLift
4212
4503
  end
4213
4504
 
4214
4505
  # Retrieves a collection of fleet records for this AWS account. You can
4215
- # filter the result set by build ID. Use the pagination parameters to
4216
- # retrieve results in sequential pages.
4506
+ # filter the result set to find only those fleets that are deployed with
4507
+ # a specific build or script. Use the pagination parameters to retrieve
4508
+ # results in sequential pages.
4217
4509
  #
4218
- # <note markdown="1"> Fleet records are not listed in any particular order.
4510
+ # <note markdown="1"> Fleet records are not listed in a particular order.
4219
4511
  #
4220
4512
  # </note>
4221
4513
  #
4222
4514
  # **Learn more**
4223
4515
  #
4224
- # [ Working with Fleets][1].
4516
+ # [ Set Up Fleets][1].
4225
4517
  #
4226
4518
  # **Related operations**
4227
4519
  #
@@ -4272,6 +4564,11 @@ module Aws::GameLift
4272
4564
  # to return only fleets using the specified build. To retrieve all
4273
4565
  # fleets, leave this parameter empty.
4274
4566
  #
4567
+ # @option params [String] :script_id
4568
+ # Unique identifier for a Realtime script to return fleets for. Use this
4569
+ # parameter to return only fleets using the specified script. To
4570
+ # retrieve all fleets, leave this parameter empty.
4571
+ #
4275
4572
  # @option params [Integer] :limit
4276
4573
  # Maximum number of results to return. Use this parameter with
4277
4574
  # `NextToken` to get results as a set of sequential pages.
@@ -4290,6 +4587,7 @@ module Aws::GameLift
4290
4587
  #
4291
4588
  # resp = client.list_fleets({
4292
4589
  # build_id: "BuildId",
4590
+ # script_id: "ScriptId",
4293
4591
  # limit: 1,
4294
4592
  # next_token: "NonZeroAndMaxString",
4295
4593
  # })
@@ -4309,6 +4607,73 @@ module Aws::GameLift
4309
4607
  req.send_request(options)
4310
4608
  end
4311
4609
 
4610
+ # Retrieves script records for all Realtime scripts that are associated
4611
+ # with the AWS account in use.
4612
+ #
4613
+ # **Learn more**
4614
+ #
4615
+ # [Amazon GameLift Realtime Servers][1]
4616
+ #
4617
+ # **Related operations**
4618
+ #
4619
+ # * CreateScript
4620
+ #
4621
+ # * ListScripts
4622
+ #
4623
+ # * DescribeScript
4624
+ #
4625
+ # * UpdateScript
4626
+ #
4627
+ # * DeleteScript
4628
+ #
4629
+ #
4630
+ #
4631
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html
4632
+ #
4633
+ # @option params [Integer] :limit
4634
+ # Maximum number of results to return. Use this parameter with
4635
+ # `NextToken` to get results as a set of sequential pages.
4636
+ #
4637
+ # @option params [String] :next_token
4638
+ # Token that indicates the start of the next sequential page of results.
4639
+ # Use the token that is returned with a previous call to this action. To
4640
+ # start at the beginning of the result set, do not specify a value.
4641
+ #
4642
+ # @return [Types::ListScriptsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4643
+ #
4644
+ # * {Types::ListScriptsOutput#scripts #scripts} => Array&lt;Types::Script&gt;
4645
+ # * {Types::ListScriptsOutput#next_token #next_token} => String
4646
+ #
4647
+ # @example Request syntax with placeholder values
4648
+ #
4649
+ # resp = client.list_scripts({
4650
+ # limit: 1,
4651
+ # next_token: "NonEmptyString",
4652
+ # })
4653
+ #
4654
+ # @example Response structure
4655
+ #
4656
+ # resp.scripts #=> Array
4657
+ # resp.scripts[0].script_id #=> String
4658
+ # resp.scripts[0].name #=> String
4659
+ # resp.scripts[0].version #=> String
4660
+ # resp.scripts[0].size_on_disk #=> Integer
4661
+ # resp.scripts[0].creation_time #=> Time
4662
+ # resp.scripts[0].storage_location.bucket #=> String
4663
+ # resp.scripts[0].storage_location.key #=> String
4664
+ # resp.scripts[0].storage_location.role_arn #=> String
4665
+ # resp.scripts[0].storage_location.object_version #=> String
4666
+ # resp.next_token #=> String
4667
+ #
4668
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListScripts AWS API Documentation
4669
+ #
4670
+ # @overload list_scripts(params = {})
4671
+ # @param [Hash] params ({})
4672
+ def list_scripts(params = {}, options = {})
4673
+ req = build_request(:list_scripts, params)
4674
+ req.send_request(options)
4675
+ end
4676
+
4312
4677
  # Creates or updates a scaling policy for a fleet. Scaling policies are
4313
4678
  # used to automatically scale a fleet's hosting capacity to meet player
4314
4679
  # demand. An active scaling policy instructs Amazon GameLift to track a
@@ -4596,6 +4961,7 @@ module Aws::GameLift
4596
4961
  # resp.storage_location.bucket #=> String
4597
4962
  # resp.storage_location.key #=> String
4598
4963
  # resp.storage_location.role_arn #=> String
4964
+ # resp.storage_location.object_version #=> String
4599
4965
  #
4600
4966
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/RequestUploadCredentials AWS API Documentation
4601
4967
  #
@@ -5715,8 +6081,8 @@ module Aws::GameLift
5715
6081
  # need to be unique.
5716
6082
  #
5717
6083
  # @option params [String] :version
5718
- # Version that is associated with this build. Version strings do not
5719
- # need to be unique.
6084
+ # Version that is associated with a build or script. Version strings do
6085
+ # not need to be unique.
5720
6086
  #
5721
6087
  # @return [Types::UpdateBuildOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5722
6088
  #
@@ -6415,18 +6781,16 @@ module Aws::GameLift
6415
6781
  # to be in an `ACTIVE` status.
6416
6782
  #
6417
6783
  # To update run-time configuration, specify the fleet ID and provide a
6418
- # `RuntimeConfiguration` object with the updated collection of server
6419
- # process configurations.
6784
+ # `RuntimeConfiguration` object with an updated set of server process
6785
+ # configurations.
6420
6786
  #
6421
6787
  # Each instance in a Amazon GameLift fleet checks regularly for an
6422
6788
  # updated run-time configuration and changes how it launches server
6423
6789
  # processes to comply with the latest version. Existing server processes
6424
- # are not affected by the update; they continue to run until they end,
6425
- # while Amazon GameLift simply adds new server processes to fit the
6426
- # current run-time configuration. As a result, the run-time
6427
- # configuration changes are applied gradually as existing processes shut
6428
- # down and new processes are launched in Amazon GameLift's normal
6429
- # process recycling activity.
6790
+ # are not affected by the update; run-time configuration changes are
6791
+ # applied gradually as existing processes shut down and new processes
6792
+ # are launched during Amazon GameLift's normal process recycling
6793
+ # activity.
6430
6794
  #
6431
6795
  # **Learn more**
6432
6796
  #
@@ -6481,12 +6845,13 @@ module Aws::GameLift
6481
6845
  #
6482
6846
  # @option params [required, Types::RuntimeConfiguration] :runtime_configuration
6483
6847
  # Instructions for launching server processes on each instance in the
6484
- # fleet. The run-time configuration for a fleet has a collection of
6485
- # server process configurations, one for each type of server process to
6486
- # run on an instance. A server process configuration specifies the
6487
- # location of the server executable, launch parameters, and the number
6488
- # of concurrent processes with that configuration to maintain on each
6489
- # instance.
6848
+ # fleet. Server processes run either a custom game build executable or a
6849
+ # Realtime Servers script. The run-time configuration lists the types of
6850
+ # server processes to run on an instance and includes the following
6851
+ # configuration settings: the server executable or launch script file,
6852
+ # launch parameters, and the number of processes to run concurrently on
6853
+ # each instance. A CreateFleet request must include a run-time
6854
+ # configuration with at least one server process configuration.
6490
6855
  #
6491
6856
  # @return [Types::UpdateRuntimeConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6492
6857
  #
@@ -6527,6 +6892,112 @@ module Aws::GameLift
6527
6892
  req.send_request(options)
6528
6893
  end
6529
6894
 
6895
+ # Updates Realtime script metadata and content.
6896
+ #
6897
+ # To update script metadata, specify the script ID and provide updated
6898
+ # name and/or version values.
6899
+ #
6900
+ # To update script content, provide an updated zip file by pointing to
6901
+ # either a local file or an Amazon S3 bucket location. You can use
6902
+ # either method regardless of how the original script was uploaded. Use
6903
+ # the *Version* parameter to track updates to the script.
6904
+ #
6905
+ # If the call is successful, the updated metadata is stored in the
6906
+ # script record and a revised script is uploaded to the Amazon GameLift
6907
+ # service. Once the script is updated and acquired by a fleet instance,
6908
+ # the new version is used for all new game sessions.
6909
+ #
6910
+ # **Learn more**
6911
+ #
6912
+ # [Amazon GameLift Realtime Servers][1]
6913
+ #
6914
+ # **Related operations**
6915
+ #
6916
+ # * CreateScript
6917
+ #
6918
+ # * ListScripts
6919
+ #
6920
+ # * DescribeScript
6921
+ #
6922
+ # * UpdateScript
6923
+ #
6924
+ # * DeleteScript
6925
+ #
6926
+ #
6927
+ #
6928
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/realtime-intro.html
6929
+ #
6930
+ # @option params [required, String] :script_id
6931
+ # Unique identifier for a Realtime script to update.
6932
+ #
6933
+ # @option params [String] :name
6934
+ # Descriptive label that is associated with a script. Script names do
6935
+ # not need to be unique.
6936
+ #
6937
+ # @option params [String] :version
6938
+ # Version that is associated with a build or script. Version strings do
6939
+ # not need to be unique.
6940
+ #
6941
+ # @option params [Types::S3Location] :storage_location
6942
+ # Location of the Amazon S3 bucket where a zipped file containing your
6943
+ # Realtime scripts is stored. The storage location must specify the
6944
+ # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
6945
+ # that allows Amazon GameLift to access the Amazon S3 storage location.
6946
+ # The S3 bucket must be in the same region where you want to create a
6947
+ # new script. By default, Amazon GameLift uploads the latest version of
6948
+ # the zip file; if you have S3 object versioning turned on, you can use
6949
+ # the `ObjectVersion` parameter to specify an earlier version.
6950
+ #
6951
+ # @option params [String, IO] :zip_file
6952
+ # Data object containing your Realtime scripts and dependencies as a zip
6953
+ # file. The zip file can have one or multiple files. Maximum size of a
6954
+ # zip file is 5 MB.
6955
+ #
6956
+ # When using the AWS CLI tool to create a script, this parameter is set
6957
+ # to the zip file name. It must be prepended with the string
6958
+ # "fileb://" to indicate that the file data is a binary object. For
6959
+ # example: `--zip-file fileb://myRealtimeScript.zip`.
6960
+ #
6961
+ # @return [Types::UpdateScriptOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6962
+ #
6963
+ # * {Types::UpdateScriptOutput#script #script} => Types::Script
6964
+ #
6965
+ # @example Request syntax with placeholder values
6966
+ #
6967
+ # resp = client.update_script({
6968
+ # script_id: "ScriptId", # required
6969
+ # name: "NonZeroAndMaxString",
6970
+ # version: "NonZeroAndMaxString",
6971
+ # storage_location: {
6972
+ # bucket: "NonEmptyString",
6973
+ # key: "NonEmptyString",
6974
+ # role_arn: "NonEmptyString",
6975
+ # object_version: "NonEmptyString",
6976
+ # },
6977
+ # zip_file: "data",
6978
+ # })
6979
+ #
6980
+ # @example Response structure
6981
+ #
6982
+ # resp.script.script_id #=> String
6983
+ # resp.script.name #=> String
6984
+ # resp.script.version #=> String
6985
+ # resp.script.size_on_disk #=> Integer
6986
+ # resp.script.creation_time #=> Time
6987
+ # resp.script.storage_location.bucket #=> String
6988
+ # resp.script.storage_location.key #=> String
6989
+ # resp.script.storage_location.role_arn #=> String
6990
+ # resp.script.storage_location.object_version #=> String
6991
+ #
6992
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateScript AWS API Documentation
6993
+ #
6994
+ # @overload update_script(params = {})
6995
+ # @param [Hash] params ({})
6996
+ def update_script(params = {}, options = {})
6997
+ req = build_request(:update_script, params)
6998
+ req.send_request(options)
6999
+ end
7000
+
6530
7001
  # Validates the syntax of a matchmaking rule or rule set. This operation
6531
7002
  # checks that the rule set is using syntactically correct JSON and that
6532
7003
  # it conforms to allowed property expressions. To validate syntax,
@@ -6600,7 +7071,7 @@ module Aws::GameLift
6600
7071
  params: params,
6601
7072
  config: config)
6602
7073
  context[:gem_name] = 'aws-sdk-gamelift'
6603
- context[:gem_version] = '1.15.0'
7074
+ context[:gem_version] = '1.16.0'
6604
7075
  Seahorse::Client::Request.new(handlers, context)
6605
7076
  end
6606
7077