aws-sdk-gamelift 1.15.0 → 1.16.0

Sign up to get free protection for your applications and to get access to all the features.
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