aws-sdk-gamelift 1.38.0 → 1.39.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
  SHA256:
3
- metadata.gz: f184391dc32a2c390a0c23e476ec57911cf1cdab0f8035b622681f32f20e93af
4
- data.tar.gz: 3e3970fc31b3427fa723e75bbdc0f22840a049baa0edfdbf41c0bcde7610eca0
3
+ metadata.gz: 92ea3af47c9c89e9444ee8c8661ed9d6697775cb75025ea78072af8ae847667c
4
+ data.tar.gz: 1a21bf1df2cd7b15bbeda40a75ba6670d13a7de398a14ed624307a196001f972
5
5
  SHA512:
6
- metadata.gz: 19b607c6799b18e4bd4573120b27b9da6ad453afc0bdc4a20bb2a7aa0cf8d2a841eff6cb8b2eedeac79e30be84d27105eb840c05a5602faab1cd8069e0e4930d
7
- data.tar.gz: 0a0feba974e6e4ef024f890e66edef9f802f2e9eeadaa733b71223cdc26a89f33c7e094a952230df97793503f4fc8cba2714d2077b69c7ee8ccb80f0cd6e5c9d
6
+ metadata.gz: 8488cab39d5416ecf0be08b4deaa838aaabbb8296b6faa2af7fb2ae527a294547dbe8a876ac883f4113c7f56d9836581fde72033198bdca34f25389e4c609e04
7
+ data.tar.gz: dac1500477200020733ce8adcd036e070e2a1df187fba9b99132d684c5667374be091c39a4618e2752fc7ad3247cd2dbc413c3cbe2d6547b29015425cf9549a4
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-gamelift/customizations'
48
48
  # @!group service
49
49
  module Aws::GameLift
50
50
 
51
- GEM_VERSION = '1.38.0'
51
+ GEM_VERSION = '1.39.0'
52
52
 
53
53
  end
@@ -383,8 +383,8 @@ module Aws::GameLift
383
383
  #
384
384
  #
385
385
  #
386
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
387
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-events.html
386
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-client.html
387
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html
388
388
  #
389
389
  # @option params [required, String] :ticket_id
390
390
  # A unique identifier for a matchmaking ticket. The ticket must be in
@@ -697,12 +697,19 @@ module Aws::GameLift
697
697
  # this value later.
698
698
  #
699
699
  # @option params [Types::S3Location] :storage_location
700
- # Information indicating where your game build files are stored. Use
701
- # this parameter only when creating a build with files stored in an S3
702
- # bucket that you own. The storage location must specify an S3 bucket
703
- # name and key. The location must also specify a role ARN that you set
704
- # up to allow Amazon GameLift to access your S3 bucket. The S3 bucket
705
- # and your new build must be in the same Region.
700
+ # The location where your game build files are stored. Use this
701
+ # parameter only when creating a build using files that are stored in an
702
+ # S3 bucket that you own. Identify an S3 bucket name and key, which must
703
+ # in the same Region where you're creating a build. This parameter must
704
+ # also specify the ARN for an IAM role that you've set up to give
705
+ # Amazon GameLift access your S3 bucket. To call this operation with a
706
+ # storage location, you must have IAM PassRole permission. For more
707
+ # details on IAM roles and PassRole permissions, see [ Set up a role for
708
+ # GameLift access][1].
709
+ #
710
+ #
711
+ #
712
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
706
713
  #
707
714
  # @option params [String] :operating_system
708
715
  # The operating system that the game server binaries are built to run
@@ -974,17 +981,17 @@ module Aws::GameLift
974
981
  #
975
982
  # @option params [String] :instance_role_arn
976
983
  # A unique identifier for an AWS IAM role that manages access to your
977
- # AWS services. With an instance role ARN set, any application that runs
978
- # on an instance in this fleet can assume the role, including install
979
- # scripts, server processes, and daemons (background processes). Create
980
- # a role or look up a role's ARN from the [IAM dashboard][1] in the AWS
981
- # Management Console. Learn more about using on-box credentials for your
982
- # game servers at [ Access external resources from a game server][2].
984
+ # AWS services. Fleets with an instance role ARN allow applications that
985
+ # are running on the fleet's instances to assume the role. Learn more
986
+ # about using on-box credentials for your game servers at [ Access
987
+ # external resources from a game server][1]. To call this operation with
988
+ # instance role ARN, you must have IAM PassRole permissions. See [IAM
989
+ # policy examples for GameLift][2].
983
990
  #
984
991
  #
985
992
  #
986
- # [1]: https://console.aws.amazon.com/iam/
987
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
993
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
994
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-iam-policy-examples.html
988
995
  #
989
996
  # @option params [Types::CertificateConfiguration] :certificate_configuration
990
997
  # Indicates whether to generate a TLS/SSL certificate for the new fleet.
@@ -1039,7 +1046,7 @@ module Aws::GameLift
1039
1046
  # server_launch_path: "NonZeroAndMaxString",
1040
1047
  # server_launch_parameters: "NonZeroAndMaxString",
1041
1048
  # log_paths: ["NonZeroAndMaxString"],
1042
- # ec2_instance_type: "t2.micro", # required, accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge
1049
+ # ec2_instance_type: "t2.micro", # required, accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, c5a.large, c5a.xlarge, c5a.2xlarge, c5a.4xlarge, c5a.8xlarge, c5a.12xlarge, c5a.16xlarge, c5a.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.8xlarge, r5a.12xlarge, r5a.16xlarge, r5a.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge, m5a.large, m5a.xlarge, m5a.2xlarge, m5a.4xlarge, m5a.8xlarge, m5a.12xlarge, m5a.16xlarge, m5a.24xlarge
1043
1050
  # ec2_inbound_permissions: [
1044
1051
  # {
1045
1052
  # from_port: 1, # required
@@ -1085,7 +1092,7 @@ module Aws::GameLift
1085
1092
  # resp.fleet_attributes.fleet_id #=> String
1086
1093
  # resp.fleet_attributes.fleet_arn #=> String
1087
1094
  # resp.fleet_attributes.fleet_type #=> String, one of "ON_DEMAND", "SPOT"
1088
- # resp.fleet_attributes.instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge"
1095
+ # resp.fleet_attributes.instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"
1089
1096
  # resp.fleet_attributes.description #=> String
1090
1097
  # resp.fleet_attributes.name #=> String
1091
1098
  # resp.fleet_attributes.creation_time #=> Time
@@ -1293,7 +1300,7 @@ module Aws::GameLift
1293
1300
  # VPCs that you've set up. This property cannot be updated after the
1294
1301
  # game server group is created, and the corresponding Auto Scaling group
1295
1302
  # will always use the property value that is set with this request, even
1296
- # if the Auto Scaling group is updated directly
1303
+ # if the Auto Scaling group is updated directly.
1297
1304
  #
1298
1305
  # @option params [Array<Types::Tag>] :tags
1299
1306
  # A list of labels to assign to the new game server group resource. Tags
@@ -1693,31 +1700,38 @@ module Aws::GameLift
1693
1700
  req.send_request(options)
1694
1701
  end
1695
1702
 
1696
- # Defines a new matchmaking configuration for use with FlexMatch. A
1697
- # matchmaking configuration sets out guidelines for matching players and
1698
- # getting the matches into games. You can set up multiple matchmaking
1699
- # configurations to handle the scenarios needed for your game. Each
1700
- # matchmaking ticket (StartMatchmaking or StartMatchBackfill) specifies
1701
- # a configuration for the match and provides player attributes to
1702
- # support the configuration being used.
1703
- #
1704
- # To create a matchmaking configuration, at a minimum you must specify
1705
- # the following: configuration name; a rule set that governs how to
1706
- # evaluate players and find acceptable matches; a game session queue to
1707
- # use when placing a new game session for the match; and the maximum
1708
- # time allowed for a matchmaking attempt.
1709
- #
1710
- # To track the progress of matchmaking tickets, set up an Amazon Simple
1711
- # Notification Service (SNS) to receive notifications, and provide the
1712
- # topic ARN in the matchmaking configuration. An alternative method,
1713
- # continuously poling ticket status with DescribeMatchmaking, should
1714
- # only be used for games in development with low matchmaking usage.
1703
+ # Defines a new matchmaking configuration for use with FlexMatch.
1704
+ # Whether your are using FlexMatch with GameLift hosting or as a
1705
+ # standalone matchmaking service, the matchmaking configuration sets out
1706
+ # rules for matching players and forming teams. If you're also using
1707
+ # GameLift hosting, it defines how to start game sessions for each
1708
+ # match. Your matchmaking system can use multiple configurations to
1709
+ # handle different game scenarios. All matchmaking requests
1710
+ # (StartMatchmaking or StartMatchBackfill) identify the matchmaking
1711
+ # configuration to use and provide player attributes consistent with
1712
+ # that configuration.
1713
+ #
1714
+ # To create a matchmaking configuration, you must provide the following:
1715
+ # configuration name and FlexMatch mode (with or without GameLift
1716
+ # hosting); a rule set that specifies how to evaluate players and find
1717
+ # acceptable matches; whether player acceptance is required; and the
1718
+ # maximum time allowed for a matchmaking attempt. When using FlexMatch
1719
+ # with GameLift hosting, you also need to identify the game session
1720
+ # queue to use when starting a game session for the match.
1721
+ #
1722
+ # In addition, you must set up an Amazon Simple Notification Service
1723
+ # (SNS) to receive matchmaking notifications, and provide the topic ARN
1724
+ # in the matchmaking configuration. An alternative method, continuously
1725
+ # polling ticket status with DescribeMatchmaking, is only suitable for
1726
+ # games in development with low matchmaking usage.
1715
1727
  #
1716
1728
  # **Learn more**
1717
1729
  #
1718
- # [ Design a FlexMatch Matchmaker][1]
1730
+ # [ FlexMatch Developer Guide][1]
1719
1731
  #
1720
- # [ Set Up FlexMatch Event Notification][2]
1732
+ # [ Design a FlexMatch Matchmaker][2]
1733
+ #
1734
+ # [ Set Up FlexMatch Event Notification][3]
1721
1735
  #
1722
1736
  # **Related operations**
1723
1737
  #
@@ -1739,8 +1753,9 @@ module Aws::GameLift
1739
1753
  #
1740
1754
  #
1741
1755
  #
1742
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-configuration.html
1743
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
1756
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/gamelift-match.html
1757
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-configuration.html
1758
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
1744
1759
  #
1745
1760
  # @option params [required, String] :name
1746
1761
  # A unique identifier for a matchmaking configuration. This name is used
@@ -1750,12 +1765,13 @@ module Aws::GameLift
1750
1765
  # @option params [String] :description
1751
1766
  # A human-readable description of the matchmaking configuration.
1752
1767
  #
1753
- # @option params [required, Array<String>] :game_session_queue_arns
1768
+ # @option params [Array<String>] :game_session_queue_arns
1754
1769
  # Amazon Resource Name ([ARN][1]) that is assigned to a GameLift game
1755
1770
  # session queue resource and uniquely identifies it. ARNs are unique
1756
- # across all Regions. These queues are used when placing game sessions
1757
- # for matches that are created with this matchmaking configuration.
1758
- # Queues can be located in any Region.
1771
+ # across all Regions. Queues can be located in any Region. Queues are
1772
+ # used to start new GameLift-hosted game sessions for matches that are
1773
+ # created with this matchmaking configuration. If `FlexMatchMode` is set
1774
+ # to `STANDALONE`, do not set this parameter.
1759
1775
  #
1760
1776
  #
1761
1777
  #
@@ -1768,14 +1784,17 @@ module Aws::GameLift
1768
1784
  #
1769
1785
  # @option params [Integer] :acceptance_timeout_seconds
1770
1786
  # The length of time (in seconds) to wait for players to accept a
1771
- # proposed match. If any player rejects the match or fails to accept
1772
- # before the timeout, the ticket continues to look for an acceptable
1787
+ # proposed match, if acceptance is required. If any player rejects the
1788
+ # match or fails to accept before the timeout, the tickets are returned
1789
+ # to the ticket pool and continue to be evaluated for an acceptable
1773
1790
  # match.
1774
1791
  #
1775
1792
  # @option params [required, Boolean] :acceptance_required
1776
1793
  # A flag that determines whether a match that was created with this
1777
1794
  # configuration must be accepted by the matched players. To require
1778
- # acceptance, set to `TRUE`.
1795
+ # acceptance, set to `TRUE`. With this option enabled, matchmaking
1796
+ # tickets use the status `REQUIRES_ACCEPTANCE` to indicate when a
1797
+ # completed potential match is waiting for player acceptance.
1779
1798
  #
1780
1799
  # @option params [required, String] :rule_set_name
1781
1800
  # A unique identifier for a matchmaking rule set to use with this
@@ -1790,7 +1809,8 @@ module Aws::GameLift
1790
1809
  # The number of player slots in a match to keep open for future players.
1791
1810
  # For example, assume that the configuration's rule set specifies a
1792
1811
  # match for a single 12-person team. If the additional player count is
1793
- # set to 2, only 10 players are initially selected for the match.
1812
+ # set to 2, only 10 players are initially selected for the match. This
1813
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
1794
1814
  #
1795
1815
  # @option params [String] :custom_event_data
1796
1816
  # Information to be added to all events related to this matchmaking
@@ -1801,7 +1821,8 @@ module Aws::GameLift
1801
1821
  # pairs. These properties are passed to a game server process in the
1802
1822
  # GameSession object with a request to start a new game session (see
1803
1823
  # [Start a Game Session][1]). This information is added to the new
1804
- # GameSession object that is created for a successful match.
1824
+ # GameSession object that is created for a successful match. This
1825
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
1805
1826
  #
1806
1827
  #
1807
1828
  #
@@ -1812,7 +1833,8 @@ module Aws::GameLift
1812
1833
  # value. This data is passed to a game server process in the GameSession
1813
1834
  # object with a request to start a new game session (see [Start a Game
1814
1835
  # Session][1]). This information is added to the new GameSession object
1815
- # that is created for a successful match.
1836
+ # that is created for a successful match. This parameter is not used if
1837
+ # `FlexMatchMode` is set to `STANDALONE`.
1816
1838
  #
1817
1839
  #
1818
1840
  #
@@ -1825,11 +1847,27 @@ module Aws::GameLift
1825
1847
  # Specify `AUTOMATIC` to have GameLift create a StartMatchBackfill
1826
1848
  # request whenever a game session has one or more open slots. Learn more
1827
1849
  # about manual and automatic backfill in [ Backfill Existing Games with
1828
- # FlexMatch][1].
1850
+ # FlexMatch][1]. Automatic backfill is not available when
1851
+ # `FlexMatchMode` is set to `STANDALONE`.
1852
+ #
1853
+ #
1854
+ #
1855
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
1856
+ #
1857
+ # @option params [String] :flex_match_mode
1858
+ # Indicates whether this matchmaking configuration is being used with
1859
+ # GameLift hosting or as a standalone matchmaking solution.
1860
+ #
1861
+ # * **STANDALONE** - FlexMatch forms matches and returns match
1862
+ # information, including players and team assignments, in a [
1863
+ # MatchmakingSucceeded][1] event.
1864
+ #
1865
+ # * **WITH\_QUEUE** - FlexMatch forms matches and uses the specified
1866
+ # GameLift queue to start a game session for the match.
1829
1867
  #
1830
1868
  #
1831
1869
  #
1832
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
1870
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded
1833
1871
  #
1834
1872
  # @option params [Array<Types::Tag>] :tags
1835
1873
  # A list of labels to assign to the new matchmaking configuration
@@ -1854,7 +1892,7 @@ module Aws::GameLift
1854
1892
  # resp = client.create_matchmaking_configuration({
1855
1893
  # name: "MatchmakingIdStringModel", # required
1856
1894
  # description: "NonZeroAndMaxString",
1857
- # game_session_queue_arns: ["ArnStringModel"], # required
1895
+ # game_session_queue_arns: ["ArnStringModel"],
1858
1896
  # request_timeout_seconds: 1, # required
1859
1897
  # acceptance_timeout_seconds: 1,
1860
1898
  # acceptance_required: false, # required
@@ -1870,6 +1908,7 @@ module Aws::GameLift
1870
1908
  # ],
1871
1909
  # game_session_data: "GameSessionData",
1872
1910
  # backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
1911
+ # flex_match_mode: "STANDALONE", # accepts STANDALONE, WITH_QUEUE
1873
1912
  # tags: [
1874
1913
  # {
1875
1914
  # key: "TagKey", # required
@@ -1899,6 +1938,7 @@ module Aws::GameLift
1899
1938
  # resp.configuration.game_properties[0].value #=> String
1900
1939
  # resp.configuration.game_session_data #=> String
1901
1940
  # resp.configuration.backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
1941
+ # resp.configuration.flex_match_mode #=> String, one of "STANDALONE", "WITH_QUEUE"
1902
1942
  #
1903
1943
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateMatchmakingConfiguration AWS API Documentation
1904
1944
  #
@@ -1951,9 +1991,9 @@ module Aws::GameLift
1951
1991
  #
1952
1992
  #
1953
1993
  #
1954
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-rulesets.html
1955
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-configuration.html
1956
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-intro.html
1994
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-rulesets.html
1995
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-configuration.html
1996
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-intro.html
1957
1997
  #
1958
1998
  # @option params [required, String] :name
1959
1999
  # A unique identifier for a matchmaking rule set. A matchmaking
@@ -2230,14 +2270,20 @@ module Aws::GameLift
2230
2270
  # value later.
2231
2271
  #
2232
2272
  # @option params [Types::S3Location] :storage_location
2233
- # The location of the Amazon S3 bucket where a zipped file containing
2234
- # your Realtime scripts is stored. The storage location must specify the
2235
- # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
2236
- # that allows Amazon GameLift to access the Amazon S3 storage location.
2237
- # The S3 bucket must be in the same Region where you want to create a
2238
- # new script. By default, Amazon GameLift uploads the latest version of
2239
- # the zip file; if you have S3 object versioning turned on, you can use
2240
- # the `ObjectVersion` parameter to specify an earlier version.
2273
+ # The Amazon S3 location of your Realtime scripts. The storage location
2274
+ # must specify the S3 bucket name, the zip file name (the "key"), and
2275
+ # an IAM role ARN that allows Amazon GameLift to access the S3 storage
2276
+ # location. The S3 bucket must be in the same Region where you are
2277
+ # creating a new script. By default, Amazon GameLift uploads the latest
2278
+ # version of the zip file; if you have S3 object versioning turned on,
2279
+ # you can use the `ObjectVersion` parameter to specify an earlier
2280
+ # version. To call this operation with a storage location, you must have
2281
+ # IAM PassRole permission. For more details on IAM roles and PassRole
2282
+ # permissions, see [ Set up a role for GameLift access][1].
2283
+ #
2284
+ #
2285
+ #
2286
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
2241
2287
  #
2242
2288
  # @option params [String, StringIO, File] :zip_file
2243
2289
  # A data object containing your Realtime scripts and dependencies as a
@@ -2690,8 +2736,8 @@ module Aws::GameLift
2690
2736
  # @option params [String] :delete_option
2691
2737
  # The type of delete to perform. Options include the following:
2692
2738
  #
2693
- # * `SAFE_DELETE` – Terminates the game server group and EC2 Auto
2694
- # Scaling group only when it has no game servers that are in
2739
+ # * `SAFE_DELETE` – (default) Terminates the game server group and EC2
2740
+ # Auto Scaling group only when it has no game servers that are in
2695
2741
  # `UTILIZED` status.
2696
2742
  #
2697
2743
  # * `FORCE_DELETE` – Terminates the game server group, including all
@@ -2856,7 +2902,7 @@ module Aws::GameLift
2856
2902
  #
2857
2903
  #
2858
2904
  #
2859
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-rulesets.html
2905
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-rulesets.html
2860
2906
  #
2861
2907
  # @option params [required, String] :name
2862
2908
  # A unique identifier for a matchmaking rule set to be deleted. (Note:
@@ -3311,13 +3357,13 @@ module Aws::GameLift
3311
3357
  # @example Request syntax with placeholder values
3312
3358
  #
3313
3359
  # resp = client.describe_ec2_instance_limits({
3314
- # ec2_instance_type: "t2.micro", # accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge
3360
+ # ec2_instance_type: "t2.micro", # accepts t2.micro, t2.small, t2.medium, t2.large, c3.large, c3.xlarge, c3.2xlarge, c3.4xlarge, c3.8xlarge, c4.large, c4.xlarge, c4.2xlarge, c4.4xlarge, c4.8xlarge, c5.large, c5.xlarge, c5.2xlarge, c5.4xlarge, c5.9xlarge, c5.12xlarge, c5.18xlarge, c5.24xlarge, c5a.large, c5a.xlarge, c5a.2xlarge, c5a.4xlarge, c5a.8xlarge, c5a.12xlarge, c5a.16xlarge, c5a.24xlarge, r3.large, r3.xlarge, r3.2xlarge, r3.4xlarge, r3.8xlarge, r4.large, r4.xlarge, r4.2xlarge, r4.4xlarge, r4.8xlarge, r4.16xlarge, r5.large, r5.xlarge, r5.2xlarge, r5.4xlarge, r5.8xlarge, r5.12xlarge, r5.16xlarge, r5.24xlarge, r5a.large, r5a.xlarge, r5a.2xlarge, r5a.4xlarge, r5a.8xlarge, r5a.12xlarge, r5a.16xlarge, r5a.24xlarge, m3.medium, m3.large, m3.xlarge, m3.2xlarge, m4.large, m4.xlarge, m4.2xlarge, m4.4xlarge, m4.10xlarge, m5.large, m5.xlarge, m5.2xlarge, m5.4xlarge, m5.8xlarge, m5.12xlarge, m5.16xlarge, m5.24xlarge, m5a.large, m5a.xlarge, m5a.2xlarge, m5a.4xlarge, m5a.8xlarge, m5a.12xlarge, m5a.16xlarge, m5a.24xlarge
3315
3361
  # })
3316
3362
  #
3317
3363
  # @example Response structure
3318
3364
  #
3319
3365
  # resp.ec2_instance_limits #=> Array
3320
- # resp.ec2_instance_limits[0].ec2_instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge"
3366
+ # resp.ec2_instance_limits[0].ec2_instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"
3321
3367
  # resp.ec2_instance_limits[0].current_instances #=> Integer
3322
3368
  # resp.ec2_instance_limits[0].instance_limit #=> Integer
3323
3369
  #
@@ -3423,7 +3469,7 @@ module Aws::GameLift
3423
3469
  # resp.fleet_attributes[0].fleet_id #=> String
3424
3470
  # resp.fleet_attributes[0].fleet_arn #=> String
3425
3471
  # resp.fleet_attributes[0].fleet_type #=> String, one of "ON_DEMAND", "SPOT"
3426
- # resp.fleet_attributes[0].instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge"
3472
+ # resp.fleet_attributes[0].instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"
3427
3473
  # resp.fleet_attributes[0].description #=> String
3428
3474
  # resp.fleet_attributes[0].name #=> String
3429
3475
  # resp.fleet_attributes[0].creation_time #=> Time
@@ -3552,7 +3598,7 @@ module Aws::GameLift
3552
3598
  #
3553
3599
  # resp.fleet_capacity #=> Array
3554
3600
  # resp.fleet_capacity[0].fleet_id #=> String
3555
- # resp.fleet_capacity[0].instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge"
3601
+ # resp.fleet_capacity[0].instance_type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"
3556
3602
  # resp.fleet_capacity[0].instance_counts.desired #=> Integer
3557
3603
  # resp.fleet_capacity[0].instance_counts.minimum #=> Integer
3558
3604
  # resp.fleet_capacity[0].instance_counts.maximum #=> Integer
@@ -4558,7 +4604,7 @@ module Aws::GameLift
4558
4604
  # resp.instances[0].ip_address #=> String
4559
4605
  # resp.instances[0].dns_name #=> String
4560
4606
  # resp.instances[0].operating_system #=> String, one of "WINDOWS_2012", "AMAZON_LINUX", "AMAZON_LINUX_2"
4561
- # resp.instances[0].type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge"
4607
+ # resp.instances[0].type #=> String, one of "t2.micro", "t2.small", "t2.medium", "t2.large", "c3.large", "c3.xlarge", "c3.2xlarge", "c3.4xlarge", "c3.8xlarge", "c4.large", "c4.xlarge", "c4.2xlarge", "c4.4xlarge", "c4.8xlarge", "c5.large", "c5.xlarge", "c5.2xlarge", "c5.4xlarge", "c5.9xlarge", "c5.12xlarge", "c5.18xlarge", "c5.24xlarge", "c5a.large", "c5a.xlarge", "c5a.2xlarge", "c5a.4xlarge", "c5a.8xlarge", "c5a.12xlarge", "c5a.16xlarge", "c5a.24xlarge", "r3.large", "r3.xlarge", "r3.2xlarge", "r3.4xlarge", "r3.8xlarge", "r4.large", "r4.xlarge", "r4.2xlarge", "r4.4xlarge", "r4.8xlarge", "r4.16xlarge", "r5.large", "r5.xlarge", "r5.2xlarge", "r5.4xlarge", "r5.8xlarge", "r5.12xlarge", "r5.16xlarge", "r5.24xlarge", "r5a.large", "r5a.xlarge", "r5a.2xlarge", "r5a.4xlarge", "r5a.8xlarge", "r5a.12xlarge", "r5a.16xlarge", "r5a.24xlarge", "m3.medium", "m3.large", "m3.xlarge", "m3.2xlarge", "m4.large", "m4.xlarge", "m4.2xlarge", "m4.4xlarge", "m4.10xlarge", "m5.large", "m5.xlarge", "m5.2xlarge", "m5.4xlarge", "m5.8xlarge", "m5.12xlarge", "m5.16xlarge", "m5.24xlarge", "m5a.large", "m5a.xlarge", "m5a.2xlarge", "m5a.4xlarge", "m5a.8xlarge", "m5a.12xlarge", "m5a.16xlarge", "m5a.24xlarge"
4562
4608
  # resp.instances[0].status #=> String, one of "PENDING", "ACTIVE", "TERMINATING"
4563
4609
  # resp.instances[0].creation_time #=> Time
4564
4610
  # resp.next_token #=> String
@@ -4611,8 +4657,8 @@ module Aws::GameLift
4611
4657
  #
4612
4658
  #
4613
4659
  #
4614
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
4615
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
4660
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-client.html
4661
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
4616
4662
  #
4617
4663
  # @option params [required, Array<String>] :ticket_ids
4618
4664
  # A unique identifier for a matchmaking ticket. You can include up to 10
@@ -4701,7 +4747,7 @@ module Aws::GameLift
4701
4747
  #
4702
4748
  #
4703
4749
  #
4704
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/matchmaker-build.html
4750
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/matchmaker-build.html
4705
4751
  #
4706
4752
  # @option params [Array<String>] :names
4707
4753
  # A unique identifier for a matchmaking configuration(s) to retrieve.
@@ -4762,6 +4808,7 @@ module Aws::GameLift
4762
4808
  # resp.configurations[0].game_properties[0].value #=> String
4763
4809
  # resp.configurations[0].game_session_data #=> String
4764
4810
  # resp.configurations[0].backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
4811
+ # resp.configurations[0].flex_match_mode #=> String, one of "STANDALONE", "WITH_QUEUE"
4765
4812
  # resp.next_token #=> String
4766
4813
  #
4767
4814
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeMatchmakingConfigurations AWS API Documentation
@@ -4805,7 +4852,7 @@ module Aws::GameLift
4805
4852
  #
4806
4853
  #
4807
4854
  #
4808
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-rulesets.html
4855
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-rulesets.html
4809
4856
  #
4810
4857
  # @option params [Array<String>] :names
4811
4858
  # A list of one or more matchmaking rule set names to retrieve details
@@ -7079,8 +7126,8 @@ module Aws::GameLift
7079
7126
  #
7080
7127
  #
7081
7128
  #
7082
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-match.html
7083
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
7129
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/gamelift-match.html
7130
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
7084
7131
  #
7085
7132
  # @option params [String] :ticket_id
7086
7133
  # A unique identifier for a matchmaking ticket. If no ticket ID is
@@ -7094,7 +7141,7 @@ module Aws::GameLift
7094
7141
  # used with the original game session is listed in the GameSession
7095
7142
  # object, `MatchmakerData` property.
7096
7143
  #
7097
- # @option params [required, String] :game_session_arn
7144
+ # @option params [String] :game_session_arn
7098
7145
  # Amazon Resource Name ([ARN][1]) that is assigned to a game session and
7099
7146
  # uniquely identifies it. This is the same as the game session ID.
7100
7147
  #
@@ -7119,7 +7166,7 @@ module Aws::GameLift
7119
7166
  #
7120
7167
  #
7121
7168
  #
7122
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-server.html#match-server-data
7169
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data
7123
7170
  #
7124
7171
  # @return [Types::StartMatchBackfillOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7125
7172
  #
@@ -7130,7 +7177,7 @@ module Aws::GameLift
7130
7177
  # resp = client.start_match_backfill({
7131
7178
  # ticket_id: "MatchmakingIdStringModel",
7132
7179
  # configuration_name: "MatchmakingConfigurationName", # required
7133
- # game_session_arn: "ArnStringModel", # required
7180
+ # game_session_arn: "ArnStringModel",
7134
7181
  # players: [ # required
7135
7182
  # {
7136
7183
  # player_id: "NonZeroAndMaxString",
@@ -7181,58 +7228,27 @@ module Aws::GameLift
7181
7228
  end
7182
7229
 
7183
7230
  # Uses FlexMatch to create a game match for a group of players based on
7184
- # custom matchmaking rules, and starts a new game for the matched
7185
- # players. Each matchmaking request specifies the type of match to build
7186
- # (team configuration, rules for an acceptable match, etc.). The request
7187
- # also specifies the players to find a match for and where to host the
7188
- # new game session for optimal performance. A matchmaking request might
7189
- # start with a single player or a group of players who want to play
7190
- # together. FlexMatch finds additional players as needed to fill the
7191
- # match. Match type, rules, and the queue used to place a new game
7192
- # session are defined in a `MatchmakingConfiguration`.
7231
+ # custom matchmaking rules. If you're also using GameLift hosting, a
7232
+ # new game session is started for the matched players. Each matchmaking
7233
+ # request identifies one or more players to find a match for, and
7234
+ # specifies the type of match to build, including the team configuration
7235
+ # and the rules for an acceptable match. When a matchmaking request
7236
+ # identifies a group of players who want to play together, FlexMatch
7237
+ # finds additional players to fill the match. Match type, rules, and
7238
+ # other features are defined in a `MatchmakingConfiguration`.
7193
7239
  #
7194
7240
  # To start matchmaking, provide a unique ticket ID, specify a
7195
- # matchmaking configuration, and include the players to be matched. You
7196
- # must also include a set of player attributes relevant for the
7197
- # matchmaking configuration. If successful, a matchmaking ticket is
7198
- # returned with status set to `QUEUED`.
7199
- #
7200
- # Track the status of the ticket to respond as needed and acquire game
7201
- # session connection information for successfully completed matches.
7202
- # Ticket status updates are tracked using event notification through
7203
- # Amazon Simple Notification Service (SNS), which is defined in the
7204
- # matchmaking configuration.
7205
- #
7206
- # **Processing a matchmaking request** -- FlexMatch handles a
7207
- # matchmaking request as follows:
7208
- #
7209
- # 1. Your client code submits a `StartMatchmaking` request for one or
7210
- # more players and tracks the status of the request ticket.
7211
- #
7212
- # 2. FlexMatch uses this ticket and others in process to build an
7213
- # acceptable match. When a potential match is identified, all
7214
- # tickets in the proposed match are advanced to the next status.
7215
- #
7216
- # 3. If the match requires player acceptance (set in the matchmaking
7217
- # configuration), the tickets move into status
7218
- # `REQUIRES_ACCEPTANCE`. This status triggers your client code to
7219
- # solicit acceptance from all players in every ticket involved in
7220
- # the match, and then call AcceptMatch for each player. If any
7221
- # player rejects or fails to accept the match before a specified
7222
- # timeout, the proposed match is dropped (see `AcceptMatch` for more
7223
- # details).
7224
- #
7225
- # 4. Once a match is proposed and accepted, the matchmaking tickets
7226
- # move into status `PLACING`. FlexMatch locates resources for a new
7227
- # game session using the game session queue (set in the matchmaking
7228
- # configuration) and creates the game session based on the match
7229
- # data.
7230
- #
7231
- # 5. When the match is successfully placed, the matchmaking tickets
7232
- # move into `COMPLETED` status. Connection information (including
7233
- # game session endpoint and player session) is added to the
7234
- # matchmaking tickets. Matched players can use the connection
7235
- # information to join the game.
7241
+ # matchmaking configuration, and include the players to be matched. For
7242
+ # each player, you must also include the player attribute values that
7243
+ # are required by the matchmaking configuration (in the rule set). If
7244
+ # successful, a matchmaking ticket is returned with status set to
7245
+ # `QUEUED`.
7246
+ #
7247
+ # Track the status of the ticket to respond as needed. If you're also
7248
+ # using GameLift hosting, a successfully completed ticket contains game
7249
+ # session connection information. Ticket status updates are tracked
7250
+ # using event notification through Amazon Simple Notification Service
7251
+ # (SNS), which is defined in the matchmaking configuration.
7236
7252
  #
7237
7253
  # **Learn more**
7238
7254
  #
@@ -7258,10 +7274,10 @@ module Aws::GameLift
7258
7274
  #
7259
7275
  #
7260
7276
  #
7261
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
7262
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
7263
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-tasks.html
7264
- # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-match.html
7277
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-client.html
7278
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
7279
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-tasks.html
7280
+ # [4]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/gamelift-match.html
7265
7281
  #
7266
7282
  # @option params [String] :ticket_id
7267
7283
  # A unique identifier for a matchmaking ticket. If no ticket ID is
@@ -7505,7 +7521,7 @@ module Aws::GameLift
7505
7521
  #
7506
7522
  #
7507
7523
  #
7508
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-client.html
7524
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-client.html
7509
7525
  #
7510
7526
  # @option params [required, String] :ticket_id
7511
7527
  # A unique identifier for a matchmaking ticket.
@@ -8685,7 +8701,7 @@ module Aws::GameLift
8685
8701
  #
8686
8702
  #
8687
8703
  #
8688
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-configuration.html
8704
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-configuration.html
8689
8705
  #
8690
8706
  # @option params [required, String] :name
8691
8707
  # A unique identifier for a matchmaking configuration to update. You can
@@ -8697,9 +8713,10 @@ module Aws::GameLift
8697
8713
  # @option params [Array<String>] :game_session_queue_arns
8698
8714
  # Amazon Resource Name ([ARN][1]) that is assigned to a GameLift game
8699
8715
  # session queue resource and uniquely identifies it. ARNs are unique
8700
- # across all Regions. These queues are used when placing game sessions
8701
- # for matches that are created with this matchmaking configuration.
8702
- # Queues can be located in any Region.
8716
+ # across all Regions. Queues can be located in any Region. Queues are
8717
+ # used to start new GameLift-hosted game sessions for matches that are
8718
+ # created with this matchmaking configuration. If `FlexMatchMode` is set
8719
+ # to `STANDALONE`, do not set this parameter.
8703
8720
  #
8704
8721
  #
8705
8722
  #
@@ -8712,14 +8729,17 @@ module Aws::GameLift
8712
8729
  #
8713
8730
  # @option params [Integer] :acceptance_timeout_seconds
8714
8731
  # The length of time (in seconds) to wait for players to accept a
8715
- # proposed match. If any player rejects the match or fails to accept
8716
- # before the timeout, the ticket continues to look for an acceptable
8732
+ # proposed match, if acceptance is required. If any player rejects the
8733
+ # match or fails to accept before the timeout, the tickets are returned
8734
+ # to the ticket pool and continue to be evaluated for an acceptable
8717
8735
  # match.
8718
8736
  #
8719
8737
  # @option params [Boolean] :acceptance_required
8720
8738
  # A flag that indicates whether a match that was created with this
8721
8739
  # configuration must be accepted by the matched players. To require
8722
- # acceptance, set to TRUE.
8740
+ # acceptance, set to TRUE. With this option enabled, matchmaking tickets
8741
+ # use the status `REQUIRES_ACCEPTANCE` to indicate when a completed
8742
+ # potential match is waiting for player acceptance.
8723
8743
  #
8724
8744
  # @option params [String] :rule_set_name
8725
8745
  # A unique identifier for a matchmaking rule set to use with this
@@ -8734,13 +8754,14 @@ module Aws::GameLift
8734
8754
  #
8735
8755
  #
8736
8756
  #
8737
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-notification.html
8757
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-notification.html
8738
8758
  #
8739
8759
  # @option params [Integer] :additional_player_count
8740
8760
  # The number of player slots in a match to keep open for future players.
8741
8761
  # For example, assume that the configuration's rule set specifies a
8742
8762
  # match for a single 12-person team. If the additional player count is
8743
- # set to 2, only 10 players are initially selected for the match.
8763
+ # set to 2, only 10 players are initially selected for the match. This
8764
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
8744
8765
  #
8745
8766
  # @option params [String] :custom_event_data
8746
8767
  # Information to add to all events related to the matchmaking
@@ -8751,7 +8772,8 @@ module Aws::GameLift
8751
8772
  # pairs. These properties are passed to a game server process in the
8752
8773
  # GameSession object with a request to start a new game session (see
8753
8774
  # [Start a Game Session][1]). This information is added to the new
8754
- # GameSession object that is created for a successful match.
8775
+ # GameSession object that is created for a successful match. This
8776
+ # parameter is not used if `FlexMatchMode` is set to `STANDALONE`.
8755
8777
  #
8756
8778
  #
8757
8779
  #
@@ -8762,7 +8784,8 @@ module Aws::GameLift
8762
8784
  # value. This data is passed to a game server process in the GameSession
8763
8785
  # object with a request to start a new game session (see [Start a Game
8764
8786
  # Session][1]). This information is added to the new GameSession object
8765
- # that is created for a successful match.
8787
+ # that is created for a successful match. This parameter is not used if
8788
+ # `FlexMatchMode` is set to `STANDALONE`.
8766
8789
  #
8767
8790
  #
8768
8791
  #
@@ -8775,11 +8798,27 @@ module Aws::GameLift
8775
8798
  # Specify AUTOMATIC to have GameLift create a StartMatchBackfill request
8776
8799
  # whenever a game session has one or more open slots. Learn more about
8777
8800
  # manual and automatic backfill in [Backfill Existing Games with
8778
- # FlexMatch][1].
8801
+ # FlexMatch][1]. Automatic backfill is not available when
8802
+ # `FlexMatchMode` is set to `STANDALONE`.
8803
+ #
8804
+ #
8805
+ #
8806
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html
8779
8807
  #
8808
+ # @option params [String] :flex_match_mode
8809
+ # Indicates whether this matchmaking configuration is being used with
8810
+ # GameLift hosting or as a standalone matchmaking solution.
8780
8811
  #
8812
+ # * **STANDALONE** - FlexMatch forms matches and returns match
8813
+ # information, including players and team assignments, in a [
8814
+ # MatchmakingSucceeded][1] event.
8781
8815
  #
8782
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-backfill.html
8816
+ # * **WITH\_QUEUE** - FlexMatch forms matches and uses the specified
8817
+ # GameLift queue to start a game session for the match.
8818
+ #
8819
+ #
8820
+ #
8821
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-events.html#match-events-matchmakingsucceeded
8783
8822
  #
8784
8823
  # @return [Types::UpdateMatchmakingConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8785
8824
  #
@@ -8806,6 +8845,7 @@ module Aws::GameLift
8806
8845
  # ],
8807
8846
  # game_session_data: "GameSessionData",
8808
8847
  # backfill_mode: "AUTOMATIC", # accepts AUTOMATIC, MANUAL
8848
+ # flex_match_mode: "STANDALONE", # accepts STANDALONE, WITH_QUEUE
8809
8849
  # })
8810
8850
  #
8811
8851
  # @example Response structure
@@ -8829,6 +8869,7 @@ module Aws::GameLift
8829
8869
  # resp.configuration.game_properties[0].value #=> String
8830
8870
  # resp.configuration.game_session_data #=> String
8831
8871
  # resp.configuration.backfill_mode #=> String, one of "AUTOMATIC", "MANUAL"
8872
+ # resp.configuration.flex_match_mode #=> String, one of "STANDALONE", "WITH_QUEUE"
8832
8873
  #
8833
8874
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateMatchmakingConfiguration AWS API Documentation
8834
8875
  #
@@ -8988,14 +9029,20 @@ module Aws::GameLift
8988
9029
  # do not need to be unique.
8989
9030
  #
8990
9031
  # @option params [Types::S3Location] :storage_location
8991
- # The location of the Amazon S3 bucket where a zipped file containing
8992
- # your Realtime scripts is stored. The storage location must specify the
8993
- # Amazon S3 bucket name, the zip file name (the "key"), and a role ARN
8994
- # that allows Amazon GameLift to access the Amazon S3 storage location.
8995
- # The S3 bucket must be in the same Region where you want to create a
8996
- # new script. By default, Amazon GameLift uploads the latest version of
8997
- # the zip file; if you have S3 object versioning turned on, you can use
8998
- # the `ObjectVersion` parameter to specify an earlier version.
9032
+ # The Amazon S3 location of your Realtime scripts. The storage location
9033
+ # must specify the S3 bucket name, the zip file name (the "key"), and
9034
+ # an IAM role ARN that allows Amazon GameLift to access the S3 storage
9035
+ # location. The S3 bucket must be in the same Region as the script
9036
+ # you're updating. By default, Amazon GameLift uploads the latest
9037
+ # version of the zip file; if you have S3 object versioning turned on,
9038
+ # you can use the `ObjectVersion` parameter to specify an earlier
9039
+ # version. To call this operation with a storage location, you must have
9040
+ # IAM PassRole permission. For more details on IAM roles and PassRole
9041
+ # permissions, see [ Set up a role for GameLift access][1].
9042
+ #
9043
+ #
9044
+ #
9045
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
8999
9046
  #
9000
9047
  # @option params [String, StringIO, File] :zip_file
9001
9048
  # A data object containing your Realtime scripts and dependencies as a
@@ -9079,7 +9126,7 @@ module Aws::GameLift
9079
9126
  #
9080
9127
  #
9081
9128
  #
9082
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/match-rulesets.html
9129
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-rulesets.html
9083
9130
  #
9084
9131
  # @option params [required, String] :rule_set_body
9085
9132
  # A collection of matchmaking rules to validate, formatted as a JSON
@@ -9121,7 +9168,7 @@ module Aws::GameLift
9121
9168
  params: params,
9122
9169
  config: config)
9123
9170
  context[:gem_name] = 'aws-sdk-gamelift'
9124
- context[:gem_version] = '1.38.0'
9171
+ context[:gem_version] = '1.39.0'
9125
9172
  Seahorse::Client::Request.new(handlers, context)
9126
9173
  end
9127
9174