aws-sdk-gamelift 1.94.0 → 1.96.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -718,37 +718,41 @@ module Aws::GameLift
718
718
  req.send_request(options)
719
719
  end
720
720
 
721
- # Creates a new Amazon GameLift build resource for your game server
722
- # binary files. Combine game server binaries into a zip file for use
723
- # with Amazon GameLift.
721
+ # Creates an Amazon GameLift build resource for your game server
722
+ # software and stores the software for deployment to hosting resources.
723
+ # Combine game server binaries and dependencies into a single .zip file
724
724
  #
725
- # When setting up a new game build for Amazon GameLift, we recommend
726
- # using the CLI command <b> <a
725
+ # Use the CLI command <b> <a
727
726
  # href="https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html">upload-build</a>
728
- # </b>. This helper command combines two tasks: (1) it uploads your
729
- # build files from a file directory to an Amazon GameLift Amazon S3
730
- # location, and (2) it creates a new build resource.
731
- #
732
- # You can use the `CreateBuild` operation in the following scenarios:
733
- #
734
- # * Create a new game build with build files that are in an Amazon S3
735
- # location under an Amazon Web Services account that you control. To
736
- # use this option, you give Amazon GameLift access to the Amazon S3
737
- # bucket. With permissions in place, specify a build name, operating
738
- # system, and the Amazon S3 storage location of your game build.
739
- #
740
- # * Upload your build files to a Amazon GameLift Amazon S3 location. To
741
- # use this option, specify a build name and operating system. This
742
- # operation creates a new build resource and also returns an Amazon S3
743
- # location with temporary access credentials. Use the credentials to
744
- # manually upload your build files to the specified Amazon S3
745
- # location. For more information, see [Uploading Objects][1] in the
746
- # *Amazon S3 Developer Guide*. After you upload build files to the
747
- # Amazon GameLift Amazon S3 location, you can't update them.
748
- #
749
- # If successful, this operation creates a new build resource with a
750
- # unique build ID and places it in `INITIALIZED` status. A build must be
751
- # in `READY` status before you can create fleets with it.
727
+ # </b> to quickly and simply create a new build and upload your game
728
+ # build .zip file to Amazon GameLift Amazon S3. This helper command
729
+ # eliminates the need to explicitly manage access permissions.
730
+ #
731
+ # Alternatively, use the `CreateBuild` action for the following
732
+ # scenarios:
733
+ #
734
+ # * You want to create a build and upload a game build zip file from in
735
+ # an Amazon S3 location that you control. In this scenario, you need
736
+ # to give Amazon GameLift permission to access to the Amazon S3
737
+ # bucket. With permission in place, call `CreateBuild` and specify a
738
+ # build name, the build's runtime operating system, and the Amazon S3
739
+ # storage location where the build file is stored.
740
+ #
741
+ # * You want to create a build and upload a local game build zip file to
742
+ # an Amazon S3 location that's controlled by Amazon GameLift. (See
743
+ # the `upload-build` CLI command for this scenario.) In this scenario,
744
+ # you need to request temporary access credentials to the Amazon
745
+ # GameLift Amazon S3 location. Specify a build name and the build's
746
+ # runtime operating system. The response provides an Amazon S3
747
+ # location and a set of temporary access credentials. Use the
748
+ # credentials to upload your build files to the specified Amazon S3
749
+ # location (see [Uploading Objects][1] in the *Amazon S3 Developer
750
+ # Guide*). You can't update build files after uploading them to
751
+ # Amazon GameLift Amazon S3.
752
+ #
753
+ # If successful, this action creates a new build resource with a unique
754
+ # build ID and places it in `INITIALIZED` status. When the build reaches
755
+ # `READY` status, you can create fleets with it.
752
756
  #
753
757
  # **Learn more**
754
758
  #
@@ -766,12 +770,12 @@ module Aws::GameLift
766
770
  # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
767
771
  #
768
772
  # @option params [String] :name
769
- # A descriptive label associated with a build. Build names don't need
770
- # to be unique. You can change this value later.
773
+ # A descriptive label that is associated with a build. Build names do
774
+ # not need to be unique. You can change this value later.
771
775
  #
772
776
  # @option params [String] :version
773
- # Version information associated with a build or script. Version strings
774
- # don't need to be unique. You can change this value later.
777
+ # Version information that is associated with a build or script. Version
778
+ # strings do not need to be unique. You can change this value later.
775
779
  #
776
780
  # @option params [Types::S3Location] :storage_location
777
781
  # Information indicating where your game build files are stored. Use
@@ -786,12 +790,11 @@ module Aws::GameLift
786
790
  # `SizeOnDisk` of 0.
787
791
  #
788
792
  # @option params [String] :operating_system
789
- # The operating system that your game server binaries run on. This value
793
+ # The environment that your game server binaries run on. This value
790
794
  # determines the type of fleet resources that you use for this build. If
791
795
  # your game build contains multiple executables, they all must run on
792
- # the same operating system. You must specify a valid operating system
793
- # in this request. There is no default value. You can't change a
794
- # build's operating system later.
796
+ # the same operating system. This parameter is required, and there's no
797
+ # default value. You can't change a build's operating system later.
795
798
  #
796
799
  # <note markdown="1"> Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more
797
800
  # details in the [Amazon Linux 2 FAQs][1]. For game servers that are
@@ -889,39 +892,429 @@ module Aws::GameLift
889
892
  req.send_request(options)
890
893
  end
891
894
 
892
- # <b>This operation is used with the Amazon GameLift containers feature,
893
- # which is currently in public preview. </b>
895
+ # Creates a managed fleet of Amazon Elastic Compute Cloud (Amazon EC2)
896
+ # instances to host your containerized game servers. Use this operation
897
+ # to define how to deploy a container architecture onto each fleet
898
+ # instance and configure fleet settings. You can create a container
899
+ # fleet in any Amazon Web Services Regions that Amazon GameLift supports
900
+ # for multi-location fleets. A container fleet can be deployed to a
901
+ # single location or multiple locations. Container fleets are deployed
902
+ # with Amazon Linux 2023 as the instance operating system.
894
903
  #
895
- # Creates a `ContainerGroupDefinition` resource that describes a set of
904
+ # Define the fleet's container architecture using container group
905
+ # definitions. Each fleet can have one of the following container group
906
+ # types:
907
+ #
908
+ # * The game server container group runs your game server build and
909
+ # dependent software. Amazon GameLift deploys one or more replicas of
910
+ # this container group to each fleet instance. The number of replicas
911
+ # depends on the computing capabilities of the fleet instance in use.
912
+ #
913
+ # * An optional per-instance container group might be used to run other
914
+ # software that only needs to run once per instance, such as
915
+ # background services, logging, or test processes. One per-instance
916
+ # container group is deployed to each fleet instance.
917
+ #
918
+ # Each container group can include the definition for one or more
919
+ # containers. A container definition specifies a container image that is
920
+ # stored in an Amazon Elastic Container Registry (Amazon ECR) public or
921
+ # private repository.
922
+ #
923
+ # **Request options**
924
+ #
925
+ # Use this operation to make the following types of requests. Most fleet
926
+ # settings have default values, so you can create a working fleet with a
927
+ # minimal configuration and default values, which you can customize
928
+ # later.
929
+ #
930
+ # * Create a fleet with no container groups. You can configure a
931
+ # container fleet and then add container group definitions later. In
932
+ # this scenario, no fleet instances are deployed, and the fleet can't
933
+ # host game sessions until you add a game server container group
934
+ # definition. Provide the following required parameter values:
935
+ #
936
+ # * `FleetRoleArn`
937
+ #
938
+ # ^
939
+ # * Create a fleet with a game server container group. Provide the
940
+ # following required parameter values:
941
+ #
942
+ # * `FleetRoleArn`
943
+ #
944
+ # * `GameServerContainerGroupDefinitionName`
945
+ # * Create a fleet with a game server container group and a per-instance
946
+ # container group. Provide the following required parameter values:
947
+ #
948
+ # * `FleetRoleArn`
949
+ #
950
+ # * `GameServerContainerGroupDefinitionName`
951
+ #
952
+ # * `PerInstanceContainerGroupDefinitionName`
953
+ #
954
+ # **Results**
955
+ #
956
+ # If successful, this operation creates a new container fleet resource,
957
+ # places it in `PENDING` status, and initiates the [fleet creation
958
+ # workflow][1]. For fleets with container groups, this workflow starts a
959
+ # fleet deployment and transitions the status to `ACTIVE`. Fleets
960
+ # without a container group are placed in `CREATED` status.
961
+ #
962
+ # You can update most of the properties of a fleet, including container
963
+ # group definitions, and deploy the update across all fleet instances.
964
+ # Use a fleet update to deploy a new game server version update across
965
+ # the container fleet.
966
+ #
967
+ #
968
+ #
969
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-all.html#fleets-creation-workflow
970
+ #
971
+ # @option params [required, String] :fleet_role_arn
972
+ # The unique identifier for an Identity and Access Management (IAM) role
973
+ # with permissions to run your containers on resources that are managed
974
+ # by Amazon GameLift. Use an IAM service role with the
975
+ # `GameLiftContainerFleetPolicy` managed policy attached. For more
976
+ # information, see [Set up an IAM service role][1]. You can't change
977
+ # this fleet property after the fleet is created.
978
+ #
979
+ # IAM role ARN values use the following pattern: `arn:aws:iam::[Amazon
980
+ # Web Services account]:role/[role name]`.
981
+ #
982
+ #
983
+ #
984
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/setting-up-role.html
985
+ #
986
+ # @option params [String] :description
987
+ # A meaningful description of the container fleet.
988
+ #
989
+ # @option params [String] :game_server_container_group_definition_name
990
+ # A container group definition resource that describes how to deploy
991
+ # containers with your game server build and support software onto each
992
+ # fleet instance. You can specify the container group definition's name
993
+ # to use the latest version. Alternatively, provide an ARN value with a
994
+ # specific version number.
995
+ #
996
+ # Create a container group definition by calling
997
+ # CreateContainerGroupDefinition. This operation creates a
998
+ # ContainerGroupDefinition resource.
999
+ #
1000
+ # @option params [String] :per_instance_container_group_definition_name
1001
+ # The name of a container group definition resource that describes a set
1002
+ # of axillary software. A fleet instance has one process for executables
1003
+ # in this container group. A per-instance container group is optional.
1004
+ # You can update the fleet to add or remove a per-instance container
1005
+ # group at any time. You can specify the container group definition's
1006
+ # name to use the latest version. Alternatively, provide an ARN value
1007
+ # with a specific version number.
1008
+ #
1009
+ # Create a container group definition by calling
1010
+ # CreateContainerGroupDefinition. This operation creates a
1011
+ # ContainerGroupDefinition resource.
1012
+ #
1013
+ # @option params [Types::ConnectionPortRange] :instance_connection_port_range
1014
+ # The set of port numbers to open on each fleet instance. A fleet's
1015
+ # connection ports map to container ports that are configured in the
1016
+ # fleet's container group definitions.
1017
+ #
1018
+ # By default, Amazon GameLift calculates an optimal port range based on
1019
+ # your fleet configuration. To use the calculated range, don't set this
1020
+ # parameter. The values are:
1021
+ #
1022
+ # * Port range: 4192 to a number calculated based on your fleet
1023
+ # configuration. Amazon GameLift uses the following formula: `4192 +
1024
+ # [# of game server container groups per fleet instance] * [# of
1025
+ # container ports in the game server container group definition] + [#
1026
+ # of container ports in the game server container group definition]`
1027
+ #
1028
+ # ^
1029
+ #
1030
+ # You can also choose to manually set this parameter. When manually
1031
+ # setting this parameter, you must use port numbers that match the
1032
+ # fleet's inbound permissions port range.
1033
+ #
1034
+ # <note markdown="1"> If you set values manually, Amazon GameLift no longer calculates a
1035
+ # port range for you, even if you later remove the manual settings.
1036
+ #
1037
+ # </note>
1038
+ #
1039
+ # @option params [Array<Types::IpPermission>] :instance_inbound_permissions
1040
+ # The IP address ranges and port settings that allow inbound traffic to
1041
+ # access game server processes and other processes on this fleet. As a
1042
+ # best practice, when remotely accessing a fleet instance, we recommend
1043
+ # opening ports only when you need them and closing them when you're
1044
+ # finished.
1045
+ #
1046
+ # By default, Amazon GameLift calculates an optimal port range based on
1047
+ # your fleet configuration. To use the calculated range, don't set this
1048
+ # parameter. The values are:
1049
+ #
1050
+ # * Protocol: UDP
1051
+ #
1052
+ # * Port range: 4192 to a number calculated based on your fleet
1053
+ # configuration. Amazon GameLift uses the following formula: `4192 +
1054
+ # [# of game server container groups per fleet instance] * [# of
1055
+ # container ports in the game server container group definition] + [#
1056
+ # of container ports in the game server container group definition]`
1057
+ #
1058
+ # You can also choose to manually set this parameter. When manually
1059
+ # setting this parameter, you must use port numbers that match the
1060
+ # fleet's connection port range.
1061
+ #
1062
+ # <note markdown="1"> If you set values manually, Amazon GameLift no longer calculates a
1063
+ # port range for you, even if you later remove the manual settings.
1064
+ #
1065
+ # </note>
1066
+ #
1067
+ # @option params [Integer] :game_server_container_groups_per_instance
1068
+ # The number of times to replicate the game server container group on
1069
+ # each fleet instance.
1070
+ #
1071
+ # By default, Amazon GameLift calculates the maximum number of game
1072
+ # server container groups that can fit on each instance. This
1073
+ # calculation is based on the CPU and memory resources of the fleet's
1074
+ # instance type). To use the calculated maximum, don't set this
1075
+ # parameter. If you set this number manually, Amazon GameLift uses your
1076
+ # value as long as it's less than the calculated maximum.
1077
+ #
1078
+ # @option params [String] :instance_type
1079
+ # The Amazon EC2 instance type to use for all instances in the fleet.
1080
+ # For multi-location fleets, the instance type must be available in the
1081
+ # home region and all remote locations. Instance type determines the
1082
+ # computing resources and processing power that's available to host
1083
+ # your game servers. This includes including CPU, memory, storage, and
1084
+ # networking capacity.
1085
+ #
1086
+ # By default, Amazon GameLift selects an instance type that fits the
1087
+ # needs of your container groups and is available in all selected fleet
1088
+ # locations. You can also choose to manually set this parameter. See
1089
+ # [Amazon Elastic Compute Cloud Instance Types][1] for detailed
1090
+ # descriptions of Amazon EC2 instance types.
1091
+ #
1092
+ # You can't update this fleet property later.
1093
+ #
1094
+ #
1095
+ #
1096
+ # [1]: http://aws.amazon.com/ec2/instance-types/
1097
+ #
1098
+ # @option params [String] :billing_type
1099
+ # Indicates whether to use On-Demand or Spot instances for this fleet.
1100
+ # Learn more about when to use [ On-Demand versus Spot Instances][1].
1101
+ # This fleet property can't be changed after the fleet is created.
1102
+ #
1103
+ # By default, this property is set to `ON_DEMAND`.
1104
+ #
1105
+ # You can't update this fleet property later.
1106
+ #
1107
+ #
1108
+ #
1109
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
1110
+ #
1111
+ # @option params [Array<Types::LocationConfiguration>] :locations
1112
+ # A set of locations to deploy container fleet instances to. You can add
1113
+ # any Amazon Web Services Region or Local Zone that's supported by
1114
+ # Amazon GameLift. Provide a list of one or more Amazon Web Services
1115
+ # Region codes, such as `us-west-2`, or Local Zone names. Also include
1116
+ # the fleet's home Region, which is the Amazon Web Services Region
1117
+ # where the fleet is created. For a list of supported Regions and Local
1118
+ # Zones, see [ Amazon GameLift service locations][1] for managed
1119
+ # hosting.
1120
+ #
1121
+ #
1122
+ #
1123
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-regions.html
1124
+ #
1125
+ # @option params [Array<String>] :metric_groups
1126
+ # The name of an Amazon Web Services CloudWatch metric group to add this
1127
+ # fleet to. You can use a metric group to aggregate metrics for multiple
1128
+ # fleets. You can specify an existing metric group name or use a new
1129
+ # name to create a new metric group. Each fleet can have only one metric
1130
+ # group, but you can change this value at any time.
1131
+ #
1132
+ # @option params [String] :new_game_session_protection_policy
1133
+ # Determines whether Amazon GameLift can shut down game sessions on the
1134
+ # fleet that are actively running and hosting players. Amazon GameLift
1135
+ # might prompt an instance shutdown when scaling down fleet capacity or
1136
+ # when retiring unhealthy instances. You can also set game session
1137
+ # protection for individual game sessions using
1138
+ # [UpdateGameSession](gamelift/latest/apireference/API_UpdateGameSession.html).
1139
+ #
1140
+ # * **NoProtection** -- Game sessions can be shut down during active
1141
+ # gameplay.
1142
+ #
1143
+ # * **FullProtection** -- Game sessions in `ACTIVE` status can't be
1144
+ # shut down.
1145
+ #
1146
+ # By default, this property is set to `NoProtection`.
1147
+ #
1148
+ # @option params [Types::GameSessionCreationLimitPolicy] :game_session_creation_limit_policy
1149
+ # A policy that limits the number of game sessions that each individual
1150
+ # player can create on instances in this fleet. The limit applies for a
1151
+ # specified span of time.
1152
+ #
1153
+ # @option params [Types::LogConfiguration] :log_configuration
1154
+ # A method for collecting container logs for the fleet. Amazon GameLift
1155
+ # saves all standard output for each container in logs, including game
1156
+ # session logs. You can select from the following methods:
1157
+ #
1158
+ # * `CLOUDWATCH` -- Send logs to an Amazon CloudWatch log group that you
1159
+ # define. Each container emits a log stream, which is organized in the
1160
+ # log group.
1161
+ #
1162
+ # * `S3` -- Store logs in an Amazon S3 bucket that you define.
1163
+ #
1164
+ # * `NONE` -- Don't collect container logs.
1165
+ #
1166
+ # By default, this property is set to `CLOUDWATCH`.
1167
+ #
1168
+ # Amazon GameLift requires permissions to send logs other Amazon Web
1169
+ # Services services in your account. These permissions are included in
1170
+ # the IAM fleet role for this container fleet (see `FleetRoleArn)`.
1171
+ #
1172
+ # @option params [Array<Types::Tag>] :tags
1173
+ # A list of labels to assign to the new fleet resource. Tags are
1174
+ # developer-defined key-value pairs. Tagging Amazon Web Services
1175
+ # resources are useful for resource management, access management and
1176
+ # cost allocation. For more information, see [ Tagging Amazon Web
1177
+ # Services Resources][1] in the *Amazon Web Services General Reference*.
1178
+ #
1179
+ #
1180
+ #
1181
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1182
+ #
1183
+ # @return [Types::CreateContainerFleetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1184
+ #
1185
+ # * {Types::CreateContainerFleetOutput#container_fleet #container_fleet} => Types::ContainerFleet
1186
+ #
1187
+ # @example Request syntax with placeholder values
1188
+ #
1189
+ # resp = client.create_container_fleet({
1190
+ # fleet_role_arn: "ArnStringModel", # required
1191
+ # description: "NonZeroAndMaxString",
1192
+ # game_server_container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
1193
+ # per_instance_container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
1194
+ # instance_connection_port_range: {
1195
+ # from_port: 1, # required
1196
+ # to_port: 1, # required
1197
+ # },
1198
+ # instance_inbound_permissions: [
1199
+ # {
1200
+ # from_port: 1, # required
1201
+ # to_port: 1, # required
1202
+ # ip_range: "IpRange", # required
1203
+ # protocol: "TCP", # required, accepts TCP, UDP
1204
+ # },
1205
+ # ],
1206
+ # game_server_container_groups_per_instance: 1,
1207
+ # instance_type: "NonZeroAndMaxString",
1208
+ # billing_type: "ON_DEMAND", # accepts ON_DEMAND, SPOT
1209
+ # locations: [
1210
+ # {
1211
+ # location: "LocationStringModel", # required
1212
+ # },
1213
+ # ],
1214
+ # metric_groups: ["MetricGroup"],
1215
+ # new_game_session_protection_policy: "NoProtection", # accepts NoProtection, FullProtection
1216
+ # game_session_creation_limit_policy: {
1217
+ # new_game_sessions_per_creator: 1,
1218
+ # policy_period_in_minutes: 1,
1219
+ # },
1220
+ # log_configuration: {
1221
+ # log_destination: "NONE", # accepts NONE, CLOUDWATCH, S3
1222
+ # s3_bucket_name: "NonEmptyString",
1223
+ # log_group_arn: "LogGroupArnStringModel",
1224
+ # },
1225
+ # tags: [
1226
+ # {
1227
+ # key: "TagKey", # required
1228
+ # value: "TagValue", # required
1229
+ # },
1230
+ # ],
1231
+ # })
1232
+ #
1233
+ # @example Response structure
1234
+ #
1235
+ # resp.container_fleet.fleet_id #=> String
1236
+ # resp.container_fleet.fleet_arn #=> String
1237
+ # resp.container_fleet.fleet_role_arn #=> String
1238
+ # resp.container_fleet.game_server_container_group_definition_name #=> String
1239
+ # resp.container_fleet.game_server_container_group_definition_arn #=> String
1240
+ # resp.container_fleet.per_instance_container_group_definition_name #=> String
1241
+ # resp.container_fleet.per_instance_container_group_definition_arn #=> String
1242
+ # resp.container_fleet.instance_connection_port_range.from_port #=> Integer
1243
+ # resp.container_fleet.instance_connection_port_range.to_port #=> Integer
1244
+ # resp.container_fleet.instance_inbound_permissions #=> Array
1245
+ # resp.container_fleet.instance_inbound_permissions[0].from_port #=> Integer
1246
+ # resp.container_fleet.instance_inbound_permissions[0].to_port #=> Integer
1247
+ # resp.container_fleet.instance_inbound_permissions[0].ip_range #=> String
1248
+ # resp.container_fleet.instance_inbound_permissions[0].protocol #=> String, one of "TCP", "UDP"
1249
+ # resp.container_fleet.game_server_container_groups_per_instance #=> Integer
1250
+ # resp.container_fleet.maximum_game_server_container_groups_per_instance #=> Integer
1251
+ # resp.container_fleet.instance_type #=> String
1252
+ # resp.container_fleet.billing_type #=> String, one of "ON_DEMAND", "SPOT"
1253
+ # resp.container_fleet.description #=> String
1254
+ # resp.container_fleet.creation_time #=> Time
1255
+ # resp.container_fleet.metric_groups #=> Array
1256
+ # resp.container_fleet.metric_groups[0] #=> String
1257
+ # resp.container_fleet.new_game_session_protection_policy #=> String, one of "NoProtection", "FullProtection"
1258
+ # resp.container_fleet.game_session_creation_limit_policy.new_game_sessions_per_creator #=> Integer
1259
+ # resp.container_fleet.game_session_creation_limit_policy.policy_period_in_minutes #=> Integer
1260
+ # resp.container_fleet.status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
1261
+ # resp.container_fleet.deployment_details.latest_deployment_id #=> String
1262
+ # resp.container_fleet.log_configuration.log_destination #=> String, one of "NONE", "CLOUDWATCH", "S3"
1263
+ # resp.container_fleet.log_configuration.s3_bucket_name #=> String
1264
+ # resp.container_fleet.log_configuration.log_group_arn #=> String
1265
+ # resp.container_fleet.location_attributes #=> Array
1266
+ # resp.container_fleet.location_attributes[0].location #=> String
1267
+ # resp.container_fleet.location_attributes[0].status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
1268
+ #
1269
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateContainerFleet AWS API Documentation
1270
+ #
1271
+ # @overload create_container_fleet(params = {})
1272
+ # @param [Hash] params ({})
1273
+ def create_container_fleet(params = {}, options = {})
1274
+ req = build_request(:create_container_fleet, params)
1275
+ req.send_request(options)
1276
+ end
1277
+
1278
+ # Creates a `ContainerGroupDefinition` that describes a set of
896
1279
  # containers for hosting your game server with Amazon GameLift managed
897
- # EC2 hosting. An Amazon GameLift container group is similar to a
898
- # container "task" and "pod". Each container group can have one or
899
- # more containers.
900
- #
901
- # Use container group definitions when you create a container fleet.
902
- # Container group definitions determine how Amazon GameLift deploys your
903
- # containers to each instance in a container fleet.
904
- #
905
- # You can create two types of container groups, based on scheduling
906
- # strategy:
907
- #
908
- # * A **replica container group** manages the containers that run your
909
- # game server application and supporting software. Replica container
910
- # groups might be replicated multiple times on each fleet instance,
911
- # depending on instance resources.
912
- #
913
- # * A **daemon container group** manages containers that run other
914
- # software, such as background services, logging, or test processes.
915
- # You might use a daemon container group for processes that need to
916
- # run only once per fleet instance, or processes that need to persist
917
- # independently of the replica container group.
918
- #
919
- # To create a container group definition, specify a group name, a list
920
- # of container definitions, and maximum total CPU and memory
921
- # requirements for the container group. Specify an operating system and
922
- # scheduling strategy or use the default values. When using the Amazon
923
- # Web Services CLI tool, you can pass in your container definitions as a
924
- # JSON file.
1280
+ # containers hosting. An Amazon GameLift container group is similar to a
1281
+ # container task or pod. Use container group definitions when you create
1282
+ # a container fleet with CreateContainerFleet.
1283
+ #
1284
+ # A container group definition determines how Amazon GameLift deploys
1285
+ # your containers to each instance in a container fleet. You can
1286
+ # maintain multiple versions of a container group definition.
1287
+ #
1288
+ # There are two types of container groups:
1289
+ #
1290
+ # * A **game server container group** has the containers that run your
1291
+ # game server application and supporting software. A game server
1292
+ # container group can have these container types:
1293
+ #
1294
+ # * Game server container. This container runs your game server. You
1295
+ # can define one game server container in a game server container
1296
+ # group.
1297
+ #
1298
+ # * Support container. This container runs software in parallel with
1299
+ # your game server. You can define up to 8 support containers in a
1300
+ # game server group.
1301
+ # When building a game server container group definition, you can
1302
+ # choose to bundle your game server executable and all dependent
1303
+ # software into a single game server container. Alternatively, you can
1304
+ # separate the software into one game server container and one or more
1305
+ # support containers.
1306
+ #
1307
+ # On a container fleet instance, a game server container group can be
1308
+ # deployed multiple times (depending on the compute resources of the
1309
+ # instance). This means that all containers in the container group are
1310
+ # replicated together.
1311
+ #
1312
+ # * A **per-instance container group** has containers for processes that
1313
+ # aren't replicated on a container fleet instance. This might include
1314
+ # background services, logging, test processes, or processes that need
1315
+ # to persist independently of the game server container group. When
1316
+ # building a per-instance container group, you can define up to 10
1317
+ # support containers.
925
1318
  #
926
1319
  # <note markdown="1"> This operation requires Identity and Access Management (IAM)
927
1320
  # permissions to access container images in Amazon ECR repositories. See
@@ -930,71 +1323,115 @@ module Aws::GameLift
930
1323
  #
931
1324
  # </note>
932
1325
  #
933
- # If successful, this operation creates a new `ContainerGroupDefinition`
934
- # resource with an ARN value assigned. You can't change the properties
935
- # of a container group definition. Instead, create a new one.
1326
+ # **Request options**
936
1327
  #
937
- # **Learn more**
1328
+ # Use this operation to make the following types of requests. You can
1329
+ # specify values for the minimum required parameters and customize
1330
+ # optional values later.
1331
+ #
1332
+ # * Create a game server container group definition. Provide the
1333
+ # following required parameter values:
1334
+ #
1335
+ # * `Name`
1336
+ #
1337
+ # * `ContainerGroupType` (`GAME_SERVER`)
1338
+ #
1339
+ # * `OperatingSystem` (omit to use default value)
1340
+ #
1341
+ # * `TotalMemoryLimitMebibytes` (omit to use default value)
1342
+ #
1343
+ # * `TotalVcpuLimit `(omit to use default value)
1344
+ #
1345
+ # * At least one `GameServerContainerDefinition`
1346
+ #
1347
+ # * `ContainerName`
1348
+ #
1349
+ # * `ImageUrl`
1350
+ #
1351
+ # * `PortConfiguration`
1352
+ #
1353
+ # * `ServerSdkVersion` (omit to use default value)
1354
+ # * Create a per-instance container group definition. Provide the
1355
+ # following required parameter values:
1356
+ #
1357
+ # * `Name`
1358
+ #
1359
+ # * `ContainerGroupType` (`PER_INSTANCE`)
1360
+ #
1361
+ # * `OperatingSystem` (omit to use default value)
1362
+ #
1363
+ # * `TotalMemoryLimitMebibytes` (omit to use default value)
1364
+ #
1365
+ # * `TotalVcpuLimit `(omit to use default value)
1366
+ #
1367
+ # * At least one `SupportContainerDefinition`
1368
+ #
1369
+ # * `ContainerName`
938
1370
  #
939
- # * [Create a container group definition][2]
1371
+ # * `ImageUrl`
940
1372
  #
941
- # * [Container fleet design guide][3]
1373
+ # **Results**
942
1374
  #
943
- # * [Create a container definition as a JSON file][4]
1375
+ # If successful, this request creates a `ContainerGroupDefinition`
1376
+ # resource and assigns a unique ARN value. You can update most
1377
+ # properties of a container group definition by calling
1378
+ # UpdateContainerGroupDefinition, and optionally save the update as a
1379
+ # new version.
944
1380
  #
945
1381
  #
946
1382
  #
947
1383
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-iam-policy-examples.html
948
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-create-groups.html
949
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-design-fleet.html
950
- # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-definitions.html#containers-definitions-create
951
1384
  #
952
1385
  # @option params [required, String] :name
953
1386
  # A descriptive identifier for the container group definition. The name
954
1387
  # value must be unique in an Amazon Web Services Region.
955
1388
  #
956
- # @option params [String] :scheduling_strategy
957
- # The method for deploying the container group across fleet instances. A
958
- # replica container group might have multiple copies on each fleet
959
- # instance. A daemon container group has one copy per fleet instance.
960
- # Default value is `REPLICA`.
1389
+ # @option params [String] :container_group_type
1390
+ # The type of container group being defined. Container group type
1391
+ # determines how Amazon GameLift deploys the container group on each
1392
+ # fleet instance.
961
1393
  #
962
- # @option params [required, Integer] :total_memory_limit
1394
+ # Default value: `GAME_SERVER`
1395
+ #
1396
+ # @option params [required, Integer] :total_memory_limit_mebibytes
963
1397
  # The maximum amount of memory (in MiB) to allocate to the container
964
1398
  # group. All containers in the group share this memory. If you specify
965
- # memory limits for individual containers, set this parameter based on
966
- # the following guidelines. The value must be (1) greater than the sum
967
- # of the soft memory limits for all containers in the group, and (2)
968
- # greater than any individual container's hard memory limit.
1399
+ # memory limits for an individual container, the total value must be
1400
+ # greater than any individual container's memory limit.
969
1401
  #
970
- # @option params [required, Integer] :total_cpu_limit
971
- # The maximum amount of CPU units to allocate to the container group.
972
- # Set this parameter to an integer value in CPU units (1 vCPU is equal
973
- # to 1024 CPU units). All containers in the group share this memory. If
974
- # you specify CPU limits for individual containers, set this parameter
975
- # based on the following guidelines. The value must be equal to or
976
- # greater than the sum of the CPU limits for all containers in the
977
- # group.
1402
+ # Default value: 1024
978
1403
  #
979
- # @option params [required, Array<Types::ContainerDefinitionInput>] :container_definitions
980
- # Definitions for all containers in this group. Each container
981
- # definition identifies the container image and specifies configuration
982
- # settings for the container. See the [ Container fleet design guide][1]
983
- # for container guidelines.
1404
+ # @option params [required, Float] :total_vcpu_limit
1405
+ # The maximum amount of vCPU units to allocate to the container group (1
1406
+ # vCPU is equal to 1024 CPU units). All containers in the group share
1407
+ # this memory. If you specify vCPU limits for individual containers, the
1408
+ # total value must be equal to or greater than the sum of the CPU limits
1409
+ # for all containers in the group.
984
1410
  #
1411
+ # Default value: 1
985
1412
  #
1413
+ # @option params [Types::GameServerContainerDefinitionInput] :game_server_container_definition
1414
+ # The definition for the game server container in this group. Define a
1415
+ # game server container only when the container group type is
1416
+ # `GAME_SERVER`. Game server containers specify a container image with
1417
+ # your game server build. You can pass in your container definitions as
1418
+ # a JSON file.
986
1419
  #
987
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-design-fleet.html
1420
+ # @option params [Array<Types::SupportContainerDefinitionInput>] :support_container_definitions
1421
+ # One or more definition for support containers in this group. You can
1422
+ # define a support container in any type of container group. You can
1423
+ # pass in your container definitions as a JSON file.
988
1424
  #
989
1425
  # @option params [required, String] :operating_system
990
- # The platform that is used by containers in the container group
991
- # definition. All containers in a group must run on the same operating
992
- # system.
1426
+ # The platform that all containers in the group use. Containers in a
1427
+ # group must run on the same operating system.
1428
+ #
1429
+ # Default value: `AMAZON_LINUX_2023`
993
1430
  #
994
1431
  # <note markdown="1"> Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more
995
1432
  # details in the [Amazon Linux 2 FAQs][1]. For game servers that are
996
- # hosted on AL2 and use Amazon GameLift server SDK 4.x., first update
997
- # the game server build to server SDK 5.x, and then deploy to AL2023
1433
+ # hosted on AL2 and use Amazon GameLift server SDK 4.x, first update the
1434
+ # game server build to server SDK 5.x, and then deploy to AL2023
998
1435
  # instances. See [ Migrate to Amazon GameLift server SDK version 5.][2]
999
1436
  #
1000
1437
  # </note>
@@ -1004,6 +1441,10 @@ module Aws::GameLift
1004
1441
  # [1]: https://aws.amazon.com/amazon-linux-2/faqs/
1005
1442
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html
1006
1443
  #
1444
+ # @option params [String] :version_description
1445
+ # A description for the initial version of this container group
1446
+ # definition.
1447
+ #
1007
1448
  # @option params [Array<Types::Tag>] :tags
1008
1449
  # A list of labels to assign to the container group definition resource.
1009
1450
  # Tags are developer-defined key-value pairs. Tagging Amazon Web
@@ -1024,53 +1465,88 @@ module Aws::GameLift
1024
1465
  #
1025
1466
  # resp = client.create_container_group_definition({
1026
1467
  # name: "ContainerGroupDefinitionName", # required
1027
- # scheduling_strategy: "REPLICA", # accepts REPLICA, DAEMON
1028
- # total_memory_limit: 1, # required
1029
- # total_cpu_limit: 1, # required
1030
- # container_definitions: [ # required
1031
- # {
1032
- # container_name: "NonZeroAnd128MaxAsciiString", # required
1033
- # image_uri: "ImageUriString", # required
1034
- # memory_limits: {
1035
- # soft_limit: 1,
1036
- # hard_limit: 1,
1468
+ # container_group_type: "GAME_SERVER", # accepts GAME_SERVER, PER_INSTANCE
1469
+ # total_memory_limit_mebibytes: 1, # required
1470
+ # total_vcpu_limit: 1.0, # required
1471
+ # game_server_container_definition: {
1472
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
1473
+ # depends_on: [
1474
+ # {
1475
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
1476
+ # condition: "START", # required, accepts START, COMPLETE, SUCCESS, HEALTHY
1037
1477
  # },
1038
- # port_configuration: {
1039
- # container_port_ranges: [ # required
1040
- # {
1041
- # from_port: 1, # required
1042
- # to_port: 1, # required
1043
- # protocol: "TCP", # required, accepts TCP, UDP
1044
- # },
1045
- # ],
1478
+ # ],
1479
+ # mount_points: [
1480
+ # {
1481
+ # instance_path: "InstancePathString", # required
1482
+ # container_path: "ContainerPathString",
1483
+ # access_level: "READ_ONLY", # accepts READ_ONLY, READ_AND_WRITE
1046
1484
  # },
1047
- # cpu: 1,
1048
- # health_check: {
1049
- # command: ["NonZeroAnd255MaxString"], # required
1050
- # interval: 1,
1051
- # timeout: 1,
1052
- # retries: 1,
1053
- # start_period: 1,
1485
+ # ],
1486
+ # environment_override: [
1487
+ # {
1488
+ # name: "NonZeroAnd255MaxString", # required
1489
+ # value: "NonZeroAnd255MaxString", # required
1054
1490
  # },
1055
- # command: ["NonZeroAnd255MaxString"],
1056
- # essential: false,
1057
- # entry_point: ["NonZeroAndMaxString"],
1058
- # working_directory: "NonZeroAnd255MaxString",
1059
- # environment: [
1491
+ # ],
1492
+ # image_uri: "ImageUriString", # required
1493
+ # port_configuration: { # required
1494
+ # container_port_ranges: [ # required
1060
1495
  # {
1061
- # name: "NonZeroAnd255MaxString", # required
1062
- # value: "NonZeroAnd255MaxString", # required
1496
+ # from_port: 1, # required
1497
+ # to_port: 1, # required
1498
+ # protocol: "TCP", # required, accepts TCP, UDP
1063
1499
  # },
1064
1500
  # ],
1501
+ # },
1502
+ # server_sdk_version: "ServerSdkVersion", # required
1503
+ # },
1504
+ # support_container_definitions: [
1505
+ # {
1506
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
1065
1507
  # depends_on: [
1066
1508
  # {
1067
1509
  # container_name: "NonZeroAnd128MaxAsciiString", # required
1068
1510
  # condition: "START", # required, accepts START, COMPLETE, SUCCESS, HEALTHY
1069
1511
  # },
1070
1512
  # ],
1513
+ # mount_points: [
1514
+ # {
1515
+ # instance_path: "InstancePathString", # required
1516
+ # container_path: "ContainerPathString",
1517
+ # access_level: "READ_ONLY", # accepts READ_ONLY, READ_AND_WRITE
1518
+ # },
1519
+ # ],
1520
+ # environment_override: [
1521
+ # {
1522
+ # name: "NonZeroAnd255MaxString", # required
1523
+ # value: "NonZeroAnd255MaxString", # required
1524
+ # },
1525
+ # ],
1526
+ # essential: false,
1527
+ # health_check: {
1528
+ # command: ["NonZeroAnd255MaxString"], # required
1529
+ # interval: 1,
1530
+ # retries: 1,
1531
+ # start_period: 1,
1532
+ # timeout: 1,
1533
+ # },
1534
+ # image_uri: "ImageUriString", # required
1535
+ # memory_hard_limit_mebibytes: 1,
1536
+ # port_configuration: {
1537
+ # container_port_ranges: [ # required
1538
+ # {
1539
+ # from_port: 1, # required
1540
+ # to_port: 1, # required
1541
+ # protocol: "TCP", # required, accepts TCP, UDP
1542
+ # },
1543
+ # ],
1544
+ # },
1545
+ # vcpu: 1.0,
1071
1546
  # },
1072
1547
  # ],
1073
1548
  # operating_system: "AMAZON_LINUX_2023", # required, accepts AMAZON_LINUX_2023
1549
+ # version_description: "NonZeroAndMaxString",
1074
1550
  # tags: [
1075
1551
  # {
1076
1552
  # key: "TagKey", # required
@@ -1085,38 +1561,56 @@ module Aws::GameLift
1085
1561
  # resp.container_group_definition.creation_time #=> Time
1086
1562
  # resp.container_group_definition.operating_system #=> String, one of "AMAZON_LINUX_2023"
1087
1563
  # resp.container_group_definition.name #=> String
1088
- # resp.container_group_definition.scheduling_strategy #=> String, one of "REPLICA", "DAEMON"
1089
- # resp.container_group_definition.total_memory_limit #=> Integer
1090
- # resp.container_group_definition.total_cpu_limit #=> Integer
1091
- # resp.container_group_definition.container_definitions #=> Array
1092
- # resp.container_group_definition.container_definitions[0].container_name #=> String
1093
- # resp.container_group_definition.container_definitions[0].image_uri #=> String
1094
- # resp.container_group_definition.container_definitions[0].resolved_image_digest #=> String
1095
- # resp.container_group_definition.container_definitions[0].memory_limits.soft_limit #=> Integer
1096
- # resp.container_group_definition.container_definitions[0].memory_limits.hard_limit #=> Integer
1097
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges #=> Array
1098
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
1099
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
1100
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
1101
- # resp.container_group_definition.container_definitions[0].cpu #=> Integer
1102
- # resp.container_group_definition.container_definitions[0].health_check.command #=> Array
1103
- # resp.container_group_definition.container_definitions[0].health_check.command[0] #=> String
1104
- # resp.container_group_definition.container_definitions[0].health_check.interval #=> Integer
1105
- # resp.container_group_definition.container_definitions[0].health_check.timeout #=> Integer
1106
- # resp.container_group_definition.container_definitions[0].health_check.retries #=> Integer
1107
- # resp.container_group_definition.container_definitions[0].health_check.start_period #=> Integer
1108
- # resp.container_group_definition.container_definitions[0].command #=> Array
1109
- # resp.container_group_definition.container_definitions[0].command[0] #=> String
1110
- # resp.container_group_definition.container_definitions[0].essential #=> Boolean
1111
- # resp.container_group_definition.container_definitions[0].entry_point #=> Array
1112
- # resp.container_group_definition.container_definitions[0].entry_point[0] #=> String
1113
- # resp.container_group_definition.container_definitions[0].working_directory #=> String
1114
- # resp.container_group_definition.container_definitions[0].environment #=> Array
1115
- # resp.container_group_definition.container_definitions[0].environment[0].name #=> String
1116
- # resp.container_group_definition.container_definitions[0].environment[0].value #=> String
1117
- # resp.container_group_definition.container_definitions[0].depends_on #=> Array
1118
- # resp.container_group_definition.container_definitions[0].depends_on[0].container_name #=> String
1119
- # resp.container_group_definition.container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
1564
+ # resp.container_group_definition.container_group_type #=> String, one of "GAME_SERVER", "PER_INSTANCE"
1565
+ # resp.container_group_definition.total_memory_limit_mebibytes #=> Integer
1566
+ # resp.container_group_definition.total_vcpu_limit #=> Float
1567
+ # resp.container_group_definition.game_server_container_definition.container_name #=> String
1568
+ # resp.container_group_definition.game_server_container_definition.depends_on #=> Array
1569
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].container_name #=> String
1570
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
1571
+ # resp.container_group_definition.game_server_container_definition.mount_points #=> Array
1572
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].instance_path #=> String
1573
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].container_path #=> String
1574
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
1575
+ # resp.container_group_definition.game_server_container_definition.environment_override #=> Array
1576
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].name #=> String
1577
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].value #=> String
1578
+ # resp.container_group_definition.game_server_container_definition.image_uri #=> String
1579
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges #=> Array
1580
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].from_port #=> Integer
1581
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].to_port #=> Integer
1582
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
1583
+ # resp.container_group_definition.game_server_container_definition.resolved_image_digest #=> String
1584
+ # resp.container_group_definition.game_server_container_definition.server_sdk_version #=> String
1585
+ # resp.container_group_definition.support_container_definitions #=> Array
1586
+ # resp.container_group_definition.support_container_definitions[0].container_name #=> String
1587
+ # resp.container_group_definition.support_container_definitions[0].depends_on #=> Array
1588
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].container_name #=> String
1589
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
1590
+ # resp.container_group_definition.support_container_definitions[0].mount_points #=> Array
1591
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].instance_path #=> String
1592
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].container_path #=> String
1593
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
1594
+ # resp.container_group_definition.support_container_definitions[0].environment_override #=> Array
1595
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].name #=> String
1596
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].value #=> String
1597
+ # resp.container_group_definition.support_container_definitions[0].essential #=> Boolean
1598
+ # resp.container_group_definition.support_container_definitions[0].health_check.command #=> Array
1599
+ # resp.container_group_definition.support_container_definitions[0].health_check.command[0] #=> String
1600
+ # resp.container_group_definition.support_container_definitions[0].health_check.interval #=> Integer
1601
+ # resp.container_group_definition.support_container_definitions[0].health_check.retries #=> Integer
1602
+ # resp.container_group_definition.support_container_definitions[0].health_check.start_period #=> Integer
1603
+ # resp.container_group_definition.support_container_definitions[0].health_check.timeout #=> Integer
1604
+ # resp.container_group_definition.support_container_definitions[0].image_uri #=> String
1605
+ # resp.container_group_definition.support_container_definitions[0].memory_hard_limit_mebibytes #=> Integer
1606
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges #=> Array
1607
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
1608
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
1609
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
1610
+ # resp.container_group_definition.support_container_definitions[0].resolved_image_digest #=> String
1611
+ # resp.container_group_definition.support_container_definitions[0].vcpu #=> Float
1612
+ # resp.container_group_definition.version_number #=> Integer
1613
+ # resp.container_group_definition.version_description #=> String
1120
1614
  # resp.container_group_definition.status #=> String, one of "READY", "COPYING", "FAILED"
1121
1615
  # resp.container_group_definition.status_reason #=> String
1122
1616
  #
@@ -1129,9 +1623,6 @@ module Aws::GameLift
1129
1623
  req.send_request(options)
1130
1624
  end
1131
1625
 
1132
- # **This operation has been expanded to use with the Amazon GameLift
1133
- # containers feature, which is currently in public preview.**
1134
- #
1135
1626
  # Creates a fleet of compute resources to host your game servers. Use
1136
1627
  # this operation to set up the following types of fleets based on
1137
1628
  # compute type:
@@ -1173,40 +1664,6 @@ module Aws::GameLift
1173
1664
  # When the fleet status is ACTIVE, you can adjust capacity settings and
1174
1665
  # turn autoscaling on/off for each location.
1175
1666
  #
1176
- # **Managed container fleet**
1177
- #
1178
- # A container fleet is a set of Amazon Elastic Compute Cloud (Amazon
1179
- # EC2) instances. Your container architecture is deployed to each fleet
1180
- # instance based on the fleet configuration. Amazon GameLift manages the
1181
- # containers on each fleet instance and controls the lifecycle of game
1182
- # server processes, which host game sessions for players. Container
1183
- # fleets can have instances in multiple locations. Each container on an
1184
- # instance that runs game server processes is registered as a `Compute`.
1185
- #
1186
- # To create a container fleet, provide these required parameters:
1187
- #
1188
- # * `ComputeType` set to `CONTAINER`
1189
- #
1190
- # * `ContainerGroupsConfiguration`
1191
- #
1192
- # * `EC2InboundPermissions`
1193
- #
1194
- # * `EC2InstanceType`
1195
- #
1196
- # * `FleetType` set to `ON_DEMAND`
1197
- #
1198
- # * `Name`
1199
- #
1200
- # * `RuntimeConfiguration` with at least one `ServerProcesses`
1201
- # configuration
1202
- #
1203
- # If successful, this operation creates a new fleet resource and places
1204
- # it in `NEW` status while Amazon GameLift initiates the [fleet creation
1205
- # workflow][1].
1206
- #
1207
- # When the fleet status is ACTIVE, you can adjust capacity settings and
1208
- # turn autoscaling on/off for each location.
1209
- #
1210
1667
  # **Anywhere fleet**
1211
1668
  #
1212
1669
  # An Anywhere fleet represents compute resources that are not owned or
@@ -1230,9 +1687,7 @@ module Aws::GameLift
1230
1687
  #
1231
1688
  # [Setting up fleets][2]
1232
1689
  #
1233
- # [Setting up a container fleet][3]
1234
- #
1235
- # [Debug fleet creation issues][4]
1690
+ # [Debug fleet creation issues][3]
1236
1691
  #
1237
1692
  # [Multi-location fleets][2]
1238
1693
  #
@@ -1240,8 +1695,7 @@ module Aws::GameLift
1240
1695
  #
1241
1696
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-all.html#fleets-creation-workflow
1242
1697
  # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html
1243
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-build-fleet.html
1244
- # [4]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html#fleets-creating-debug-creation
1698
+ # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html#fleets-creating-debug-creation
1245
1699
  #
1246
1700
  # @option params [required, String] :name
1247
1701
  # A descriptive label that is associated with a fleet. Fleet names do
@@ -1287,8 +1741,8 @@ module Aws::GameLift
1287
1741
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-api.html#gamelift-sdk-server-initialize
1288
1742
  #
1289
1743
  # @option params [String] :ec2_instance_type
1290
- # The Amazon GameLift-supported Amazon EC2 instance type to use with EC2
1291
- # and container fleets. Instance type determines the computing resources
1744
+ # The Amazon GameLift-supported Amazon EC2 instance type to use with
1745
+ # managed EC2 fleets. Instance type determines the computing resources
1292
1746
  # that will be used to host your game servers, including CPU, memory,
1293
1747
  # storage, and networking capacity. See [Amazon Elastic Compute Cloud
1294
1748
  # Instance Types][1] for detailed descriptions of Amazon EC2 instance
@@ -1301,19 +1755,14 @@ module Aws::GameLift
1301
1755
  # @option params [Array<Types::IpPermission>] :ec2_inbound_permissions
1302
1756
  # The IP address ranges and port settings that allow inbound traffic to
1303
1757
  # access game server processes and other processes on this fleet. Set
1304
- # this parameter for EC2 and container fleets. You can leave this
1305
- # parameter empty when creating the fleet, but you must call
1758
+ # this parameter for managed EC2 fleets. You can leave this parameter
1759
+ # empty when creating the fleet, but you must call
1306
1760
  # UpdateFleetPortSettings to set it before players can connect to game
1307
1761
  # sessions. As a best practice, we recommend opening ports for remote
1308
1762
  # access only when you need them and closing them when you're finished.
1309
1763
  # For Realtime Servers fleets, Amazon GameLift automatically sets TCP
1310
1764
  # and UDP ranges.
1311
1765
  #
1312
- # To manage inbound access for a container fleet, set this parameter to
1313
- # the same port numbers that you set for the fleet's connection port
1314
- # range. During the life of the fleet, update this parameter to control
1315
- # which connection ports are open to inbound traffic.
1316
- #
1317
1766
  # @option params [String] :new_game_session_protection_policy
1318
1767
  # The status of termination protection for active game sessions on the
1319
1768
  # fleet. By default, this property is set to `NoProtection`. You can
@@ -1329,10 +1778,10 @@ module Aws::GameLift
1329
1778
  #
1330
1779
  # @option params [Types::RuntimeConfiguration] :runtime_configuration
1331
1780
  # Instructions for how to launch and run server processes on the fleet.
1332
- # Set runtime configuration for EC2 fleets and container fleets. For an
1333
- # Anywhere fleets, set this parameter only if the fleet is running the
1334
- # Amazon GameLift Agent. The runtime configuration defines one or more
1335
- # server process configurations. Each server process identifies a game
1781
+ # Set runtime configuration for managed EC2 fleets. For an Anywhere
1782
+ # fleets, set this parameter only if the fleet is running the Amazon
1783
+ # GameLift Agent. The runtime configuration defines one or more server
1784
+ # process configurations. Each server process identifies a game
1336
1785
  # executable or Realtime script file and the number of processes to run
1337
1786
  # concurrently.
1338
1787
  #
@@ -1383,19 +1832,20 @@ module Aws::GameLift
1383
1832
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-ec2-instances.html#gamelift-ec2-instances-spot
1384
1833
  #
1385
1834
  # @option params [String] :instance_role_arn
1386
- # A unique identifier for an IAM role with access permissions to other
1387
- # Amazon Web Services services. Any application that runs on an instance
1388
- # in the fleet--including install scripts, server processes, and other
1389
- # processes--can use these permissions to interact with Amazon Web
1390
- # Services resources that you own or have access to. For more
1391
- # information about using the role with your game server builds, see [
1392
- # Communicate with other Amazon Web Services resources from your
1393
- # fleets][1]. This fleet property can't be changed after the fleet is
1394
- # created.
1835
+ # A unique identifier for an IAM role that manages access to your Amazon
1836
+ # Web Services services. With an instance role ARN set, any application
1837
+ # that runs on an instance in this fleet can assume the role, including
1838
+ # install scripts, server processes, and daemons (background processes).
1839
+ # Create a role or look up a role's ARN by using the [IAM dashboard][1]
1840
+ # in the Amazon Web Services Management Console. Learn more about using
1841
+ # on-box credentials for your game servers at [ Access external
1842
+ # resources from a game server][2]. This fleet property can't be
1843
+ # changed after the fleet is created.
1395
1844
  #
1396
1845
  #
1397
1846
  #
1398
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
1847
+ # [1]: https://console.aws.amazon.com/iam/
1848
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
1399
1849
  #
1400
1850
  # @option params [Types::CertificateConfiguration] :certificate_configuration
1401
1851
  # Prompts Amazon GameLift to generate a TLS/SSL certificate for the
@@ -1455,15 +1905,10 @@ module Aws::GameLift
1455
1905
  # * `EC2` – The game server build is deployed to Amazon EC2 instances
1456
1906
  # for cloud hosting. This is the default setting.
1457
1907
  #
1458
- # * `CONTAINER` – Container images with your game server build and
1459
- # supporting software are deployed to Amazon EC2 instances for cloud
1460
- # hosting. With this compute type, you must specify the
1461
- # `ContainerGroupsConfiguration` parameter.
1462
- #
1463
- # * `ANYWHERE` – Game servers or container images with your game server
1464
- # and supporting software are deployed to compute resources that are
1465
- # provided and managed by you. With this compute type, you can also
1466
- # set the `AnywhereConfiguration` parameter.
1908
+ # * `ANYWHERE` – Your game server and supporting software is deployed to
1909
+ # compute resources that are provided and managed by you. With this
1910
+ # compute type, you can also set the `AnywhereConfiguration`
1911
+ # parameter.
1467
1912
  #
1468
1913
  # @option params [Types::AnywhereConfiguration] :anywhere_configuration
1469
1914
  # Amazon GameLift Anywhere configuration options.
@@ -1482,14 +1927,6 @@ module Aws::GameLift
1482
1927
  #
1483
1928
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
1484
1929
  #
1485
- # @option params [Types::ContainerGroupsConfiguration] :container_groups_configuration
1486
- # The container groups to deploy to instances in the container fleet and
1487
- # other fleet-level configuration settings. Use the
1488
- # CreateContainerGroupDefinition action to create container groups. A
1489
- # container fleet must have exactly one replica container group, and can
1490
- # optionally have one daemon container group. You can't change this
1491
- # property after you create the fleet.
1492
- #
1493
1930
  # @return [Types::CreateFleetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1494
1931
  #
1495
1932
  # * {Types::CreateFleetOutput#fleet_attributes #fleet_attributes} => Types::FleetAttributes
@@ -1549,19 +1986,11 @@ module Aws::GameLift
1549
1986
  # value: "TagValue", # required
1550
1987
  # },
1551
1988
  # ],
1552
- # compute_type: "EC2", # accepts EC2, ANYWHERE, CONTAINER
1989
+ # compute_type: "EC2", # accepts EC2, ANYWHERE
1553
1990
  # anywhere_configuration: {
1554
1991
  # cost: "NonNegativeLimitedLengthDouble", # required
1555
1992
  # },
1556
1993
  # instance_role_credentials_provider: "SHARED_CREDENTIAL_FILE", # accepts SHARED_CREDENTIAL_FILE
1557
- # container_groups_configuration: {
1558
- # container_group_definition_names: ["ContainerGroupDefinitionNameOrArn"], # required
1559
- # connection_port_range: { # required
1560
- # from_port: 1, # required
1561
- # to_port: 1, # required
1562
- # },
1563
- # desired_replica_container_groups_per_instance: 1,
1564
- # },
1565
1994
  # })
1566
1995
  #
1567
1996
  # @example Response structure
@@ -1593,16 +2022,9 @@ module Aws::GameLift
1593
2022
  # resp.fleet_attributes.stopped_actions[0] #=> String, one of "AUTO_SCALING"
1594
2023
  # resp.fleet_attributes.instance_role_arn #=> String
1595
2024
  # resp.fleet_attributes.certificate_configuration.certificate_type #=> String, one of "DISABLED", "GENERATED"
1596
- # resp.fleet_attributes.compute_type #=> String, one of "EC2", "ANYWHERE", "CONTAINER"
2025
+ # resp.fleet_attributes.compute_type #=> String, one of "EC2", "ANYWHERE"
1597
2026
  # resp.fleet_attributes.anywhere_configuration.cost #=> String
1598
2027
  # resp.fleet_attributes.instance_role_credentials_provider #=> String, one of "SHARED_CREDENTIAL_FILE"
1599
- # resp.fleet_attributes.container_groups_attributes.container_group_definition_properties #=> Array
1600
- # resp.fleet_attributes.container_groups_attributes.container_group_definition_properties[0].scheduling_strategy #=> String, one of "REPLICA", "DAEMON"
1601
- # resp.fleet_attributes.container_groups_attributes.container_group_definition_properties[0].container_group_definition_name #=> String
1602
- # resp.fleet_attributes.container_groups_attributes.connection_port_range.from_port #=> Integer
1603
- # resp.fleet_attributes.container_groups_attributes.connection_port_range.to_port #=> Integer
1604
- # resp.fleet_attributes.container_groups_attributes.container_groups_per_instance.desired_replica_container_groups_per_instance #=> Integer
1605
- # resp.fleet_attributes.container_groups_attributes.container_groups_per_instance.max_replica_container_groups_per_instance #=> Integer
1606
2028
  # resp.location_states #=> Array
1607
2029
  # resp.location_states[0].location #=> String
1608
2030
  # resp.location_states[0].status #=> String, one of "NEW", "DOWNLOADING", "VALIDATING", "BUILDING", "ACTIVATING", "ACTIVE", "DELETING", "ERROR", "TERMINATED", "NOT_FOUND"
@@ -1616,13 +2038,10 @@ module Aws::GameLift
1616
2038
  req.send_request(options)
1617
2039
  end
1618
2040
 
1619
- # **This operation has been expanded to use with the Amazon GameLift
1620
- # containers feature, which is currently in public preview.**
1621
- #
1622
- # Adds remote locations to an EC2 or container fleet and begins
1623
- # populating the new locations with instances. The new instances conform
1624
- # to the fleet's instance type, auto-scaling, and other configuration
1625
- # settings.
2041
+ # Adds remote locations to a managed EC2 fleet or managed container
2042
+ # fleet and begins populating the new locations with instances. The new
2043
+ # instances conform to the fleet's instance type, auto-scaling, and
2044
+ # other configuration settings.
1626
2045
  #
1627
2046
  # <note markdown="1"> You can't add remote locations to a fleet that resides in an Amazon
1628
2047
  # Web Services Region that doesn't support multiple locations. Fleets
@@ -2062,7 +2481,8 @@ module Aws::GameLift
2062
2481
  # @option params [String] :game_session_data
2063
2482
  # A set of custom game session properties, formatted as a single string
2064
2483
  # value. This data is passed to a game server process with a request to
2065
- # start a new game session (see [Start a Game Session][1]).
2484
+ # start a new game session. For more information, see [Start a game
2485
+ # session][1].
2066
2486
  #
2067
2487
  #
2068
2488
  #
@@ -2197,17 +2617,14 @@ module Aws::GameLift
2197
2617
  # @option params [Integer] :timeout_in_seconds
2198
2618
  # The maximum time, in seconds, that a new game session placement
2199
2619
  # request remains in the queue. When a request exceeds this time, the
2200
- # game session placement changes to a `TIMED_OUT` status. By default,
2201
- # this property is set to `600`.
2620
+ # game session placement changes to a `TIMED_OUT` status.
2202
2621
  #
2203
2622
  # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
2204
- # A set of policies that act as a sliding cap on player latency. FleetIQ
2205
- # works to deliver low latency for most players in a game session. These
2206
- # policies ensure that no individual player can be placed into a game
2207
- # with unreasonably high latency. Use multiple policies to gradually
2208
- # relax latency requirements a step at a time. Multiple policies are
2209
- # applied based on their maximum allowed latency, starting with the
2210
- # lowest value.
2623
+ # A set of policies that enforce a sliding cap on player latency when
2624
+ # processing game sessions placement requests. Use multiple policies to
2625
+ # gradually relax the cap over time if Amazon GameLift can't make a
2626
+ # placement. Policies are evaluated in order starting with the lowest
2627
+ # maximum latency value.
2211
2628
  #
2212
2629
  # @option params [Array<Types::GameSessionQueueDestination>] :destinations
2213
2630
  # A list of fleets and/or fleet aliases that can be used to fulfill game
@@ -2454,10 +2871,9 @@ module Aws::GameLift
2454
2871
  # @option params [Integer] :additional_player_count
2455
2872
  # The number of player slots in a match to keep open for future players.
2456
2873
  # For example, if the configuration's rule set specifies a match for a
2457
- # single 10-person team, and the additional player count is set to 2, 10
2458
- # players will be selected for the match and 2 more player slots will be
2459
- # open for future players. This parameter is not used if `FlexMatchMode`
2460
- # is set to `STANDALONE`.
2874
+ # single 12-person team, and the additional player count is set to 2,
2875
+ # only 10 players are selected for the match. This parameter is not used
2876
+ # if `FlexMatchMode` is set to `STANDALONE`.
2461
2877
  #
2462
2878
  # @option params [String] :custom_event_data
2463
2879
  # Information to be added to all events related to this matchmaking
@@ -2473,10 +2889,10 @@ module Aws::GameLift
2473
2889
  # @option params [String] :game_session_data
2474
2890
  # A set of custom game session properties, formatted as a single string
2475
2891
  # value. This data is passed to a game server process with a request to
2476
- # start a new game session (see [Start a Game Session][1]). This
2477
- # information is added to the new `GameSession` object that is created
2478
- # for a successful match. This parameter is not used if `FlexMatchMode`
2479
- # is set to `STANDALONE`.
2892
+ # start a new game session. For more information, see [Start a game
2893
+ # session][1]. This information is added to the new `GameSession` object
2894
+ # that is created for a successful match. This parameter is not used if
2895
+ # `FlexMatchMode` is set to `STANDALONE`.
2480
2896
  #
2481
2897
  #
2482
2898
  #
@@ -2829,16 +3245,16 @@ module Aws::GameLift
2829
3245
  req.send_request(options)
2830
3246
  end
2831
3247
 
2832
- # Creates a new script record for your Realtime Servers script. Realtime
2833
- # scripts are JavaScript that provide configuration settings and
2834
- # optional custom game logic for your game. The script is deployed when
2835
- # you create a Realtime Servers fleet to host your game sessions. Script
2836
- # logic is executed during an active game session.
3248
+ # Creates a script resource for your Realtime Servers script. Realtime
3249
+ # scripts are JavaScript files that provide configuration settings and
3250
+ # optional custom game logic for your game. Script logic is executed
3251
+ # during an active game session. To deploy Realtime Servers for hosting,
3252
+ # create an Amazon GameLift managed fleet with the script.
2837
3253
  #
2838
- # To create a new script record, specify a script name and provide the
2839
- # script file(s). The script files and all dependencies must be zipped
2840
- # into a single file. You can pull the zip file from either of these
2841
- # locations:
3254
+ # To create a script resource, specify a script name and provide the
3255
+ # script file(s). The script files and all dependencies must be combined
3256
+ # into a single .zip file. You can upload the .zip file from either of
3257
+ # these locations:
2842
3258
  #
2843
3259
  # * A locally available directory. Use the *ZipFile* parameter for this
2844
3260
  # option.
@@ -2849,12 +3265,9 @@ module Aws::GameLift
2849
3265
  # (IAM) role that allows the Amazon GameLift service to access your S3
2850
3266
  # bucket.
2851
3267
  #
2852
- # If the call is successful, a new script record is created with a
2853
- # unique script ID. If the script file is provided as a local file, the
2854
- # file is uploaded to an Amazon GameLift-owned S3 bucket and the script
2855
- # record's storage location reflects this location. If the script file
2856
- # is provided as an S3 bucket, Amazon GameLift accesses the file at this
2857
- # storage location as needed for deployment.
3268
+ # If the call is successful, Amazon GameLift creates a new script
3269
+ # resource with a unique script ID. The script is uploaded to an Amazon
3270
+ # S3 bucket that is owned by Amazon GameLift.
2858
3271
  #
2859
3272
  # **Learn more**
2860
3273
  #
@@ -2873,8 +3286,8 @@ module Aws::GameLift
2873
3286
  # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-awssdk.html#reference-awssdk-resources-fleets
2874
3287
  #
2875
3288
  # @option params [String] :name
2876
- # A descriptive label that is associated with a script. Script names
2877
- # don't need to be unique. You can use [UpdateScript][1] to change this
3289
+ # A descriptive label that is associated with a script. Script names do
3290
+ # not need to be unique. You can use [UpdateScript][1] to change this
2878
3291
  # value later.
2879
3292
  #
2880
3293
  #
@@ -2882,9 +3295,9 @@ module Aws::GameLift
2882
3295
  # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateScript.html
2883
3296
  #
2884
3297
  # @option params [String] :version
2885
- # Version information associated with a build or script. Version strings
2886
- # don't need to be unique. You can use [UpdateScript][1] to change this
2887
- # value later.
3298
+ # Version information that is associated with a build or script. Version
3299
+ # strings do not need to be unique. You can use [UpdateScript][1] to
3300
+ # change this value later.
2888
3301
  #
2889
3302
  #
2890
3303
  #
@@ -3215,15 +3628,60 @@ module Aws::GameLift
3215
3628
  req.send_request(options)
3216
3629
  end
3217
3630
 
3218
- # <b>This operation is used with the Amazon GameLift containers feature,
3219
- # which is currently in public preview. </b>
3631
+ # Deletes all resources and information related to a container fleet and
3632
+ # shuts down currently running fleet instances, including those in
3633
+ # remote locations. The container fleet must be in `ACTIVE` status to be
3634
+ # deleted.
3635
+ #
3636
+ # To delete a fleet, specify the fleet ID to be terminated. During the
3637
+ # deletion process, the fleet status is changed to `DELETING`.
3638
+ #
3639
+ # **Learn more**
3640
+ #
3641
+ # [Setting up Amazon GameLift Fleets][1]
3642
+ #
3643
+ #
3644
+ #
3645
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-intro.html
3646
+ #
3647
+ # @option params [required, String] :fleet_id
3648
+ # A unique identifier for the container fleet to delete. You can use
3649
+ # either the fleet ID or ARN value.
3650
+ #
3651
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3652
+ #
3653
+ # @example Request syntax with placeholder values
3654
+ #
3655
+ # resp = client.delete_container_fleet({
3656
+ # fleet_id: "FleetIdOrArn", # required
3657
+ # })
3658
+ #
3659
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteContainerFleet AWS API Documentation
3660
+ #
3661
+ # @overload delete_container_fleet(params = {})
3662
+ # @param [Hash] params ({})
3663
+ def delete_container_fleet(params = {}, options = {})
3664
+ req = build_request(:delete_container_fleet, params)
3665
+ req.send_request(options)
3666
+ end
3667
+
3668
+ # Deletes a container group definition. You can delete a container group
3669
+ # definition if there are no fleets using the definition.
3670
+ #
3671
+ # **Request options:**
3220
3672
  #
3221
- # Deletes a container group definition resource. You can delete a
3222
- # container group definition if there are no fleets using the
3223
- # definition.
3673
+ # * Delete an entire container group definition, including all versions.
3674
+ # Specify the container group definition name, or use an ARN value
3675
+ # without the version number.
3224
3676
  #
3225
- # To delete a container group definition, identify the resource to
3226
- # delete.
3677
+ # * Delete a particular version. Specify the container group definition
3678
+ # name and a version number, or use an ARN value that includes the
3679
+ # version number.
3680
+ #
3681
+ # * Keep the newest versions and delete all older versions. Specify the
3682
+ # container group definition name and the number of versions to
3683
+ # retain. For example, set `VersionCountToRetain` to 5 to delete all
3684
+ # but the five most recent versions.
3227
3685
  #
3228
3686
  # **Learn more**
3229
3687
  #
@@ -3239,12 +3697,21 @@ module Aws::GameLift
3239
3697
  # The unique identifier for the container group definition to delete.
3240
3698
  # You can use either the `Name` or `ARN` value.
3241
3699
  #
3700
+ # @option params [Integer] :version_number
3701
+ # The specific version to delete.
3702
+ #
3703
+ # @option params [Integer] :version_count_to_retain
3704
+ # The number of most recent versions to keep while deleting all older
3705
+ # versions.
3706
+ #
3242
3707
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3243
3708
  #
3244
3709
  # @example Request syntax with placeholder values
3245
3710
  #
3246
3711
  # resp = client.delete_container_group_definition({
3247
3712
  # name: "ContainerGroupDefinitionNameOrArn", # required
3713
+ # version_number: 1,
3714
+ # version_count_to_retain: 1,
3248
3715
  # })
3249
3716
  #
3250
3717
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteContainerGroupDefinition AWS API Documentation
@@ -3748,17 +4215,14 @@ module Aws::GameLift
3748
4215
  req.send_request(options)
3749
4216
  end
3750
4217
 
3751
- # **This operation has been expanded to use with the Amazon GameLift
3752
- # containers feature, which is currently in public preview.**
3753
- #
3754
- # Removes a compute resource from an Amazon GameLift Anywhere fleet or
3755
- # container fleet. Deregistered computes can no longer host game
3756
- # sessions through Amazon GameLift.
4218
+ # Removes a compute resource from an Amazon GameLift Anywhere fleet.
4219
+ # Deregistered computes can no longer host game sessions through Amazon
4220
+ # GameLift.
3757
4221
  #
3758
- # For an Anywhere fleet or a container fleet that's running the Amazon
3759
- # GameLift Agent, the Agent handles all compute registry tasks for you.
3760
- # For an Anywhere fleet that doesn't use the Agent, call this operation
3761
- # to deregister fleet computes.
4222
+ # For an Anywhere fleet that's running the Amazon GameLift Agent, the
4223
+ # Agent handles all compute registry tasks for you. For an Anywhere
4224
+ # fleet that doesn't use the Agent, call this operation to deregister
4225
+ # fleet computes.
3762
4226
  #
3763
4227
  # To deregister a compute, call this operation from the compute that's
3764
4228
  # being deregistered and specify the compute name and the fleet ID.
@@ -3769,10 +4233,7 @@ module Aws::GameLift
3769
4233
  #
3770
4234
  # @option params [required, String] :compute_name
3771
4235
  # The unique identifier of the compute resource to deregister. For an
3772
- # Anywhere fleet compute, use the registered compute name. For a
3773
- # container fleet, use the compute name (for example,
3774
- # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
3775
- # or the compute ARN.
4236
+ # Anywhere fleet compute, use the registered compute name.
3776
4237
  #
3777
4238
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3778
4239
  #
@@ -3937,9 +4398,6 @@ module Aws::GameLift
3937
4398
  req.send_request(options)
3938
4399
  end
3939
4400
 
3940
- # **This operation has been expanded to use with the Amazon GameLift
3941
- # containers feature, which is currently in public preview.**
3942
- #
3943
4401
  # Retrieves properties for a compute resource in an Amazon GameLift
3944
4402
  # fleet. To get a list of all computes in a fleet, call ListCompute.
3945
4403
  #
@@ -3950,16 +4408,12 @@ module Aws::GameLift
3950
4408
  # compute resource. Depending on the fleet's compute type, the result
3951
4409
  # includes the following information:
3952
4410
  #
3953
- # * For `EC2` fleets, this operation returns information about the EC2
3954
- # instance.
4411
+ # * For managed EC2 fleets, this operation returns information about the
4412
+ # EC2 instance.
3955
4413
  #
3956
- # * For `ANYWHERE` fleets, this operation returns information about the
4414
+ # * For Anywhere fleets, this operation returns information about the
3957
4415
  # registered compute.
3958
4416
  #
3959
- # * For `CONTAINER` fleets, this operation returns information about the
3960
- # container that's registered as a compute, and the instance it's
3961
- # running on. The compute name is the container name.
3962
- #
3963
4417
  # @option params [required, String] :fleet_id
3964
4418
  # A unique identifier for the fleet that the compute belongs to. You can
3965
4419
  # use either the fleet ID or ARN value.
@@ -3967,10 +4421,7 @@ module Aws::GameLift
3967
4421
  # @option params [required, String] :compute_name
3968
4422
  # The unique identifier of the compute resource to retrieve properties
3969
4423
  # for. For an Anywhere fleet compute, use the registered compute name.
3970
- # For an EC2 fleet instance, use the instance ID. For a container fleet,
3971
- # use the compute name (for example,
3972
- # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
3973
- # or the compute ARN.
4424
+ # For an EC2 fleet instance, use the instance ID.
3974
4425
  #
3975
4426
  # @return [Types::DescribeComputeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3976
4427
  #
@@ -3991,7 +4442,7 @@ module Aws::GameLift
3991
4442
  # resp.compute.compute_arn #=> String
3992
4443
  # resp.compute.ip_address #=> String
3993
4444
  # resp.compute.dns_name #=> String
3994
- # resp.compute.compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING"
4445
+ # resp.compute.compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING", "IMPAIRED"
3995
4446
  # resp.compute.location #=> String
3996
4447
  # resp.compute.creation_time #=> Time
3997
4448
  # resp.compute.operating_system #=> String, one of "WINDOWS_2012", "AMAZON_LINUX", "AMAZON_LINUX_2", "WINDOWS_2016", "AMAZON_LINUX_2023"
@@ -3999,10 +4450,10 @@ module Aws::GameLift
3999
4450
  # resp.compute.game_lift_service_sdk_endpoint #=> String
4000
4451
  # resp.compute.game_lift_agent_endpoint #=> String
4001
4452
  # resp.compute.instance_id #=> String
4002
- # resp.compute.container_attributes.container_port_mappings #=> Array
4003
- # resp.compute.container_attributes.container_port_mappings[0].container_port #=> Integer
4004
- # resp.compute.container_attributes.container_port_mappings[0].connection_port #=> Integer
4005
- # resp.compute.container_attributes.container_port_mappings[0].protocol #=> String, one of "TCP", "UDP"
4453
+ # resp.compute.container_attributes #=> Array
4454
+ # resp.compute.container_attributes[0].container_name #=> String
4455
+ # resp.compute.container_attributes[0].container_runtime_id #=> String
4456
+ # resp.compute.game_server_container_group_definition_arn #=> String
4006
4457
  #
4007
4458
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeCompute AWS API Documentation
4008
4459
  #
@@ -4013,15 +4464,105 @@ module Aws::GameLift
4013
4464
  req.send_request(options)
4014
4465
  end
4015
4466
 
4016
- # <b>This operation is used with the Amazon GameLift containers feature,
4017
- # which is currently in public preview. </b>
4467
+ # Retrieves the properties for a container fleet. When requesting
4468
+ # attributes for multiple fleets, use the pagination parameters to
4469
+ # retrieve results as a set of sequential pages.
4018
4470
  #
4471
+ # **Request options**
4472
+ #
4473
+ # * Get container fleet properties for a single fleet. Provide either
4474
+ # the fleet ID or ARN value.
4475
+ #
4476
+ # ^
4477
+ #
4478
+ # **Results**
4479
+ #
4480
+ # If successful, a `ContainerFleet` object is returned. This object
4481
+ # includes the fleet properties, including information about the most
4482
+ # recent deployment.
4483
+ #
4484
+ # <note markdown="1"> Some API operations limit the number of fleet IDs that allowed in one
4485
+ # request. If a request exceeds this limit, the request fails and the
4486
+ # error message contains the maximum allowed number.
4487
+ #
4488
+ # </note>
4489
+ #
4490
+ # @option params [required, String] :fleet_id
4491
+ # A unique identifier for the container fleet to retrieve. You can use
4492
+ # either the fleet ID or ARN value.
4493
+ #
4494
+ # @return [Types::DescribeContainerFleetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4495
+ #
4496
+ # * {Types::DescribeContainerFleetOutput#container_fleet #container_fleet} => Types::ContainerFleet
4497
+ #
4498
+ # @example Request syntax with placeholder values
4499
+ #
4500
+ # resp = client.describe_container_fleet({
4501
+ # fleet_id: "FleetIdOrArn", # required
4502
+ # })
4503
+ #
4504
+ # @example Response structure
4505
+ #
4506
+ # resp.container_fleet.fleet_id #=> String
4507
+ # resp.container_fleet.fleet_arn #=> String
4508
+ # resp.container_fleet.fleet_role_arn #=> String
4509
+ # resp.container_fleet.game_server_container_group_definition_name #=> String
4510
+ # resp.container_fleet.game_server_container_group_definition_arn #=> String
4511
+ # resp.container_fleet.per_instance_container_group_definition_name #=> String
4512
+ # resp.container_fleet.per_instance_container_group_definition_arn #=> String
4513
+ # resp.container_fleet.instance_connection_port_range.from_port #=> Integer
4514
+ # resp.container_fleet.instance_connection_port_range.to_port #=> Integer
4515
+ # resp.container_fleet.instance_inbound_permissions #=> Array
4516
+ # resp.container_fleet.instance_inbound_permissions[0].from_port #=> Integer
4517
+ # resp.container_fleet.instance_inbound_permissions[0].to_port #=> Integer
4518
+ # resp.container_fleet.instance_inbound_permissions[0].ip_range #=> String
4519
+ # resp.container_fleet.instance_inbound_permissions[0].protocol #=> String, one of "TCP", "UDP"
4520
+ # resp.container_fleet.game_server_container_groups_per_instance #=> Integer
4521
+ # resp.container_fleet.maximum_game_server_container_groups_per_instance #=> Integer
4522
+ # resp.container_fleet.instance_type #=> String
4523
+ # resp.container_fleet.billing_type #=> String, one of "ON_DEMAND", "SPOT"
4524
+ # resp.container_fleet.description #=> String
4525
+ # resp.container_fleet.creation_time #=> Time
4526
+ # resp.container_fleet.metric_groups #=> Array
4527
+ # resp.container_fleet.metric_groups[0] #=> String
4528
+ # resp.container_fleet.new_game_session_protection_policy #=> String, one of "NoProtection", "FullProtection"
4529
+ # resp.container_fleet.game_session_creation_limit_policy.new_game_sessions_per_creator #=> Integer
4530
+ # resp.container_fleet.game_session_creation_limit_policy.policy_period_in_minutes #=> Integer
4531
+ # resp.container_fleet.status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
4532
+ # resp.container_fleet.deployment_details.latest_deployment_id #=> String
4533
+ # resp.container_fleet.log_configuration.log_destination #=> String, one of "NONE", "CLOUDWATCH", "S3"
4534
+ # resp.container_fleet.log_configuration.s3_bucket_name #=> String
4535
+ # resp.container_fleet.log_configuration.log_group_arn #=> String
4536
+ # resp.container_fleet.location_attributes #=> Array
4537
+ # resp.container_fleet.location_attributes[0].location #=> String
4538
+ # resp.container_fleet.location_attributes[0].status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
4539
+ #
4540
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeContainerFleet AWS API Documentation
4541
+ #
4542
+ # @overload describe_container_fleet(params = {})
4543
+ # @param [Hash] params ({})
4544
+ def describe_container_fleet(params = {}, options = {})
4545
+ req = build_request(:describe_container_fleet, params)
4546
+ req.send_request(options)
4547
+ end
4548
+
4019
4549
  # Retrieves the properties of a container group definition, including
4020
4550
  # all container definitions in the group.
4021
4551
  #
4022
- # To retrieve a container group definition, provide a resource
4023
- # identifier. If successful, this operation returns the complete
4024
- # properties of the container group definition.
4552
+ # **Request options:**
4553
+ #
4554
+ # * Retrieve the latest version of a container group definition. Specify
4555
+ # the container group definition name only, or use an ARN value
4556
+ # without a version number.
4557
+ #
4558
+ # * Retrieve a particular version. Specify the container group
4559
+ # definition name and a version number, or use an ARN value that
4560
+ # includes the version number.
4561
+ #
4562
+ # **Results:**
4563
+ #
4564
+ # If successful, this operation returns the complete properties of a
4565
+ # container group definition version.
4025
4566
  #
4026
4567
  # **Learn more**
4027
4568
  #
@@ -4037,6 +4578,9 @@ module Aws::GameLift
4037
4578
  # The unique identifier for the container group definition to retrieve
4038
4579
  # properties for. You can use either the `Name` or `ARN` value.
4039
4580
  #
4581
+ # @option params [Integer] :version_number
4582
+ # The specific version to retrieve.
4583
+ #
4040
4584
  # @return [Types::DescribeContainerGroupDefinitionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4041
4585
  #
4042
4586
  # * {Types::DescribeContainerGroupDefinitionOutput#container_group_definition #container_group_definition} => Types::ContainerGroupDefinition
@@ -4045,6 +4589,7 @@ module Aws::GameLift
4045
4589
  #
4046
4590
  # resp = client.describe_container_group_definition({
4047
4591
  # name: "ContainerGroupDefinitionNameOrArn", # required
4592
+ # version_number: 1,
4048
4593
  # })
4049
4594
  #
4050
4595
  # @example Response structure
@@ -4053,38 +4598,56 @@ module Aws::GameLift
4053
4598
  # resp.container_group_definition.creation_time #=> Time
4054
4599
  # resp.container_group_definition.operating_system #=> String, one of "AMAZON_LINUX_2023"
4055
4600
  # resp.container_group_definition.name #=> String
4056
- # resp.container_group_definition.scheduling_strategy #=> String, one of "REPLICA", "DAEMON"
4057
- # resp.container_group_definition.total_memory_limit #=> Integer
4058
- # resp.container_group_definition.total_cpu_limit #=> Integer
4059
- # resp.container_group_definition.container_definitions #=> Array
4060
- # resp.container_group_definition.container_definitions[0].container_name #=> String
4061
- # resp.container_group_definition.container_definitions[0].image_uri #=> String
4062
- # resp.container_group_definition.container_definitions[0].resolved_image_digest #=> String
4063
- # resp.container_group_definition.container_definitions[0].memory_limits.soft_limit #=> Integer
4064
- # resp.container_group_definition.container_definitions[0].memory_limits.hard_limit #=> Integer
4065
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges #=> Array
4066
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
4067
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
4068
- # resp.container_group_definition.container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
4069
- # resp.container_group_definition.container_definitions[0].cpu #=> Integer
4070
- # resp.container_group_definition.container_definitions[0].health_check.command #=> Array
4071
- # resp.container_group_definition.container_definitions[0].health_check.command[0] #=> String
4072
- # resp.container_group_definition.container_definitions[0].health_check.interval #=> Integer
4073
- # resp.container_group_definition.container_definitions[0].health_check.timeout #=> Integer
4074
- # resp.container_group_definition.container_definitions[0].health_check.retries #=> Integer
4075
- # resp.container_group_definition.container_definitions[0].health_check.start_period #=> Integer
4076
- # resp.container_group_definition.container_definitions[0].command #=> Array
4077
- # resp.container_group_definition.container_definitions[0].command[0] #=> String
4078
- # resp.container_group_definition.container_definitions[0].essential #=> Boolean
4079
- # resp.container_group_definition.container_definitions[0].entry_point #=> Array
4080
- # resp.container_group_definition.container_definitions[0].entry_point[0] #=> String
4081
- # resp.container_group_definition.container_definitions[0].working_directory #=> String
4082
- # resp.container_group_definition.container_definitions[0].environment #=> Array
4083
- # resp.container_group_definition.container_definitions[0].environment[0].name #=> String
4084
- # resp.container_group_definition.container_definitions[0].environment[0].value #=> String
4085
- # resp.container_group_definition.container_definitions[0].depends_on #=> Array
4086
- # resp.container_group_definition.container_definitions[0].depends_on[0].container_name #=> String
4087
- # resp.container_group_definition.container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
4601
+ # resp.container_group_definition.container_group_type #=> String, one of "GAME_SERVER", "PER_INSTANCE"
4602
+ # resp.container_group_definition.total_memory_limit_mebibytes #=> Integer
4603
+ # resp.container_group_definition.total_vcpu_limit #=> Float
4604
+ # resp.container_group_definition.game_server_container_definition.container_name #=> String
4605
+ # resp.container_group_definition.game_server_container_definition.depends_on #=> Array
4606
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].container_name #=> String
4607
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
4608
+ # resp.container_group_definition.game_server_container_definition.mount_points #=> Array
4609
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].instance_path #=> String
4610
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].container_path #=> String
4611
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
4612
+ # resp.container_group_definition.game_server_container_definition.environment_override #=> Array
4613
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].name #=> String
4614
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].value #=> String
4615
+ # resp.container_group_definition.game_server_container_definition.image_uri #=> String
4616
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges #=> Array
4617
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].from_port #=> Integer
4618
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].to_port #=> Integer
4619
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
4620
+ # resp.container_group_definition.game_server_container_definition.resolved_image_digest #=> String
4621
+ # resp.container_group_definition.game_server_container_definition.server_sdk_version #=> String
4622
+ # resp.container_group_definition.support_container_definitions #=> Array
4623
+ # resp.container_group_definition.support_container_definitions[0].container_name #=> String
4624
+ # resp.container_group_definition.support_container_definitions[0].depends_on #=> Array
4625
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].container_name #=> String
4626
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
4627
+ # resp.container_group_definition.support_container_definitions[0].mount_points #=> Array
4628
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].instance_path #=> String
4629
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].container_path #=> String
4630
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
4631
+ # resp.container_group_definition.support_container_definitions[0].environment_override #=> Array
4632
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].name #=> String
4633
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].value #=> String
4634
+ # resp.container_group_definition.support_container_definitions[0].essential #=> Boolean
4635
+ # resp.container_group_definition.support_container_definitions[0].health_check.command #=> Array
4636
+ # resp.container_group_definition.support_container_definitions[0].health_check.command[0] #=> String
4637
+ # resp.container_group_definition.support_container_definitions[0].health_check.interval #=> Integer
4638
+ # resp.container_group_definition.support_container_definitions[0].health_check.retries #=> Integer
4639
+ # resp.container_group_definition.support_container_definitions[0].health_check.start_period #=> Integer
4640
+ # resp.container_group_definition.support_container_definitions[0].health_check.timeout #=> Integer
4641
+ # resp.container_group_definition.support_container_definitions[0].image_uri #=> String
4642
+ # resp.container_group_definition.support_container_definitions[0].memory_hard_limit_mebibytes #=> Integer
4643
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges #=> Array
4644
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
4645
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
4646
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
4647
+ # resp.container_group_definition.support_container_definitions[0].resolved_image_digest #=> String
4648
+ # resp.container_group_definition.support_container_definitions[0].vcpu #=> Float
4649
+ # resp.container_group_definition.version_number #=> Integer
4650
+ # resp.container_group_definition.version_description #=> String
4088
4651
  # resp.container_group_definition.status #=> String, one of "READY", "COPYING", "FAILED"
4089
4652
  # resp.container_group_definition.status_reason #=> String
4090
4653
  #
@@ -4195,9 +4758,6 @@ module Aws::GameLift
4195
4758
  req.send_request(options)
4196
4759
  end
4197
4760
 
4198
- # **This operation has been expanded to use with the Amazon GameLift
4199
- # containers feature, which is currently in public preview.**
4200
- #
4201
4761
  # Retrieves core fleet-wide properties for fleets in an Amazon Web
4202
4762
  # Services Region. Properties include the computing hardware and
4203
4763
  # deployment configuration for instances in the fleet.
@@ -4292,16 +4852,9 @@ module Aws::GameLift
4292
4852
  # resp.fleet_attributes[0].stopped_actions[0] #=> String, one of "AUTO_SCALING"
4293
4853
  # resp.fleet_attributes[0].instance_role_arn #=> String
4294
4854
  # resp.fleet_attributes[0].certificate_configuration.certificate_type #=> String, one of "DISABLED", "GENERATED"
4295
- # resp.fleet_attributes[0].compute_type #=> String, one of "EC2", "ANYWHERE", "CONTAINER"
4855
+ # resp.fleet_attributes[0].compute_type #=> String, one of "EC2", "ANYWHERE"
4296
4856
  # resp.fleet_attributes[0].anywhere_configuration.cost #=> String
4297
4857
  # resp.fleet_attributes[0].instance_role_credentials_provider #=> String, one of "SHARED_CREDENTIAL_FILE"
4298
- # resp.fleet_attributes[0].container_groups_attributes.container_group_definition_properties #=> Array
4299
- # resp.fleet_attributes[0].container_groups_attributes.container_group_definition_properties[0].scheduling_strategy #=> String, one of "REPLICA", "DAEMON"
4300
- # resp.fleet_attributes[0].container_groups_attributes.container_group_definition_properties[0].container_group_definition_name #=> String
4301
- # resp.fleet_attributes[0].container_groups_attributes.connection_port_range.from_port #=> Integer
4302
- # resp.fleet_attributes[0].container_groups_attributes.connection_port_range.to_port #=> Integer
4303
- # resp.fleet_attributes[0].container_groups_attributes.container_groups_per_instance.desired_replica_container_groups_per_instance #=> Integer
4304
- # resp.fleet_attributes[0].container_groups_attributes.container_groups_per_instance.max_replica_container_groups_per_instance #=> Integer
4305
4858
  # resp.next_token #=> String
4306
4859
  #
4307
4860
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetAttributes AWS API Documentation
@@ -4313,11 +4866,8 @@ module Aws::GameLift
4313
4866
  req.send_request(options)
4314
4867
  end
4315
4868
 
4316
- # **This operation has been expanded to use with the Amazon GameLift
4317
- # containers feature, which is currently in public preview.**
4318
- #
4319
4869
  # Retrieves the resource capacity settings for one or more fleets. For a
4320
- # container fleet, this operation also returns counts for replica
4870
+ # container fleet, this operation also returns counts for game server
4321
4871
  # container groups.
4322
4872
  #
4323
4873
  # With multi-location fleets, this operation retrieves data for the
@@ -4404,10 +4954,10 @@ module Aws::GameLift
4404
4954
  # resp.fleet_capacity[0].instance_counts.idle #=> Integer
4405
4955
  # resp.fleet_capacity[0].instance_counts.terminating #=> Integer
4406
4956
  # resp.fleet_capacity[0].location #=> String
4407
- # resp.fleet_capacity[0].replica_container_group_counts.pending #=> Integer
4408
- # resp.fleet_capacity[0].replica_container_group_counts.active #=> Integer
4409
- # resp.fleet_capacity[0].replica_container_group_counts.idle #=> Integer
4410
- # resp.fleet_capacity[0].replica_container_group_counts.terminating #=> Integer
4957
+ # resp.fleet_capacity[0].game_server_container_group_counts.pending #=> Integer
4958
+ # resp.fleet_capacity[0].game_server_container_group_counts.active #=> Integer
4959
+ # resp.fleet_capacity[0].game_server_container_group_counts.idle #=> Integer
4960
+ # resp.fleet_capacity[0].game_server_container_group_counts.terminating #=> Integer
4411
4961
  # resp.next_token #=> String
4412
4962
  #
4413
4963
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetCapacity AWS API Documentation
@@ -4419,6 +4969,64 @@ module Aws::GameLift
4419
4969
  req.send_request(options)
4420
4970
  end
4421
4971
 
4972
+ # Retrieves information about a managed container fleet deployment.
4973
+ #
4974
+ # **Request options**
4975
+ #
4976
+ # * Get information about the latest deployment for a specific fleet.
4977
+ # Provide the fleet ID or ARN.
4978
+ #
4979
+ # * Get information about a specific deployment. Provide the fleet ID or
4980
+ # ARN and the deployment ID.
4981
+ #
4982
+ # **Results**
4983
+ #
4984
+ # If successful, a `FleetDeployment` object is returned.
4985
+ #
4986
+ # @option params [required, String] :fleet_id
4987
+ # A unique identifier for the container fleet. You can use either the
4988
+ # fleet ID or ARN value.
4989
+ #
4990
+ # @option params [String] :deployment_id
4991
+ # A unique identifier for the deployment to return information for.
4992
+ #
4993
+ # @return [Types::DescribeFleetDeploymentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4994
+ #
4995
+ # * {Types::DescribeFleetDeploymentOutput#fleet_deployment #fleet_deployment} => Types::FleetDeployment
4996
+ # * {Types::DescribeFleetDeploymentOutput#locational_deployments #locational_deployments} => Hash&lt;String,Types::LocationalDeployment&gt;
4997
+ #
4998
+ # @example Request syntax with placeholder values
4999
+ #
5000
+ # resp = client.describe_fleet_deployment({
5001
+ # fleet_id: "FleetIdOrArn", # required
5002
+ # deployment_id: "DeploymentId",
5003
+ # })
5004
+ #
5005
+ # @example Response structure
5006
+ #
5007
+ # resp.fleet_deployment.deployment_id #=> String
5008
+ # resp.fleet_deployment.fleet_id #=> String
5009
+ # resp.fleet_deployment.game_server_binary_arn #=> String
5010
+ # resp.fleet_deployment.rollback_game_server_binary_arn #=> String
5011
+ # resp.fleet_deployment.per_instance_binary_arn #=> String
5012
+ # resp.fleet_deployment.rollback_per_instance_binary_arn #=> String
5013
+ # resp.fleet_deployment.deployment_status #=> String, one of "IN_PROGRESS", "IMPAIRED", "COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "CANCELLED", "PENDING"
5014
+ # resp.fleet_deployment.deployment_configuration.protection_strategy #=> String, one of "WITH_PROTECTION", "IGNORE_PROTECTION"
5015
+ # resp.fleet_deployment.deployment_configuration.minimum_healthy_percentage #=> Integer
5016
+ # resp.fleet_deployment.deployment_configuration.impairment_strategy #=> String, one of "MAINTAIN", "ROLLBACK"
5017
+ # resp.fleet_deployment.creation_time #=> Time
5018
+ # resp.locational_deployments #=> Hash
5019
+ # resp.locational_deployments["NonZeroAnd128MaxAsciiString"].deployment_status #=> String, one of "IN_PROGRESS", "IMPAIRED", "COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "CANCELLED", "PENDING"
5020
+ #
5021
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetDeployment AWS API Documentation
5022
+ #
5023
+ # @overload describe_fleet_deployment(params = {})
5024
+ # @param [Hash] params ({})
5025
+ def describe_fleet_deployment(params = {}, options = {})
5026
+ req = build_request(:describe_fleet_deployment, params)
5027
+ req.send_request(options)
5028
+ end
5029
+
4422
5030
  # Retrieves entries from a fleet's event log. Fleet events are
4423
5031
  # initiated by changes in status, such as during fleet creation and
4424
5032
  # termination, changes in capacity, etc. If a fleet has multiple
@@ -4488,7 +5096,7 @@ module Aws::GameLift
4488
5096
  # resp.events #=> Array
4489
5097
  # resp.events[0].event_id #=> String
4490
5098
  # resp.events[0].resource_id #=> String
4491
- # resp.events[0].event_code #=> String, one of "GENERIC_EVENT", "FLEET_CREATED", "FLEET_DELETED", "FLEET_SCALING_EVENT", "FLEET_STATE_DOWNLOADING", "FLEET_STATE_VALIDATING", "FLEET_STATE_BUILDING", "FLEET_STATE_ACTIVATING", "FLEET_STATE_ACTIVE", "FLEET_STATE_ERROR", "FLEET_INITIALIZATION_FAILED", "FLEET_BINARY_DOWNLOAD_FAILED", "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND", "FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE", "FLEET_VALIDATION_TIMED_OUT", "FLEET_ACTIVATION_FAILED", "FLEET_ACTIVATION_FAILED_NO_INSTANCES", "FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED", "SERVER_PROCESS_INVALID_PATH", "SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT", "SERVER_PROCESS_PROCESS_READY_TIMEOUT", "SERVER_PROCESS_CRASHED", "SERVER_PROCESS_TERMINATED_UNHEALTHY", "SERVER_PROCESS_FORCE_TERMINATED", "SERVER_PROCESS_PROCESS_EXIT_TIMEOUT", "GAME_SESSION_ACTIVATION_TIMEOUT", "FLEET_CREATION_EXTRACTING_BUILD", "FLEET_CREATION_RUNNING_INSTALLER", "FLEET_CREATION_VALIDATING_RUNTIME_CONFIG", "FLEET_VPC_PEERING_SUCCEEDED", "FLEET_VPC_PEERING_FAILED", "FLEET_VPC_PEERING_DELETED", "INSTANCE_INTERRUPTED", "INSTANCE_RECYCLED", "FLEET_CREATION_COMPLETED_INSTALLER", "FLEET_CREATION_FAILED_INSTALLER"
5099
+ # resp.events[0].event_code #=> String, one of "GENERIC_EVENT", "FLEET_CREATED", "FLEET_DELETED", "FLEET_SCALING_EVENT", "FLEET_STATE_DOWNLOADING", "FLEET_STATE_VALIDATING", "FLEET_STATE_BUILDING", "FLEET_STATE_ACTIVATING", "FLEET_STATE_ACTIVE", "FLEET_STATE_ERROR", "FLEET_STATE_PENDING", "FLEET_STATE_CREATING", "FLEET_STATE_CREATED", "FLEET_STATE_UPDATING", "FLEET_INITIALIZATION_FAILED", "FLEET_BINARY_DOWNLOAD_FAILED", "FLEET_VALIDATION_LAUNCH_PATH_NOT_FOUND", "FLEET_VALIDATION_EXECUTABLE_RUNTIME_FAILURE", "FLEET_VALIDATION_TIMED_OUT", "FLEET_ACTIVATION_FAILED", "FLEET_ACTIVATION_FAILED_NO_INSTANCES", "FLEET_NEW_GAME_SESSION_PROTECTION_POLICY_UPDATED", "SERVER_PROCESS_INVALID_PATH", "SERVER_PROCESS_SDK_INITIALIZATION_TIMEOUT", "SERVER_PROCESS_PROCESS_READY_TIMEOUT", "SERVER_PROCESS_CRASHED", "SERVER_PROCESS_TERMINATED_UNHEALTHY", "SERVER_PROCESS_FORCE_TERMINATED", "SERVER_PROCESS_PROCESS_EXIT_TIMEOUT", "SERVER_PROCESS_SDK_INITIALIZATION_FAILED", "SERVER_PROCESS_MISCONFIGURED_CONTAINER_PORT", "GAME_SESSION_ACTIVATION_TIMEOUT", "FLEET_CREATION_EXTRACTING_BUILD", "FLEET_CREATION_RUNNING_INSTALLER", "FLEET_CREATION_VALIDATING_RUNTIME_CONFIG", "FLEET_VPC_PEERING_SUCCEEDED", "FLEET_VPC_PEERING_FAILED", "FLEET_VPC_PEERING_DELETED", "INSTANCE_INTERRUPTED", "INSTANCE_RECYCLED", "INSTANCE_REPLACED_UNHEALTHY", "FLEET_CREATION_COMPLETED_INSTALLER", "FLEET_CREATION_FAILED_INSTALLER", "COMPUTE_LOG_UPLOAD_FAILED", "GAME_SERVER_CONTAINER_GROUP_CRASHED", "PER_INSTANCE_CONTAINER_GROUP_CRASHED", "GAME_SERVER_CONTAINER_GROUP_REPLACED_UNHEALTHY", "LOCATION_STATE_PENDING", "LOCATION_STATE_CREATING", "LOCATION_STATE_CREATED", "LOCATION_STATE_ACTIVATING", "LOCATION_STATE_ACTIVE", "LOCATION_STATE_UPDATING", "LOCATION_STATE_ERROR", "LOCATION_STATE_DELETING", "LOCATION_STATE_DELETED"
4492
5100
  # resp.events[0].message #=> String
4493
5101
  # resp.events[0].event_time #=> Time
4494
5102
  # resp.events[0].pre_signed_log_url #=> String
@@ -4598,8 +5206,8 @@ module Aws::GameLift
4598
5206
  # Retrieves the resource capacity settings for a fleet location. The
4599
5207
  # data returned includes the current capacity (number of EC2 instances)
4600
5208
  # and some scaling settings for the requested fleet location. For a
4601
- # container fleet, this operation also returns counts for replica
4602
- # container groups.
5209
+ # managed container fleet, this operation also returns counts for game
5210
+ # server container groups.
4603
5211
  #
4604
5212
  # Use this operation to retrieve capacity information for a fleet's
4605
5213
  # remote location or home Region (you can also retrieve home Region
@@ -4657,10 +5265,10 @@ module Aws::GameLift
4657
5265
  # resp.fleet_capacity.instance_counts.idle #=> Integer
4658
5266
  # resp.fleet_capacity.instance_counts.terminating #=> Integer
4659
5267
  # resp.fleet_capacity.location #=> String
4660
- # resp.fleet_capacity.replica_container_group_counts.pending #=> Integer
4661
- # resp.fleet_capacity.replica_container_group_counts.active #=> Integer
4662
- # resp.fleet_capacity.replica_container_group_counts.idle #=> Integer
4663
- # resp.fleet_capacity.replica_container_group_counts.terminating #=> Integer
5268
+ # resp.fleet_capacity.game_server_container_group_counts.pending #=> Integer
5269
+ # resp.fleet_capacity.game_server_container_group_counts.active #=> Integer
5270
+ # resp.fleet_capacity.game_server_container_group_counts.idle #=> Integer
5271
+ # resp.fleet_capacity.game_server_container_group_counts.terminating #=> Integer
4664
5272
  #
4665
5273
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeFleetLocationCapacity AWS API Documentation
4666
5274
  #
@@ -4735,13 +5343,13 @@ module Aws::GameLift
4735
5343
  req.send_request(options)
4736
5344
  end
4737
5345
 
4738
- # Retrieves a fleet's inbound connection permissions. Connection
5346
+ # Retrieves a fleet's inbound connection permissions. Inbound
4739
5347
  # permissions specify IP addresses and port settings that incoming
4740
5348
  # traffic can use to access server processes in the fleet. Game server
4741
5349
  # processes that are running in the fleet must use a port that falls
4742
- # within this range. To connect to game server processes on a container
4743
- # fleet, the port settings should include one or more of the fleet's
4744
- # connection ports.
5350
+ # within this range. To connect to game server processes on a managed
5351
+ # container fleet, the port settings should include one or more of the
5352
+ # container fleet's connection ports.
4745
5353
  #
4746
5354
  # Use this operation in the following ways:
4747
5355
  #
@@ -5963,13 +6571,10 @@ module Aws::GameLift
5963
6571
  end
5964
6572
 
5965
6573
  # Retrieves a fleet's runtime configuration settings. The runtime
5966
- # configuration determines which server processes run, and how, on
5967
- # computes in the fleet. For managed EC2 fleets, the runtime
5968
- # configuration describes server processes that run on each fleet
5969
- # instance. For container fleets, the runtime configuration describes
5970
- # server processes that run in each replica container group. You can
5971
- # update a fleet's runtime configuration at any time using
5972
- # UpdateRuntimeConfiguration.
6574
+ # configuration determines which server processes run, and how they run,
6575
+ # and how many run concurrently on computes in managed EC2 and Anywhere
6576
+ # fleets. You can update a fleet's runtime configuration at any time
6577
+ # using UpdateRuntimeConfiguration.
5973
6578
  #
5974
6579
  # To get the current runtime configuration for a fleet, provide the
5975
6580
  # fleet ID.
@@ -6260,43 +6865,31 @@ module Aws::GameLift
6260
6865
  req.send_request(options)
6261
6866
  end
6262
6867
 
6263
- # **This operation has been expanded to use with the Amazon GameLift
6264
- # containers feature, which is currently in public preview.**
6265
- #
6266
6868
  # Requests authorization to remotely connect to a hosting resource in a
6267
6869
  # Amazon GameLift managed fleet. This operation is not used with Amazon
6268
- # GameLift Anywhere fleets
6870
+ # GameLift Anywhere fleets.
6269
6871
  #
6270
- # To request access, specify the compute name and the fleet ID. If
6271
- # successful, this operation returns a set of temporary Amazon Web
6272
- # Services credentials, including a two-part access key and a session
6273
- # token.
6274
- #
6275
- # **EC2 fleets**
6276
- #
6277
- # With an EC2 fleet (where compute type is `EC2`), use these credentials
6278
- # with Amazon EC2 Systems Manager (SSM) to start a session with the
6279
- # compute. For more details, see [ Starting a session (CLI)][1] in the
6280
- # *Amazon EC2 Systems Manager User Guide*.
6872
+ # **Request options**
6281
6873
  #
6282
- # **Container fleets**
6874
+ # To request access to a compute, specify the compute name and the fleet
6875
+ # ID.
6283
6876
  #
6284
- # With a container fleet (where compute type is `CONTAINER`), use these
6285
- # credentials and the target value with SSM to connect to the fleet
6286
- # instance where the container is running. After you're connected to
6287
- # the instance, use Docker commands to interact with the container.
6877
+ # **Results**
6288
6878
  #
6289
- # **Learn more**
6879
+ # If successful, this operation returns a set of temporary Amazon Web
6880
+ # Services credentials, including a two-part access key and a session
6881
+ # token.
6290
6882
  #
6291
- # * [Remotely connect to fleet instances][2]
6883
+ # * With a managed EC2 fleet (where compute type is `EC2`), use these
6884
+ # credentials with Amazon EC2 Systems Manager (SSM) to start a session
6885
+ # with the compute. For more details, see [ Starting a session
6886
+ # (CLI)][1] in the *Amazon EC2 Systems Manager User Guide*.
6292
6887
  #
6293
- # * [Debug fleet issues][3]
6888
+ # ^
6294
6889
  #
6295
6890
  #
6296
6891
  #
6297
6892
  # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html#sessions-start-cli
6298
- # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-remote-access.html
6299
- # [3]: https://docs.aws.amazon.com/gamelift/latest/developerguide/fleets-creating-debug.html
6300
6893
  #
6301
6894
  # @option params [required, String] :fleet_id
6302
6895
  # A unique identifier for the fleet that holds the compute resource that
@@ -6304,10 +6897,8 @@ module Aws::GameLift
6304
6897
  #
6305
6898
  # @option params [required, String] :compute_name
6306
6899
  # A unique identifier for the compute resource that you want to connect
6307
- # to. For an EC2 fleet compute, use the instance ID. For a container
6308
- # fleet, use the compute name (for example,
6309
- # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
6310
- # or the compute ARN.
6900
+ # to. For an EC2 fleet compute, use the instance ID. Use ListCompute to
6901
+ # retrieve compute identifiers.
6311
6902
  #
6312
6903
  # @return [Types::GetComputeAccessOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6313
6904
  #
@@ -6317,6 +6908,7 @@ module Aws::GameLift
6317
6908
  # * {Types::GetComputeAccessOutput#compute_arn #compute_arn} => String
6318
6909
  # * {Types::GetComputeAccessOutput#credentials #credentials} => Types::AwsCredentials
6319
6910
  # * {Types::GetComputeAccessOutput#target #target} => String
6911
+ # * {Types::GetComputeAccessOutput#container_identifiers #container_identifiers} => Array&lt;Types::ContainerIdentifier&gt;
6320
6912
  #
6321
6913
  # @example Request syntax with placeholder values
6322
6914
  #
@@ -6335,6 +6927,9 @@ module Aws::GameLift
6335
6927
  # resp.credentials.secret_access_key #=> String
6336
6928
  # resp.credentials.session_token #=> String
6337
6929
  # resp.target #=> String
6930
+ # resp.container_identifiers #=> Array
6931
+ # resp.container_identifiers[0].container_name #=> String
6932
+ # resp.container_identifiers[0].container_runtime_id #=> String
6338
6933
  #
6339
6934
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GetComputeAccess AWS API Documentation
6340
6935
  #
@@ -6346,25 +6941,23 @@ module Aws::GameLift
6346
6941
  end
6347
6942
 
6348
6943
  # Requests an authentication token from Amazon GameLift for a compute
6349
- # resource in an Amazon GameLift Anywhere fleet or container fleet. Game
6350
- # servers that are running on the compute use this token to communicate
6351
- # with the Amazon GameLift service, such as when calling the Amazon
6352
- # GameLift server SDK action `InitSDK()`. Authentication tokens are
6353
- # valid for a limited time span, so you need to request a fresh token
6354
- # before the current token expires.
6355
- #
6356
- # Use this operation based on the fleet compute type:
6357
- #
6358
- # * For `EC2` fleets, auth token retrieval and refresh is handled
6359
- # automatically. All game servers that are running on all fleet
6360
- # instances have access to a valid auth token.
6361
- #
6362
- # * For `ANYWHERE` and `CONTAINER` fleets, if you're using the Amazon
6363
- # GameLift Agent, auth token retrieval and refresh is handled
6364
- # automatically for any container or Anywhere compute where the Agent
6365
- # is running. If you're not using the Agent, create a mechanism to
6366
- # retrieve and refresh auth tokens for computes that are running game
6367
- # server processes.
6944
+ # resource in an Amazon GameLift fleet. Game servers that are running on
6945
+ # the compute use this token to communicate with the Amazon GameLift
6946
+ # service, such as when calling the Amazon GameLift server SDK action
6947
+ # `InitSDK()`. Authentication tokens are valid for a limited time span,
6948
+ # so you need to request a fresh token before the current token expires.
6949
+ #
6950
+ # **Request options**
6951
+ #
6952
+ # * For managed EC2 fleets (compute type `EC2`), auth token retrieval
6953
+ # and refresh is handled automatically. All game servers that are
6954
+ # running on all fleet instances have access to a valid auth token.
6955
+ #
6956
+ # * For Anywhere fleets (compute type `ANYWHERE`), if you're using the
6957
+ # Amazon GameLift Agent, auth token retrieval and refresh is handled
6958
+ # automatically for any compute where the Agent is running. If you're
6959
+ # not using the Agent, create a mechanism to retrieve and refresh auth
6960
+ # tokens for computes that are running game server processes.
6368
6961
  #
6369
6962
  # **Learn more**
6370
6963
  #
@@ -6386,10 +6979,7 @@ module Aws::GameLift
6386
6979
  # @option params [required, String] :compute_name
6387
6980
  # The name of the compute resource you are requesting the authentication
6388
6981
  # token for. For an Anywhere fleet compute, use the registered compute
6389
- # name. For an EC2 fleet instance, use the instance ID. For a container
6390
- # fleet, use the compute name (for example,
6391
- # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
6392
- # or the compute ARN.
6982
+ # name. For an EC2 fleet instance, use the instance ID.
6393
6983
  #
6394
6984
  # @return [Types::GetComputeAuthTokenOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6395
6985
  #
@@ -6686,7 +7276,7 @@ module Aws::GameLift
6686
7276
  # @option params [String] :next_token
6687
7277
  # A token that indicates the start of the next sequential page of
6688
7278
  # results. Use the token that is returned with a previous call to this
6689
- # operation. To start at the beginning of the result set, don't specify
7279
+ # operation. To start at the beginning of the result set, do not specify
6690
7280
  # a value.
6691
7281
  #
6692
7282
  # @return [Types::ListBuildsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -6727,43 +7317,55 @@ module Aws::GameLift
6727
7317
  req.send_request(options)
6728
7318
  end
6729
7319
 
6730
- # **This operation has been expanded to use with the Amazon GameLift
6731
- # containers feature, which is currently in public preview.**
6732
- #
6733
7320
  # Retrieves information on the compute resources in an Amazon GameLift
6734
- # fleet.
7321
+ # fleet. Use the pagination parameters to retrieve results in a set of
7322
+ # sequential pages.
6735
7323
  #
6736
- # To request a list of computes, specify the fleet ID. Use the
6737
- # pagination parameters to retrieve results in a set of sequential
6738
- # pages.
7324
+ # **Request options:**
7325
+ #
7326
+ # * Retrieve a list of all computes in a fleet. Specify a fleet ID.
6739
7327
  #
6740
- # You can filter the result set by location.
7328
+ # * Retrieve a list of all computes in a specific fleet location.
7329
+ # Specify a fleet ID and location.
6741
7330
  #
6742
- # If successful, this operation returns information on all computes in
6743
- # the requested fleet. Depending on the fleet's compute type, the
6744
- # result includes the following information:
7331
+ # **Results:**
6745
7332
  #
6746
- # * For `EC2` fleets, this operation returns information about the EC2
6747
- # instance. Compute names are instance IDs.
7333
+ # If successful, this operation returns information on a set of
7334
+ # computes. Depending on the type of fleet, the result includes the
7335
+ # following information:
6748
7336
  #
6749
- # * For `ANYWHERE` fleets, this operation returns the compute names and
6750
- # details provided when the compute was registered with
6751
- # `RegisterCompute`. The `GameLiftServiceSdkEndpoint` or
6752
- # `GameLiftAgentEndpoint` is included.
7337
+ # * For managed EC2 fleets (compute type `EC2`), this operation returns
7338
+ # information about the EC2 instance. Compute names are EC2 instance
7339
+ # IDs.
6753
7340
  #
6754
- # * For `CONTAINER` fleets, this operation returns information about
6755
- # containers that are registered as computes, and the instances
6756
- # they're running on. Compute names are container names.
7341
+ # * For Anywhere fleets (compute type `ANYWHERE`), this operation
7342
+ # returns compute names and details as provided when the compute was
7343
+ # registered with `RegisterCompute`. This includes
7344
+ # `GameLiftServiceSdkEndpoint` or `GameLiftAgentEndpoint`.
6757
7345
  #
6758
7346
  # @option params [required, String] :fleet_id
6759
7347
  # A unique identifier for the fleet to retrieve compute resources for.
6760
7348
  #
6761
7349
  # @option params [String] :location
6762
7350
  # The name of a location to retrieve compute resources for. For an
6763
- # Amazon GameLift Anywhere fleet, use a custom location. For a
6764
- # multi-location EC2 or container fleet, provide a Amazon Web Services
6765
- # Region or Local Zone code (for example: `us-west-2` or
6766
- # `us-west-2-lax-1`).
7351
+ # Amazon GameLift Anywhere fleet, use a custom location. For a managed
7352
+ # fleet, provide a Amazon Web Services Region or Local Zone code (for
7353
+ # example: `us-west-2` or `us-west-2-lax-1`).
7354
+ #
7355
+ # @option params [String] :container_group_definition_name
7356
+ # For computes in a managed container fleet, the name of the deployed
7357
+ # container group definition.
7358
+ #
7359
+ # @option params [String] :compute_status
7360
+ # The status of computes in a managed container fleet, based on the
7361
+ # success of the latest update deployment.
7362
+ #
7363
+ # * `ACTIVE` -- The compute is deployed with the correct container
7364
+ # definitions. It is ready to process game servers and host game
7365
+ # sessions.
7366
+ #
7367
+ # * `IMPAIRED` -- An update deployment to the compute failed, and the
7368
+ # compute is deployed with incorrect container definitions.
6767
7369
  #
6768
7370
  # @option params [Integer] :limit
6769
7371
  # The maximum number of results to return. Use this parameter with
@@ -6787,6 +7389,8 @@ module Aws::GameLift
6787
7389
  # resp = client.list_compute({
6788
7390
  # fleet_id: "FleetIdOrArn", # required
6789
7391
  # location: "LocationStringModel",
7392
+ # container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
7393
+ # compute_status: "ACTIVE", # accepts ACTIVE, IMPAIRED
6790
7394
  # limit: 1,
6791
7395
  # next_token: "NonZeroAndMaxString",
6792
7396
  # })
@@ -6800,7 +7404,7 @@ module Aws::GameLift
6800
7404
  # resp.compute_list[0].compute_arn #=> String
6801
7405
  # resp.compute_list[0].ip_address #=> String
6802
7406
  # resp.compute_list[0].dns_name #=> String
6803
- # resp.compute_list[0].compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING"
7407
+ # resp.compute_list[0].compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING", "IMPAIRED"
6804
7408
  # resp.compute_list[0].location #=> String
6805
7409
  # resp.compute_list[0].creation_time #=> Time
6806
7410
  # resp.compute_list[0].operating_system #=> String, one of "WINDOWS_2012", "AMAZON_LINUX", "AMAZON_LINUX_2", "WINDOWS_2016", "AMAZON_LINUX_2023"
@@ -6808,29 +7412,279 @@ module Aws::GameLift
6808
7412
  # resp.compute_list[0].game_lift_service_sdk_endpoint #=> String
6809
7413
  # resp.compute_list[0].game_lift_agent_endpoint #=> String
6810
7414
  # resp.compute_list[0].instance_id #=> String
6811
- # resp.compute_list[0].container_attributes.container_port_mappings #=> Array
6812
- # resp.compute_list[0].container_attributes.container_port_mappings[0].container_port #=> Integer
6813
- # resp.compute_list[0].container_attributes.container_port_mappings[0].connection_port #=> Integer
6814
- # resp.compute_list[0].container_attributes.container_port_mappings[0].protocol #=> String, one of "TCP", "UDP"
7415
+ # resp.compute_list[0].container_attributes #=> Array
7416
+ # resp.compute_list[0].container_attributes[0].container_name #=> String
7417
+ # resp.compute_list[0].container_attributes[0].container_runtime_id #=> String
7418
+ # resp.compute_list[0].game_server_container_group_definition_arn #=> String
7419
+ # resp.next_token #=> String
7420
+ #
7421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListCompute AWS API Documentation
7422
+ #
7423
+ # @overload list_compute(params = {})
7424
+ # @param [Hash] params ({})
7425
+ def list_compute(params = {}, options = {})
7426
+ req = build_request(:list_compute, params)
7427
+ req.send_request(options)
7428
+ end
7429
+
7430
+ # Retrieves a collection of container fleet resources in an Amazon Web
7431
+ # Services Region. For fleets that have multiple locations, this
7432
+ # operation retrieves fleets based on their home Region only.
7433
+ #
7434
+ # **Request options**
7435
+ #
7436
+ # * Get a list of all fleets. Call this operation without specifying a
7437
+ # container group definition.
7438
+ #
7439
+ # * Get a list of fleets filtered by container group definition. Provide
7440
+ # the container group definition name or ARN value.
7441
+ #
7442
+ # * To get a list of all Realtime Servers fleets with a specific
7443
+ # configuration script, provide the script ID.
7444
+ #
7445
+ # Use the pagination parameters to retrieve results as a set of
7446
+ # sequential pages.
7447
+ #
7448
+ # If successful, this operation returns a collection of container fleets
7449
+ # that match the request parameters. A NextToken value is also returned
7450
+ # if there are more result pages to retrieve.
7451
+ #
7452
+ # <note markdown="1"> Fleet IDs are returned in no particular order.
7453
+ #
7454
+ # </note>
7455
+ #
7456
+ # @option params [String] :container_group_definition_name
7457
+ # The container group definition to filter the list on. Use this
7458
+ # parameter to retrieve only those fleets that use the specified
7459
+ # container group definition. You can specify the container group
7460
+ # definition's name to get fleets with the latest versions.
7461
+ # Alternatively, provide an ARN value to get fleets with a specific
7462
+ # version number.
7463
+ #
7464
+ # @option params [Integer] :limit
7465
+ # The maximum number of results to return. Use this parameter with
7466
+ # `NextToken` to get results as a set of sequential pages.
7467
+ #
7468
+ # @option params [String] :next_token
7469
+ # A token that indicates the start of the next sequential page of
7470
+ # results. Use the token that is returned with a previous call to this
7471
+ # operation. To start at the beginning of the result set, do not specify
7472
+ # a value.
7473
+ #
7474
+ # @return [Types::ListContainerFleetsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7475
+ #
7476
+ # * {Types::ListContainerFleetsOutput#container_fleets #container_fleets} => Array&lt;Types::ContainerFleet&gt;
7477
+ # * {Types::ListContainerFleetsOutput#next_token #next_token} => String
7478
+ #
7479
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7480
+ #
7481
+ # @example Request syntax with placeholder values
7482
+ #
7483
+ # resp = client.list_container_fleets({
7484
+ # container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
7485
+ # limit: 1,
7486
+ # next_token: "NonZeroAndMaxString",
7487
+ # })
7488
+ #
7489
+ # @example Response structure
7490
+ #
7491
+ # resp.container_fleets #=> Array
7492
+ # resp.container_fleets[0].fleet_id #=> String
7493
+ # resp.container_fleets[0].fleet_arn #=> String
7494
+ # resp.container_fleets[0].fleet_role_arn #=> String
7495
+ # resp.container_fleets[0].game_server_container_group_definition_name #=> String
7496
+ # resp.container_fleets[0].game_server_container_group_definition_arn #=> String
7497
+ # resp.container_fleets[0].per_instance_container_group_definition_name #=> String
7498
+ # resp.container_fleets[0].per_instance_container_group_definition_arn #=> String
7499
+ # resp.container_fleets[0].instance_connection_port_range.from_port #=> Integer
7500
+ # resp.container_fleets[0].instance_connection_port_range.to_port #=> Integer
7501
+ # resp.container_fleets[0].instance_inbound_permissions #=> Array
7502
+ # resp.container_fleets[0].instance_inbound_permissions[0].from_port #=> Integer
7503
+ # resp.container_fleets[0].instance_inbound_permissions[0].to_port #=> Integer
7504
+ # resp.container_fleets[0].instance_inbound_permissions[0].ip_range #=> String
7505
+ # resp.container_fleets[0].instance_inbound_permissions[0].protocol #=> String, one of "TCP", "UDP"
7506
+ # resp.container_fleets[0].game_server_container_groups_per_instance #=> Integer
7507
+ # resp.container_fleets[0].maximum_game_server_container_groups_per_instance #=> Integer
7508
+ # resp.container_fleets[0].instance_type #=> String
7509
+ # resp.container_fleets[0].billing_type #=> String, one of "ON_DEMAND", "SPOT"
7510
+ # resp.container_fleets[0].description #=> String
7511
+ # resp.container_fleets[0].creation_time #=> Time
7512
+ # resp.container_fleets[0].metric_groups #=> Array
7513
+ # resp.container_fleets[0].metric_groups[0] #=> String
7514
+ # resp.container_fleets[0].new_game_session_protection_policy #=> String, one of "NoProtection", "FullProtection"
7515
+ # resp.container_fleets[0].game_session_creation_limit_policy.new_game_sessions_per_creator #=> Integer
7516
+ # resp.container_fleets[0].game_session_creation_limit_policy.policy_period_in_minutes #=> Integer
7517
+ # resp.container_fleets[0].status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
7518
+ # resp.container_fleets[0].deployment_details.latest_deployment_id #=> String
7519
+ # resp.container_fleets[0].log_configuration.log_destination #=> String, one of "NONE", "CLOUDWATCH", "S3"
7520
+ # resp.container_fleets[0].log_configuration.s3_bucket_name #=> String
7521
+ # resp.container_fleets[0].log_configuration.log_group_arn #=> String
7522
+ # resp.container_fleets[0].location_attributes #=> Array
7523
+ # resp.container_fleets[0].location_attributes[0].location #=> String
7524
+ # resp.container_fleets[0].location_attributes[0].status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
7525
+ # resp.next_token #=> String
7526
+ #
7527
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListContainerFleets AWS API Documentation
7528
+ #
7529
+ # @overload list_container_fleets(params = {})
7530
+ # @param [Hash] params ({})
7531
+ def list_container_fleets(params = {}, options = {})
7532
+ req = build_request(:list_container_fleets, params)
7533
+ req.send_request(options)
7534
+ end
7535
+
7536
+ # Retrieves all versions of a container group definition. Use the
7537
+ # pagination parameters to retrieve results in a set of sequential
7538
+ # pages.
7539
+ #
7540
+ # **Request options:**
7541
+ #
7542
+ # * Get all versions of a specified container group definition. Specify
7543
+ # the container group definition name or ARN value. (If the ARN value
7544
+ # has a version number, it's ignored.)
7545
+ #
7546
+ # ^
7547
+ #
7548
+ # **Results:**
7549
+ #
7550
+ # If successful, this operation returns the complete properties of a set
7551
+ # of container group definition versions that match the request.
7552
+ #
7553
+ # <note markdown="1"> This operation returns the list of container group definitions in
7554
+ # descending version order (latest first).
7555
+ #
7556
+ # </note>
7557
+ #
7558
+ # **Learn more**
7559
+ #
7560
+ # * [Manage a container group definition][1]
7561
+ #
7562
+ # ^
7563
+ #
7564
+ #
7565
+ #
7566
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-create-groups.html
7567
+ #
7568
+ # @option params [required, String] :name
7569
+ # The unique identifier for the container group definition to retrieve
7570
+ # properties for. You can use either the `Name` or `ARN` value.
7571
+ #
7572
+ # @option params [Integer] :limit
7573
+ # The maximum number of results to return. Use this parameter with
7574
+ # `NextToken` to get results as a set of sequential pages.
7575
+ #
7576
+ # @option params [String] :next_token
7577
+ # A token that indicates the start of the next sequential page of
7578
+ # results. Use the token that is returned with a previous call to this
7579
+ # operation. To start at the beginning of the result set, do not specify
7580
+ # a value.
7581
+ #
7582
+ # @return [Types::ListContainerGroupDefinitionVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7583
+ #
7584
+ # * {Types::ListContainerGroupDefinitionVersionsOutput#container_group_definitions #container_group_definitions} => Array&lt;Types::ContainerGroupDefinition&gt;
7585
+ # * {Types::ListContainerGroupDefinitionVersionsOutput#next_token #next_token} => String
7586
+ #
7587
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7588
+ #
7589
+ # @example Request syntax with placeholder values
7590
+ #
7591
+ # resp = client.list_container_group_definition_versions({
7592
+ # name: "ContainerGroupDefinitionNameOrArn", # required
7593
+ # limit: 1,
7594
+ # next_token: "NonZeroAndMaxString",
7595
+ # })
7596
+ #
7597
+ # @example Response structure
7598
+ #
7599
+ # resp.container_group_definitions #=> Array
7600
+ # resp.container_group_definitions[0].container_group_definition_arn #=> String
7601
+ # resp.container_group_definitions[0].creation_time #=> Time
7602
+ # resp.container_group_definitions[0].operating_system #=> String, one of "AMAZON_LINUX_2023"
7603
+ # resp.container_group_definitions[0].name #=> String
7604
+ # resp.container_group_definitions[0].container_group_type #=> String, one of "GAME_SERVER", "PER_INSTANCE"
7605
+ # resp.container_group_definitions[0].total_memory_limit_mebibytes #=> Integer
7606
+ # resp.container_group_definitions[0].total_vcpu_limit #=> Float
7607
+ # resp.container_group_definitions[0].game_server_container_definition.container_name #=> String
7608
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on #=> Array
7609
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on[0].container_name #=> String
7610
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
7611
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points #=> Array
7612
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].instance_path #=> String
7613
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].container_path #=> String
7614
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
7615
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override #=> Array
7616
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override[0].name #=> String
7617
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override[0].value #=> String
7618
+ # resp.container_group_definitions[0].game_server_container_definition.image_uri #=> String
7619
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges #=> Array
7620
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].from_port #=> Integer
7621
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].to_port #=> Integer
7622
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
7623
+ # resp.container_group_definitions[0].game_server_container_definition.resolved_image_digest #=> String
7624
+ # resp.container_group_definitions[0].game_server_container_definition.server_sdk_version #=> String
7625
+ # resp.container_group_definitions[0].support_container_definitions #=> Array
7626
+ # resp.container_group_definitions[0].support_container_definitions[0].container_name #=> String
7627
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on #=> Array
7628
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on[0].container_name #=> String
7629
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
7630
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points #=> Array
7631
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].instance_path #=> String
7632
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].container_path #=> String
7633
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
7634
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override #=> Array
7635
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override[0].name #=> String
7636
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override[0].value #=> String
7637
+ # resp.container_group_definitions[0].support_container_definitions[0].essential #=> Boolean
7638
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.command #=> Array
7639
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.command[0] #=> String
7640
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.interval #=> Integer
7641
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.retries #=> Integer
7642
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.start_period #=> Integer
7643
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.timeout #=> Integer
7644
+ # resp.container_group_definitions[0].support_container_definitions[0].image_uri #=> String
7645
+ # resp.container_group_definitions[0].support_container_definitions[0].memory_hard_limit_mebibytes #=> Integer
7646
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges #=> Array
7647
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
7648
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
7649
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
7650
+ # resp.container_group_definitions[0].support_container_definitions[0].resolved_image_digest #=> String
7651
+ # resp.container_group_definitions[0].support_container_definitions[0].vcpu #=> Float
7652
+ # resp.container_group_definitions[0].version_number #=> Integer
7653
+ # resp.container_group_definitions[0].version_description #=> String
7654
+ # resp.container_group_definitions[0].status #=> String, one of "READY", "COPYING", "FAILED"
7655
+ # resp.container_group_definitions[0].status_reason #=> String
6815
7656
  # resp.next_token #=> String
6816
7657
  #
6817
- # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListCompute AWS API Documentation
7658
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListContainerGroupDefinitionVersions AWS API Documentation
6818
7659
  #
6819
- # @overload list_compute(params = {})
7660
+ # @overload list_container_group_definition_versions(params = {})
6820
7661
  # @param [Hash] params ({})
6821
- def list_compute(params = {}, options = {})
6822
- req = build_request(:list_compute, params)
7662
+ def list_container_group_definition_versions(params = {}, options = {})
7663
+ req = build_request(:list_container_group_definition_versions, params)
6823
7664
  req.send_request(options)
6824
7665
  end
6825
7666
 
6826
- # <b>This operation is used with the Amazon GameLift containers feature,
6827
- # which is currently in public preview. </b>
7667
+ # Retrieves container group definitions for the Amazon Web Services
7668
+ # account and Amazon Web Services Region. Use the pagination parameters
7669
+ # to retrieve results in a set of sequential pages.
7670
+ #
7671
+ # This operation returns only the latest version of each definition. To
7672
+ # retrieve all versions of a container group definition, use
7673
+ # ListContainerGroupDefinitionVersions.
7674
+ #
7675
+ # **Request options:**
7676
+ #
7677
+ # * Retrieve the most recent versions of all container group
7678
+ # definitions.
7679
+ #
7680
+ # * Retrieve the most recent versions of all container group
7681
+ # definitions, filtered by type. Specify the container group type to
7682
+ # filter on.
6828
7683
  #
6829
- # Retrieves all container group definitions for the Amazon Web Services
6830
- # account and Amazon Web Services Region that are currently in use. You
6831
- # can filter the result set by the container groups' scheduling
6832
- # strategy. Use the pagination parameters to retrieve results in a set
6833
- # of sequential pages.
7684
+ # **Results:**
7685
+ #
7686
+ # If successful, this operation returns the complete properties of a set
7687
+ # of container group definition versions that match the request.
6834
7688
  #
6835
7689
  # <note markdown="1"> This operation returns the list of container group definitions in no
6836
7690
  # particular order.
@@ -6847,15 +7701,10 @@ module Aws::GameLift
6847
7701
  #
6848
7702
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-create-groups.html
6849
7703
  #
6850
- # @option params [String] :scheduling_strategy
6851
- # The type of container group definitions to retrieve.
6852
- #
6853
- # * `DAEMON` -- Daemon container groups run background processes and are
6854
- # deployed once per fleet instance.
6855
- #
6856
- # * `REPLICA` -- Replica container groups run your game server
6857
- # application and supporting software. Replica groups might be
6858
- # deployed multiple times per fleet instance.
7704
+ # @option params [String] :container_group_type
7705
+ # The type of container group to retrieve. Container group type
7706
+ # determines how Amazon GameLift deploys the container group on each
7707
+ # fleet instance.
6859
7708
  #
6860
7709
  # @option params [Integer] :limit
6861
7710
  # The maximum number of results to return. Use this parameter with
@@ -6877,9 +7726,9 @@ module Aws::GameLift
6877
7726
  # @example Request syntax with placeholder values
6878
7727
  #
6879
7728
  # resp = client.list_container_group_definitions({
6880
- # scheduling_strategy: "REPLICA", # accepts REPLICA, DAEMON
7729
+ # container_group_type: "GAME_SERVER", # accepts GAME_SERVER, PER_INSTANCE
6881
7730
  # limit: 1,
6882
- # next_token: "NonEmptyString",
7731
+ # next_token: "NonZeroAndMaxString",
6883
7732
  # })
6884
7733
  #
6885
7734
  # @example Response structure
@@ -6889,38 +7738,56 @@ module Aws::GameLift
6889
7738
  # resp.container_group_definitions[0].creation_time #=> Time
6890
7739
  # resp.container_group_definitions[0].operating_system #=> String, one of "AMAZON_LINUX_2023"
6891
7740
  # resp.container_group_definitions[0].name #=> String
6892
- # resp.container_group_definitions[0].scheduling_strategy #=> String, one of "REPLICA", "DAEMON"
6893
- # resp.container_group_definitions[0].total_memory_limit #=> Integer
6894
- # resp.container_group_definitions[0].total_cpu_limit #=> Integer
6895
- # resp.container_group_definitions[0].container_definitions #=> Array
6896
- # resp.container_group_definitions[0].container_definitions[0].container_name #=> String
6897
- # resp.container_group_definitions[0].container_definitions[0].image_uri #=> String
6898
- # resp.container_group_definitions[0].container_definitions[0].resolved_image_digest #=> String
6899
- # resp.container_group_definitions[0].container_definitions[0].memory_limits.soft_limit #=> Integer
6900
- # resp.container_group_definitions[0].container_definitions[0].memory_limits.hard_limit #=> Integer
6901
- # resp.container_group_definitions[0].container_definitions[0].port_configuration.container_port_ranges #=> Array
6902
- # resp.container_group_definitions[0].container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
6903
- # resp.container_group_definitions[0].container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
6904
- # resp.container_group_definitions[0].container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
6905
- # resp.container_group_definitions[0].container_definitions[0].cpu #=> Integer
6906
- # resp.container_group_definitions[0].container_definitions[0].health_check.command #=> Array
6907
- # resp.container_group_definitions[0].container_definitions[0].health_check.command[0] #=> String
6908
- # resp.container_group_definitions[0].container_definitions[0].health_check.interval #=> Integer
6909
- # resp.container_group_definitions[0].container_definitions[0].health_check.timeout #=> Integer
6910
- # resp.container_group_definitions[0].container_definitions[0].health_check.retries #=> Integer
6911
- # resp.container_group_definitions[0].container_definitions[0].health_check.start_period #=> Integer
6912
- # resp.container_group_definitions[0].container_definitions[0].command #=> Array
6913
- # resp.container_group_definitions[0].container_definitions[0].command[0] #=> String
6914
- # resp.container_group_definitions[0].container_definitions[0].essential #=> Boolean
6915
- # resp.container_group_definitions[0].container_definitions[0].entry_point #=> Array
6916
- # resp.container_group_definitions[0].container_definitions[0].entry_point[0] #=> String
6917
- # resp.container_group_definitions[0].container_definitions[0].working_directory #=> String
6918
- # resp.container_group_definitions[0].container_definitions[0].environment #=> Array
6919
- # resp.container_group_definitions[0].container_definitions[0].environment[0].name #=> String
6920
- # resp.container_group_definitions[0].container_definitions[0].environment[0].value #=> String
6921
- # resp.container_group_definitions[0].container_definitions[0].depends_on #=> Array
6922
- # resp.container_group_definitions[0].container_definitions[0].depends_on[0].container_name #=> String
6923
- # resp.container_group_definitions[0].container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
7741
+ # resp.container_group_definitions[0].container_group_type #=> String, one of "GAME_SERVER", "PER_INSTANCE"
7742
+ # resp.container_group_definitions[0].total_memory_limit_mebibytes #=> Integer
7743
+ # resp.container_group_definitions[0].total_vcpu_limit #=> Float
7744
+ # resp.container_group_definitions[0].game_server_container_definition.container_name #=> String
7745
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on #=> Array
7746
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on[0].container_name #=> String
7747
+ # resp.container_group_definitions[0].game_server_container_definition.depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
7748
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points #=> Array
7749
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].instance_path #=> String
7750
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].container_path #=> String
7751
+ # resp.container_group_definitions[0].game_server_container_definition.mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
7752
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override #=> Array
7753
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override[0].name #=> String
7754
+ # resp.container_group_definitions[0].game_server_container_definition.environment_override[0].value #=> String
7755
+ # resp.container_group_definitions[0].game_server_container_definition.image_uri #=> String
7756
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges #=> Array
7757
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].from_port #=> Integer
7758
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].to_port #=> Integer
7759
+ # resp.container_group_definitions[0].game_server_container_definition.port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
7760
+ # resp.container_group_definitions[0].game_server_container_definition.resolved_image_digest #=> String
7761
+ # resp.container_group_definitions[0].game_server_container_definition.server_sdk_version #=> String
7762
+ # resp.container_group_definitions[0].support_container_definitions #=> Array
7763
+ # resp.container_group_definitions[0].support_container_definitions[0].container_name #=> String
7764
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on #=> Array
7765
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on[0].container_name #=> String
7766
+ # resp.container_group_definitions[0].support_container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
7767
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points #=> Array
7768
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].instance_path #=> String
7769
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].container_path #=> String
7770
+ # resp.container_group_definitions[0].support_container_definitions[0].mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
7771
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override #=> Array
7772
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override[0].name #=> String
7773
+ # resp.container_group_definitions[0].support_container_definitions[0].environment_override[0].value #=> String
7774
+ # resp.container_group_definitions[0].support_container_definitions[0].essential #=> Boolean
7775
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.command #=> Array
7776
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.command[0] #=> String
7777
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.interval #=> Integer
7778
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.retries #=> Integer
7779
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.start_period #=> Integer
7780
+ # resp.container_group_definitions[0].support_container_definitions[0].health_check.timeout #=> Integer
7781
+ # resp.container_group_definitions[0].support_container_definitions[0].image_uri #=> String
7782
+ # resp.container_group_definitions[0].support_container_definitions[0].memory_hard_limit_mebibytes #=> Integer
7783
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges #=> Array
7784
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
7785
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
7786
+ # resp.container_group_definitions[0].support_container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
7787
+ # resp.container_group_definitions[0].support_container_definitions[0].resolved_image_digest #=> String
7788
+ # resp.container_group_definitions[0].support_container_definitions[0].vcpu #=> Float
7789
+ # resp.container_group_definitions[0].version_number #=> Integer
7790
+ # resp.container_group_definitions[0].version_description #=> String
6924
7791
  # resp.container_group_definitions[0].status #=> String, one of "READY", "COPYING", "FAILED"
6925
7792
  # resp.container_group_definitions[0].status_reason #=> String
6926
7793
  # resp.next_token #=> String
@@ -6934,9 +7801,87 @@ module Aws::GameLift
6934
7801
  req.send_request(options)
6935
7802
  end
6936
7803
 
6937
- # **This operation has been expanded to use with the Amazon GameLift
6938
- # containers feature, which is currently in public preview.**
7804
+ # Retrieves a collection of container fleet deployments in an Amazon Web
7805
+ # Services Region.
7806
+ #
7807
+ # **Request options**
7808
+ #
7809
+ # * Get a list of all deployments. Call this operation without
7810
+ # specifying a fleet ID.
7811
+ #
7812
+ # * Get a list of all deployments for a fleet. Specify the container
7813
+ # fleet ID or ARN value.
7814
+ #
7815
+ # * To get a list of all Realtime Servers fleets with a specific
7816
+ # configuration script, provide the script ID.
7817
+ #
7818
+ # Use the pagination parameters to retrieve results as a set of
7819
+ # sequential pages.
7820
+ #
7821
+ # **Results**
7822
+ #
7823
+ # If successful, this operation returns a list of deployments that match
7824
+ # the request parameters. A NextToken value is also returned if there
7825
+ # are more result pages to retrieve.
7826
+ #
7827
+ # <note markdown="1"> Fleet IDs are returned in no particular order.
7828
+ #
7829
+ # </note>
7830
+ #
7831
+ # @option params [String] :fleet_id
7832
+ # A unique identifier for the container fleet. You can use either the
7833
+ # fleet ID or ARN value.
7834
+ #
7835
+ # @option params [Integer] :limit
7836
+ # The maximum number of results to return. Use this parameter with
7837
+ # `NextToken` to get results as a set of sequential pages.
7838
+ #
7839
+ # @option params [String] :next_token
7840
+ # A token that indicates the start of the next sequential page of
7841
+ # results. Use the token that is returned with a previous call to this
7842
+ # operation. To start at the beginning of the result set, do not specify
7843
+ # a value.
7844
+ #
7845
+ # @return [Types::ListFleetDeploymentsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
7846
+ #
7847
+ # * {Types::ListFleetDeploymentsOutput#fleet_deployments #fleet_deployments} => Array&lt;Types::FleetDeployment&gt;
7848
+ # * {Types::ListFleetDeploymentsOutput#next_token #next_token} => String
7849
+ #
7850
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7851
+ #
7852
+ # @example Request syntax with placeholder values
7853
+ #
7854
+ # resp = client.list_fleet_deployments({
7855
+ # fleet_id: "FleetIdOrArn",
7856
+ # limit: 1,
7857
+ # next_token: "NonZeroAndMaxString",
7858
+ # })
7859
+ #
7860
+ # @example Response structure
7861
+ #
7862
+ # resp.fleet_deployments #=> Array
7863
+ # resp.fleet_deployments[0].deployment_id #=> String
7864
+ # resp.fleet_deployments[0].fleet_id #=> String
7865
+ # resp.fleet_deployments[0].game_server_binary_arn #=> String
7866
+ # resp.fleet_deployments[0].rollback_game_server_binary_arn #=> String
7867
+ # resp.fleet_deployments[0].per_instance_binary_arn #=> String
7868
+ # resp.fleet_deployments[0].rollback_per_instance_binary_arn #=> String
7869
+ # resp.fleet_deployments[0].deployment_status #=> String, one of "IN_PROGRESS", "IMPAIRED", "COMPLETE", "ROLLBACK_IN_PROGRESS", "ROLLBACK_COMPLETE", "CANCELLED", "PENDING"
7870
+ # resp.fleet_deployments[0].deployment_configuration.protection_strategy #=> String, one of "WITH_PROTECTION", "IGNORE_PROTECTION"
7871
+ # resp.fleet_deployments[0].deployment_configuration.minimum_healthy_percentage #=> Integer
7872
+ # resp.fleet_deployments[0].deployment_configuration.impairment_strategy #=> String, one of "MAINTAIN", "ROLLBACK"
7873
+ # resp.fleet_deployments[0].creation_time #=> Time
7874
+ # resp.next_token #=> String
7875
+ #
7876
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListFleetDeployments AWS API Documentation
6939
7877
  #
7878
+ # @overload list_fleet_deployments(params = {})
7879
+ # @param [Hash] params ({})
7880
+ def list_fleet_deployments(params = {}, options = {})
7881
+ req = build_request(:list_fleet_deployments, params)
7882
+ req.send_request(options)
7883
+ end
7884
+
6940
7885
  # Retrieves a collection of fleet resources in an Amazon Web Services
6941
7886
  # Region. You can filter the result set to find only those fleets that
6942
7887
  # are deployed with a specific build or script. For fleets that have
@@ -6954,9 +7899,6 @@ module Aws::GameLift
6954
7899
  # * To get a list of all Realtime Servers fleets with a specific
6955
7900
  # configuration script, provide the script ID.
6956
7901
  #
6957
- # * To get a list of all fleets with a specific container group
6958
- # definition, provide the `ContainerGroupDefinition` ID.
6959
- #
6960
7902
  # Use the pagination parameters to retrieve results as a set of
6961
7903
  # sequential pages.
6962
7904
  #
@@ -6978,11 +7920,6 @@ module Aws::GameLift
6978
7920
  # this parameter to return only fleets using a specified script. Use
6979
7921
  # either the script ID or ARN value.
6980
7922
  #
6981
- # @option params [String] :container_group_definition_name
6982
- # The container group definition name to request fleets for. Use this
6983
- # parameter to return only fleets that are deployed with the specified
6984
- # container group definition.
6985
- #
6986
7923
  # @option params [Integer] :limit
6987
7924
  # The maximum number of results to return. Use this parameter with
6988
7925
  # `NextToken` to get results as a set of sequential pages.
@@ -7005,7 +7942,6 @@ module Aws::GameLift
7005
7942
  # resp = client.list_fleets({
7006
7943
  # build_id: "BuildIdOrArn",
7007
7944
  # script_id: "ScriptIdOrArn",
7008
- # container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
7009
7945
  # limit: 1,
7010
7946
  # next_token: "NonZeroAndMaxString",
7011
7947
  # })
@@ -7224,7 +8160,7 @@ module Aws::GameLift
7224
8160
  # @option params [String] :next_token
7225
8161
  # A token that indicates the start of the next sequential page of
7226
8162
  # results. Use the token that is returned with a previous call to this
7227
- # operation. To start at the beginning of the result set, don't specify
8163
+ # operation. To start at the beginning of the result set, do not specify
7228
8164
  # a value.
7229
8165
  #
7230
8166
  # @return [Types::ListScriptsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -7536,16 +8472,12 @@ module Aws::GameLift
7536
8472
  req.send_request(options)
7537
8473
  end
7538
8474
 
7539
- # **This operation has been expanded to use with the Amazon GameLift
7540
- # containers feature, which is currently in public preview.**
8475
+ # Registers a compute resource in an Amazon GameLift Anywhere fleet.
7541
8476
  #
7542
- # Registers a compute resource in an Amazon GameLift fleet. Register
7543
- # computes with an Amazon GameLift Anywhere fleet or a container fleet.
7544
- #
7545
- # For an Anywhere fleet or a container fleet that's running the Amazon
7546
- # GameLift Agent, the Agent handles all compute registry tasks for you.
7547
- # For an Anywhere fleet that doesn't use the Agent, call this operation
7548
- # to register fleet computes.
8477
+ # For an Anywhere fleet that's running the Amazon GameLift Agent, the
8478
+ # Agent handles all compute registry tasks for you. For an Anywhere
8479
+ # fleet that doesn't use the Agent, call this operation to register
8480
+ # fleet computes.
7549
8481
  #
7550
8482
  # To register a compute, give the compute a name (must be unique within
7551
8483
  # the fleet) and specify the compute resource's DNS name or IP address.
@@ -7625,7 +8557,7 @@ module Aws::GameLift
7625
8557
  # resp.compute.compute_arn #=> String
7626
8558
  # resp.compute.ip_address #=> String
7627
8559
  # resp.compute.dns_name #=> String
7628
- # resp.compute.compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING"
8560
+ # resp.compute.compute_status #=> String, one of "PENDING", "ACTIVE", "TERMINATING", "IMPAIRED"
7629
8561
  # resp.compute.location #=> String
7630
8562
  # resp.compute.creation_time #=> Time
7631
8563
  # resp.compute.operating_system #=> String, one of "WINDOWS_2012", "AMAZON_LINUX", "AMAZON_LINUX_2", "WINDOWS_2016", "AMAZON_LINUX_2023"
@@ -7633,10 +8565,10 @@ module Aws::GameLift
7633
8565
  # resp.compute.game_lift_service_sdk_endpoint #=> String
7634
8566
  # resp.compute.game_lift_agent_endpoint #=> String
7635
8567
  # resp.compute.instance_id #=> String
7636
- # resp.compute.container_attributes.container_port_mappings #=> Array
7637
- # resp.compute.container_attributes.container_port_mappings[0].container_port #=> Integer
7638
- # resp.compute.container_attributes.container_port_mappings[0].connection_port #=> Integer
7639
- # resp.compute.container_attributes.container_port_mappings[0].protocol #=> String, one of "TCP", "UDP"
8568
+ # resp.compute.container_attributes #=> Array
8569
+ # resp.compute.container_attributes[0].container_name #=> String
8570
+ # resp.compute.container_attributes[0].container_runtime_id #=> String
8571
+ # resp.compute.game_server_container_group_definition_arn #=> String
7640
8572
  #
7641
8573
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/RegisterCompute AWS API Documentation
7642
8574
  #
@@ -8247,7 +9179,7 @@ module Aws::GameLift
8247
9179
  # [DescribeGameSessionPlacement][1] and check the request's status. If
8248
9180
  # the status is `FULFILLED`, a new game session has been created and a
8249
9181
  # game session ARN and Region are referenced. If the placement request
8250
- # times out, you can resubmit the request or retry it with a different
9182
+ # times out, submit a new request to the same queue or a different
8251
9183
  # queue.
8252
9184
  #
8253
9185
  #
@@ -8277,19 +9209,18 @@ module Aws::GameLift
8277
9209
  #
8278
9210
  # @option params [Array<Types::PlayerLatency>] :player_latencies
8279
9211
  # A set of values, expressed in milliseconds, that indicates the amount
8280
- # of latency that a player experiences when connected to Amazon Web
8281
- # Services Regions. This information is used to try to place the new
8282
- # game session where it can offer the best possible gameplay experience
8283
- # for the players.
9212
+ # of latency that a player experiences when connected to @aws; Regions.
9213
+ # This information is used to try to place the new game session where it
9214
+ # can offer the best possible gameplay experience for the players.
8284
9215
  #
8285
9216
  # @option params [Array<Types::DesiredPlayerSession>] :desired_player_sessions
8286
9217
  # Set of information on each player to create a player session for.
8287
9218
  #
8288
9219
  # @option params [String] :game_session_data
8289
9220
  # A set of custom game session properties, formatted as a single string
8290
- # value. This data is passed to a game server process in the
8291
- # `GameSession` object with a request to start a new game session (see
8292
- # [Start a Game Session][1]).
9221
+ # value. This data is passed to a game server process with a request to
9222
+ # start a new game session. For more information, see [Start a game
9223
+ # session][1].
8293
9224
  #
8294
9225
  #
8295
9226
  #
@@ -9095,12 +10026,12 @@ module Aws::GameLift
9095
10026
  # build ID or ARN value.
9096
10027
  #
9097
10028
  # @option params [String] :name
9098
- # A descriptive label associated with a build. Build names don't need
9099
- # to be unique.
10029
+ # A descriptive label that is associated with a build. Build names do
10030
+ # not need to be unique.
9100
10031
  #
9101
10032
  # @option params [String] :version
9102
- # Version information associated with a build or script. Version strings
9103
- # don't need to be unique.
10033
+ # Version information that is associated with a build or script. Version
10034
+ # strings do not need to be unique.
9104
10035
  #
9105
10036
  # @return [Types::UpdateBuildOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9106
10037
  #
@@ -9135,6 +10066,486 @@ module Aws::GameLift
9135
10066
  req.send_request(options)
9136
10067
  end
9137
10068
 
10069
+ # Updates the properties of a managed container fleet. Depending on the
10070
+ # properties being updated, this operation might initiate a fleet
10071
+ # deployment. You can track deployments for a fleet using
10072
+ # DescribeFleetDeployment.
10073
+ #
10074
+ # **Request options**
10075
+ #
10076
+ # As with CreateContainerFleet, many fleet properties use common
10077
+ # defaults or are calculated based on the fleet's container group
10078
+ # definitions.
10079
+ #
10080
+ # * Update fleet properties that result in a fleet deployment. Include
10081
+ # only those properties that you want to change. Specify deployment
10082
+ # configuration settings.
10083
+ #
10084
+ # * Update fleet properties that don't result in a fleet deployment.
10085
+ # Include only those properties that you want to change.
10086
+ #
10087
+ # Changes to the following properties initiate a fleet deployment:
10088
+ #
10089
+ # * `GameServerContainerGroupDefinition`
10090
+ #
10091
+ # * `PerInstanceContainerGroupDefinition`
10092
+ #
10093
+ # * `GameServerContainerGroupsPerInstance`
10094
+ #
10095
+ # * `InstanceInboundPermissions`
10096
+ #
10097
+ # * `InstanceConnectionPortRange`
10098
+ #
10099
+ # * `LogConfiguration`
10100
+ #
10101
+ # **Results**
10102
+ #
10103
+ # If successful, this operation updates the container fleet resource,
10104
+ # and might initiate a new deployment of fleet resources using the
10105
+ # deployment configuration provided. A deployment replaces existing
10106
+ # fleet instances with new instances that are deployed with the updated
10107
+ # fleet properties. The fleet is placed in `UPDATING` status until the
10108
+ # deployment is complete, then return to `ACTIVE`.
10109
+ #
10110
+ # You can have only one update deployment active at a time for a fleet.
10111
+ # If a second update request initiates a deployment while another
10112
+ # deployment is in progress, the first deployment is cancelled.
10113
+ #
10114
+ # @option params [required, String] :fleet_id
10115
+ # A unique identifier for the container fleet to update. You can use
10116
+ # either the fleet ID or ARN value.
10117
+ #
10118
+ # @option params [String] :game_server_container_group_definition_name
10119
+ # The name or ARN value of a new game server container group definition
10120
+ # to deploy on the fleet. If you're updating the fleet to a specific
10121
+ # version of a container group definition, use the ARN value and include
10122
+ # the version number. If you're updating the fleet to the latest
10123
+ # version of a container group definition, you can use the name value.
10124
+ # You can't remove a fleet's game server container group definition,
10125
+ # you can only update or replace it with another definition.
10126
+ #
10127
+ # Update a container group definition by calling
10128
+ # UpdateContainerGroupDefinition. This operation creates a
10129
+ # ContainerGroupDefinition resource with an incremented version.
10130
+ #
10131
+ # @option params [String] :per_instance_container_group_definition_name
10132
+ # The name or ARN value of a new per-instance container group definition
10133
+ # to deploy on the fleet. If you're updating the fleet to a specific
10134
+ # version of a container group definition, use the ARN value and include
10135
+ # the version number. If you're updating the fleet to the latest
10136
+ # version of a container group definition, you can use the name value.
10137
+ #
10138
+ # Update a container group definition by calling
10139
+ # UpdateContainerGroupDefinition. This operation creates a
10140
+ # ContainerGroupDefinition resource with an incremented version.
10141
+ #
10142
+ # To remove a fleet's per-instance container group definition, leave
10143
+ # this parameter empty and use the parameter `RemoveAttributes`.
10144
+ #
10145
+ # @option params [Integer] :game_server_container_groups_per_instance
10146
+ # The number of times to replicate the game server container group on
10147
+ # each fleet instance. By default, Amazon GameLift calculates the
10148
+ # maximum number of game server container groups that can fit on each
10149
+ # instance. You can remove this property value to use the calculated
10150
+ # value, or set it manually. If you set this number manually, Amazon
10151
+ # GameLift uses your value as long as it's less than the calculated
10152
+ # maximum.
10153
+ #
10154
+ # @option params [Types::ConnectionPortRange] :instance_connection_port_range
10155
+ # A revised set of port numbers to open on each fleet instance. By
10156
+ # default, Amazon GameLift calculates an optimal port range based on
10157
+ # your fleet configuration. If you previously set this parameter
10158
+ # manually, you can't reset this to use the calculated settings.
10159
+ #
10160
+ # @option params [Array<Types::IpPermission>] :instance_inbound_permission_authorizations
10161
+ # A set of ports to add to the container fleet's inbound permissions.
10162
+ #
10163
+ # @option params [Array<Types::IpPermission>] :instance_inbound_permission_revocations
10164
+ # A set of ports to remove from the container fleet's inbound
10165
+ # permissions.
10166
+ #
10167
+ # @option params [Types::DeploymentConfiguration] :deployment_configuration
10168
+ # Instructions for how to deploy updates to a container fleet, if the
10169
+ # fleet update initiates a deployment. The deployment configuration lets
10170
+ # you determine how to replace fleet instances and what actions to take
10171
+ # if the deployment fails.
10172
+ #
10173
+ # @option params [String] :description
10174
+ # A meaningful description of the container fleet.
10175
+ #
10176
+ # @option params [Array<String>] :metric_groups
10177
+ # The name of an Amazon Web Services CloudWatch metric group to add this
10178
+ # fleet to.
10179
+ #
10180
+ # @option params [String] :new_game_session_protection_policy
10181
+ # The game session protection policy to apply to all new game sessions
10182
+ # that are started in this fleet. Game sessions that already exist are
10183
+ # not affected.
10184
+ #
10185
+ # @option params [Types::GameSessionCreationLimitPolicy] :game_session_creation_limit_policy
10186
+ # A policy that limits the number of game sessions that each individual
10187
+ # player can create on instances in this fleet. The limit applies for a
10188
+ # specified span of time.
10189
+ #
10190
+ # @option params [Types::LogConfiguration] :log_configuration
10191
+ # The method for collecting container logs for the fleet.
10192
+ #
10193
+ # @option params [Array<String>] :remove_attributes
10194
+ # If set, this update removes a fleet's per-instance container group
10195
+ # definition. You can't remove a fleet's game server container group
10196
+ # definition.
10197
+ #
10198
+ # @return [Types::UpdateContainerFleetOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10199
+ #
10200
+ # * {Types::UpdateContainerFleetOutput#container_fleet #container_fleet} => Types::ContainerFleet
10201
+ #
10202
+ # @example Request syntax with placeholder values
10203
+ #
10204
+ # resp = client.update_container_fleet({
10205
+ # fleet_id: "FleetIdOrArn", # required
10206
+ # game_server_container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
10207
+ # per_instance_container_group_definition_name: "ContainerGroupDefinitionNameOrArn",
10208
+ # game_server_container_groups_per_instance: 1,
10209
+ # instance_connection_port_range: {
10210
+ # from_port: 1, # required
10211
+ # to_port: 1, # required
10212
+ # },
10213
+ # instance_inbound_permission_authorizations: [
10214
+ # {
10215
+ # from_port: 1, # required
10216
+ # to_port: 1, # required
10217
+ # ip_range: "IpRange", # required
10218
+ # protocol: "TCP", # required, accepts TCP, UDP
10219
+ # },
10220
+ # ],
10221
+ # instance_inbound_permission_revocations: [
10222
+ # {
10223
+ # from_port: 1, # required
10224
+ # to_port: 1, # required
10225
+ # ip_range: "IpRange", # required
10226
+ # protocol: "TCP", # required, accepts TCP, UDP
10227
+ # },
10228
+ # ],
10229
+ # deployment_configuration: {
10230
+ # protection_strategy: "WITH_PROTECTION", # accepts WITH_PROTECTION, IGNORE_PROTECTION
10231
+ # minimum_healthy_percentage: 1,
10232
+ # impairment_strategy: "MAINTAIN", # accepts MAINTAIN, ROLLBACK
10233
+ # },
10234
+ # description: "NonZeroAndMaxString",
10235
+ # metric_groups: ["MetricGroup"],
10236
+ # new_game_session_protection_policy: "NoProtection", # accepts NoProtection, FullProtection
10237
+ # game_session_creation_limit_policy: {
10238
+ # new_game_sessions_per_creator: 1,
10239
+ # policy_period_in_minutes: 1,
10240
+ # },
10241
+ # log_configuration: {
10242
+ # log_destination: "NONE", # accepts NONE, CLOUDWATCH, S3
10243
+ # s3_bucket_name: "NonEmptyString",
10244
+ # log_group_arn: "LogGroupArnStringModel",
10245
+ # },
10246
+ # remove_attributes: ["PER_INSTANCE_CONTAINER_GROUP_DEFINITION"], # accepts PER_INSTANCE_CONTAINER_GROUP_DEFINITION
10247
+ # })
10248
+ #
10249
+ # @example Response structure
10250
+ #
10251
+ # resp.container_fleet.fleet_id #=> String
10252
+ # resp.container_fleet.fleet_arn #=> String
10253
+ # resp.container_fleet.fleet_role_arn #=> String
10254
+ # resp.container_fleet.game_server_container_group_definition_name #=> String
10255
+ # resp.container_fleet.game_server_container_group_definition_arn #=> String
10256
+ # resp.container_fleet.per_instance_container_group_definition_name #=> String
10257
+ # resp.container_fleet.per_instance_container_group_definition_arn #=> String
10258
+ # resp.container_fleet.instance_connection_port_range.from_port #=> Integer
10259
+ # resp.container_fleet.instance_connection_port_range.to_port #=> Integer
10260
+ # resp.container_fleet.instance_inbound_permissions #=> Array
10261
+ # resp.container_fleet.instance_inbound_permissions[0].from_port #=> Integer
10262
+ # resp.container_fleet.instance_inbound_permissions[0].to_port #=> Integer
10263
+ # resp.container_fleet.instance_inbound_permissions[0].ip_range #=> String
10264
+ # resp.container_fleet.instance_inbound_permissions[0].protocol #=> String, one of "TCP", "UDP"
10265
+ # resp.container_fleet.game_server_container_groups_per_instance #=> Integer
10266
+ # resp.container_fleet.maximum_game_server_container_groups_per_instance #=> Integer
10267
+ # resp.container_fleet.instance_type #=> String
10268
+ # resp.container_fleet.billing_type #=> String, one of "ON_DEMAND", "SPOT"
10269
+ # resp.container_fleet.description #=> String
10270
+ # resp.container_fleet.creation_time #=> Time
10271
+ # resp.container_fleet.metric_groups #=> Array
10272
+ # resp.container_fleet.metric_groups[0] #=> String
10273
+ # resp.container_fleet.new_game_session_protection_policy #=> String, one of "NoProtection", "FullProtection"
10274
+ # resp.container_fleet.game_session_creation_limit_policy.new_game_sessions_per_creator #=> Integer
10275
+ # resp.container_fleet.game_session_creation_limit_policy.policy_period_in_minutes #=> Integer
10276
+ # resp.container_fleet.status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
10277
+ # resp.container_fleet.deployment_details.latest_deployment_id #=> String
10278
+ # resp.container_fleet.log_configuration.log_destination #=> String, one of "NONE", "CLOUDWATCH", "S3"
10279
+ # resp.container_fleet.log_configuration.s3_bucket_name #=> String
10280
+ # resp.container_fleet.log_configuration.log_group_arn #=> String
10281
+ # resp.container_fleet.location_attributes #=> Array
10282
+ # resp.container_fleet.location_attributes[0].location #=> String
10283
+ # resp.container_fleet.location_attributes[0].status #=> String, one of "PENDING", "CREATING", "CREATED", "ACTIVATING", "ACTIVE", "UPDATING", "DELETING"
10284
+ #
10285
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateContainerFleet AWS API Documentation
10286
+ #
10287
+ # @overload update_container_fleet(params = {})
10288
+ # @param [Hash] params ({})
10289
+ def update_container_fleet(params = {}, options = {})
10290
+ req = build_request(:update_container_fleet, params)
10291
+ req.send_request(options)
10292
+ end
10293
+
10294
+ # Updates properties in an existing container group definition. This
10295
+ # operation doesn't replace the definition. Instead, it creates a new
10296
+ # version of the definition and saves it separately. You can access all
10297
+ # versions that you choose to retain.
10298
+ #
10299
+ # The only property you can't update is the container group type.
10300
+ #
10301
+ # **Request options:**
10302
+ #
10303
+ # * Update based on the latest version of the container group
10304
+ # definition. Specify the container group definition name only, or use
10305
+ # an ARN value without a version number. Provide updated values for
10306
+ # the properties that you want to change only. All other values remain
10307
+ # the same as the latest version.
10308
+ #
10309
+ # * Update based on a specific version of the container group
10310
+ # definition. Specify the container group definition name and a source
10311
+ # version number, or use an ARN value with a version number. Provide
10312
+ # updated values for the properties that you want to change only. All
10313
+ # other values remain the same as the source version.
10314
+ #
10315
+ # * Change a game server container definition. Provide the updated
10316
+ # container definition.
10317
+ #
10318
+ # * Add or change a support container definition. Provide a complete set
10319
+ # of container definitions, including the updated definition.
10320
+ #
10321
+ # * Remove a support container definition. Provide a complete set of
10322
+ # container definitions, excluding the definition to remove. If the
10323
+ # container group has only one support container definition, provide
10324
+ # an empty set.
10325
+ #
10326
+ # **Results:**
10327
+ #
10328
+ # If successful, this operation returns the complete properties of the
10329
+ # new container group definition version.
10330
+ #
10331
+ # If the container group definition version is used in an active fleets,
10332
+ # the update automatically initiates a new fleet deployment of the new
10333
+ # version. You can track a fleet's deployments using
10334
+ # ListFleetDeployments.
10335
+ #
10336
+ # @option params [required, String] :name
10337
+ # A descriptive identifier for the container group definition. The name
10338
+ # value must be unique in an Amazon Web Services Region.
10339
+ #
10340
+ # @option params [Types::GameServerContainerDefinitionInput] :game_server_container_definition
10341
+ # An updated definition for the game server container in this group.
10342
+ # Define a game server container only when the container group type is
10343
+ # `GAME_SERVER`. You can pass in your container definitions as a JSON
10344
+ # file.
10345
+ #
10346
+ # @option params [Array<Types::SupportContainerDefinitionInput>] :support_container_definitions
10347
+ # One or more definitions for support containers in this group. You can
10348
+ # define a support container in any type of container group. You can
10349
+ # pass in your container definitions as a JSON file.
10350
+ #
10351
+ # @option params [Integer] :total_memory_limit_mebibytes
10352
+ # The maximum amount of memory (in MiB) to allocate to the container
10353
+ # group. All containers in the group share this memory. If you specify
10354
+ # memory limits for an individual container, the total value must be
10355
+ # greater than any individual container's memory limit.
10356
+ #
10357
+ # @option params [Float] :total_vcpu_limit
10358
+ # The maximum amount of vCPU units to allocate to the container group (1
10359
+ # vCPU is equal to 1024 CPU units). All containers in the group share
10360
+ # this memory. If you specify vCPU limits for individual containers, the
10361
+ # total value must be equal to or greater than the sum of the CPU limits
10362
+ # for all containers in the group.
10363
+ #
10364
+ # @option params [String] :version_description
10365
+ # A description for this update to the container group definition.
10366
+ #
10367
+ # @option params [Integer] :source_version_number
10368
+ # The container group definition version to update. The new version
10369
+ # starts with values from the source version, and then updates values
10370
+ # included in this request.
10371
+ #
10372
+ # @option params [String] :operating_system
10373
+ # The platform that all containers in the group use. Containers in a
10374
+ # group must run on the same operating system.
10375
+ #
10376
+ # <note markdown="1"> Amazon Linux 2 (AL2) will reach end of support on 6/30/2025. See more
10377
+ # details in the [Amazon Linux 2 FAQs][1]. For game servers that are
10378
+ # hosted on AL2 and use Amazon GameLift server SDK 4.x, first update the
10379
+ # game server build to server SDK 5.x, and then deploy to AL2023
10380
+ # instances. See [ Migrate to Amazon GameLift server SDK version 5.][2]
10381
+ #
10382
+ # </note>
10383
+ #
10384
+ #
10385
+ #
10386
+ # [1]: https://aws.amazon.com/amazon-linux-2/faqs/
10387
+ # [2]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk5-migration.html
10388
+ #
10389
+ # @return [Types::UpdateContainerGroupDefinitionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
10390
+ #
10391
+ # * {Types::UpdateContainerGroupDefinitionOutput#container_group_definition #container_group_definition} => Types::ContainerGroupDefinition
10392
+ #
10393
+ # @example Request syntax with placeholder values
10394
+ #
10395
+ # resp = client.update_container_group_definition({
10396
+ # name: "ContainerGroupDefinitionNameOrArn", # required
10397
+ # game_server_container_definition: {
10398
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
10399
+ # depends_on: [
10400
+ # {
10401
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
10402
+ # condition: "START", # required, accepts START, COMPLETE, SUCCESS, HEALTHY
10403
+ # },
10404
+ # ],
10405
+ # mount_points: [
10406
+ # {
10407
+ # instance_path: "InstancePathString", # required
10408
+ # container_path: "ContainerPathString",
10409
+ # access_level: "READ_ONLY", # accepts READ_ONLY, READ_AND_WRITE
10410
+ # },
10411
+ # ],
10412
+ # environment_override: [
10413
+ # {
10414
+ # name: "NonZeroAnd255MaxString", # required
10415
+ # value: "NonZeroAnd255MaxString", # required
10416
+ # },
10417
+ # ],
10418
+ # image_uri: "ImageUriString", # required
10419
+ # port_configuration: { # required
10420
+ # container_port_ranges: [ # required
10421
+ # {
10422
+ # from_port: 1, # required
10423
+ # to_port: 1, # required
10424
+ # protocol: "TCP", # required, accepts TCP, UDP
10425
+ # },
10426
+ # ],
10427
+ # },
10428
+ # server_sdk_version: "ServerSdkVersion", # required
10429
+ # },
10430
+ # support_container_definitions: [
10431
+ # {
10432
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
10433
+ # depends_on: [
10434
+ # {
10435
+ # container_name: "NonZeroAnd128MaxAsciiString", # required
10436
+ # condition: "START", # required, accepts START, COMPLETE, SUCCESS, HEALTHY
10437
+ # },
10438
+ # ],
10439
+ # mount_points: [
10440
+ # {
10441
+ # instance_path: "InstancePathString", # required
10442
+ # container_path: "ContainerPathString",
10443
+ # access_level: "READ_ONLY", # accepts READ_ONLY, READ_AND_WRITE
10444
+ # },
10445
+ # ],
10446
+ # environment_override: [
10447
+ # {
10448
+ # name: "NonZeroAnd255MaxString", # required
10449
+ # value: "NonZeroAnd255MaxString", # required
10450
+ # },
10451
+ # ],
10452
+ # essential: false,
10453
+ # health_check: {
10454
+ # command: ["NonZeroAnd255MaxString"], # required
10455
+ # interval: 1,
10456
+ # retries: 1,
10457
+ # start_period: 1,
10458
+ # timeout: 1,
10459
+ # },
10460
+ # image_uri: "ImageUriString", # required
10461
+ # memory_hard_limit_mebibytes: 1,
10462
+ # port_configuration: {
10463
+ # container_port_ranges: [ # required
10464
+ # {
10465
+ # from_port: 1, # required
10466
+ # to_port: 1, # required
10467
+ # protocol: "TCP", # required, accepts TCP, UDP
10468
+ # },
10469
+ # ],
10470
+ # },
10471
+ # vcpu: 1.0,
10472
+ # },
10473
+ # ],
10474
+ # total_memory_limit_mebibytes: 1,
10475
+ # total_vcpu_limit: 1.0,
10476
+ # version_description: "NonZeroAndMaxString",
10477
+ # source_version_number: 1,
10478
+ # operating_system: "AMAZON_LINUX_2023", # accepts AMAZON_LINUX_2023
10479
+ # })
10480
+ #
10481
+ # @example Response structure
10482
+ #
10483
+ # resp.container_group_definition.container_group_definition_arn #=> String
10484
+ # resp.container_group_definition.creation_time #=> Time
10485
+ # resp.container_group_definition.operating_system #=> String, one of "AMAZON_LINUX_2023"
10486
+ # resp.container_group_definition.name #=> String
10487
+ # resp.container_group_definition.container_group_type #=> String, one of "GAME_SERVER", "PER_INSTANCE"
10488
+ # resp.container_group_definition.total_memory_limit_mebibytes #=> Integer
10489
+ # resp.container_group_definition.total_vcpu_limit #=> Float
10490
+ # resp.container_group_definition.game_server_container_definition.container_name #=> String
10491
+ # resp.container_group_definition.game_server_container_definition.depends_on #=> Array
10492
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].container_name #=> String
10493
+ # resp.container_group_definition.game_server_container_definition.depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
10494
+ # resp.container_group_definition.game_server_container_definition.mount_points #=> Array
10495
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].instance_path #=> String
10496
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].container_path #=> String
10497
+ # resp.container_group_definition.game_server_container_definition.mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
10498
+ # resp.container_group_definition.game_server_container_definition.environment_override #=> Array
10499
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].name #=> String
10500
+ # resp.container_group_definition.game_server_container_definition.environment_override[0].value #=> String
10501
+ # resp.container_group_definition.game_server_container_definition.image_uri #=> String
10502
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges #=> Array
10503
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].from_port #=> Integer
10504
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].to_port #=> Integer
10505
+ # resp.container_group_definition.game_server_container_definition.port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
10506
+ # resp.container_group_definition.game_server_container_definition.resolved_image_digest #=> String
10507
+ # resp.container_group_definition.game_server_container_definition.server_sdk_version #=> String
10508
+ # resp.container_group_definition.support_container_definitions #=> Array
10509
+ # resp.container_group_definition.support_container_definitions[0].container_name #=> String
10510
+ # resp.container_group_definition.support_container_definitions[0].depends_on #=> Array
10511
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].container_name #=> String
10512
+ # resp.container_group_definition.support_container_definitions[0].depends_on[0].condition #=> String, one of "START", "COMPLETE", "SUCCESS", "HEALTHY"
10513
+ # resp.container_group_definition.support_container_definitions[0].mount_points #=> Array
10514
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].instance_path #=> String
10515
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].container_path #=> String
10516
+ # resp.container_group_definition.support_container_definitions[0].mount_points[0].access_level #=> String, one of "READ_ONLY", "READ_AND_WRITE"
10517
+ # resp.container_group_definition.support_container_definitions[0].environment_override #=> Array
10518
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].name #=> String
10519
+ # resp.container_group_definition.support_container_definitions[0].environment_override[0].value #=> String
10520
+ # resp.container_group_definition.support_container_definitions[0].essential #=> Boolean
10521
+ # resp.container_group_definition.support_container_definitions[0].health_check.command #=> Array
10522
+ # resp.container_group_definition.support_container_definitions[0].health_check.command[0] #=> String
10523
+ # resp.container_group_definition.support_container_definitions[0].health_check.interval #=> Integer
10524
+ # resp.container_group_definition.support_container_definitions[0].health_check.retries #=> Integer
10525
+ # resp.container_group_definition.support_container_definitions[0].health_check.start_period #=> Integer
10526
+ # resp.container_group_definition.support_container_definitions[0].health_check.timeout #=> Integer
10527
+ # resp.container_group_definition.support_container_definitions[0].image_uri #=> String
10528
+ # resp.container_group_definition.support_container_definitions[0].memory_hard_limit_mebibytes #=> Integer
10529
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges #=> Array
10530
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].from_port #=> Integer
10531
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].to_port #=> Integer
10532
+ # resp.container_group_definition.support_container_definitions[0].port_configuration.container_port_ranges[0].protocol #=> String, one of "TCP", "UDP"
10533
+ # resp.container_group_definition.support_container_definitions[0].resolved_image_digest #=> String
10534
+ # resp.container_group_definition.support_container_definitions[0].vcpu #=> Float
10535
+ # resp.container_group_definition.version_number #=> Integer
10536
+ # resp.container_group_definition.version_description #=> String
10537
+ # resp.container_group_definition.status #=> String, one of "READY", "COPYING", "FAILED"
10538
+ # resp.container_group_definition.status_reason #=> String
10539
+ #
10540
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateContainerGroupDefinition AWS API Documentation
10541
+ #
10542
+ # @overload update_container_group_definition(params = {})
10543
+ # @param [Hash] params ({})
10544
+ def update_container_group_definition(params = {}, options = {})
10545
+ req = build_request(:update_container_group_definition, params)
10546
+ req.send_request(options)
10547
+ end
10548
+
9138
10549
  # Updates a fleet's mutable attributes, such as game session protection
9139
10550
  # and resource creation limits.
9140
10551
  #
@@ -9165,7 +10576,7 @@ module Aws::GameLift
9165
10576
  # The game session protection policy to apply to all new game sessions
9166
10577
  # created in this fleet. Game sessions that already exist are not
9167
10578
  # affected. You can set protection for individual game sessions using
9168
- # [UpdateGameSession][1] .
10579
+ # [UpdateGameSession][1].
9169
10580
  #
9170
10581
  # * **NoProtection** -- The game session can be terminated during a
9171
10582
  # scale-down event.
@@ -9227,11 +10638,8 @@ module Aws::GameLift
9227
10638
  req.send_request(options)
9228
10639
  end
9229
10640
 
9230
- # **This operation has been expanded to use with the Amazon GameLift
9231
- # containers feature, which is currently in public preview.**
9232
- #
9233
- # Updates capacity settings for a managed EC2 fleet or container fleet.
9234
- # For these fleets, you adjust capacity by changing the number of
10641
+ # Updates capacity settings for a managed EC2 fleet or managed container
10642
+ # fleet. For these fleets, you adjust capacity by changing the number of
9235
10643
  # instances in the fleet. Fleet capacity determines the number of game
9236
10644
  # sessions and players that the fleet can host based on its
9237
10645
  # configuration. For fleets with multiple locations, use this operation
@@ -9765,18 +11173,15 @@ module Aws::GameLift
9765
11173
  # @option params [Integer] :timeout_in_seconds
9766
11174
  # The maximum time, in seconds, that a new game session placement
9767
11175
  # request remains in the queue. When a request exceeds this time, the
9768
- # game session placement changes to a `TIMED_OUT` status. By default,
9769
- # this property is set to `600`.
11176
+ # game session placement changes to a `TIMED_OUT` status.
9770
11177
  #
9771
11178
  # @option params [Array<Types::PlayerLatencyPolicy>] :player_latency_policies
9772
- # A set of policies that act as a sliding cap on player latency. FleetIQ
9773
- # works to deliver low latency for most players in a game session. These
9774
- # policies ensure that no individual player can be placed into a game
9775
- # with unreasonably high latency. Use multiple policies to gradually
9776
- # relax latency requirements a step at a time. Multiple policies are
9777
- # applied based on their maximum allowed latency, starting with the
9778
- # lowest value. When updating policies, provide a complete collection of
9779
- # policies.
11179
+ # A set of policies that enforce a sliding cap on player latency when
11180
+ # processing game sessions placement requests. Use multiple policies to
11181
+ # gradually relax the cap over time if Amazon GameLift can't make a
11182
+ # placement. Policies are evaluated in order starting with the lowest
11183
+ # maximum latency value. When updating policies, provide a complete
11184
+ # collection of policies.
9780
11185
  #
9781
11186
  # @option params [Array<Types::GameSessionQueueDestination>] :destinations
9782
11187
  # A list of fleets and/or fleet aliases that can be used to fulfill game
@@ -9940,10 +11345,9 @@ module Aws::GameLift
9940
11345
  # @option params [Integer] :additional_player_count
9941
11346
  # The number of player slots in a match to keep open for future players.
9942
11347
  # For example, if the configuration's rule set specifies a match for a
9943
- # single 10-person team, and the additional player count is set to 2, 10
9944
- # players will be selected for the match and 2 more player slots will be
9945
- # open for future players. This parameter is not used if `FlexMatchMode`
9946
- # is set to `STANDALONE`.
11348
+ # single 12-person team, and the additional player count is set to 2,
11349
+ # only 10 players are selected for the match. This parameter is not used
11350
+ # if `FlexMatchMode` is set to `STANDALONE`.
9947
11351
  #
9948
11352
  # @option params [String] :custom_event_data
9949
11353
  # Information to add to all events related to the matchmaking
@@ -9959,10 +11363,10 @@ module Aws::GameLift
9959
11363
  # @option params [String] :game_session_data
9960
11364
  # A set of custom game session properties, formatted as a single string
9961
11365
  # value. This data is passed to a game server process with a request to
9962
- # start a new game session (see [Start a Game Session][1]). This
9963
- # information is added to the game session that is created for a
9964
- # successful match. This parameter is not used if `FlexMatchMode` is set
9965
- # to `STANDALONE`.
11366
+ # start a new game session. For more information, see [Start a game
11367
+ # session][1]. This information is added to the game session that is
11368
+ # created for a successful match. This parameter is not used if
11369
+ # `FlexMatchMode` is set to `STANDALONE`.
9966
11370
  #
9967
11371
  #
9968
11372
  #
@@ -10059,11 +11463,9 @@ module Aws::GameLift
10059
11463
 
10060
11464
  # Updates the runtime configuration for the specified fleet. The runtime
10061
11465
  # configuration tells Amazon GameLift how to launch server processes on
10062
- # computes in the fleet. For managed EC2 fleets, it determines what
10063
- # server processes to run on each fleet instance. For container fleets,
10064
- # it describes what server processes to run in each replica container
10065
- # group. You can update a fleet's runtime configuration at any time
10066
- # after the fleet is created; it does not need to be in `ACTIVE` status.
11466
+ # computes in managed EC2 and Anywhere fleets. You can update a fleet's
11467
+ # runtime configuration at any time after the fleet is created; it does
11468
+ # not need to be in `ACTIVE` status.
10067
11469
  #
10068
11470
  # To update runtime configuration, specify the fleet ID and provide a
10069
11471
  # `RuntimeConfiguration` with an updated set of server process
@@ -10168,12 +11570,12 @@ module Aws::GameLift
10168
11570
  # either the script ID or ARN value.
10169
11571
  #
10170
11572
  # @option params [String] :name
10171
- # A descriptive label that is associated with a script. Script names
10172
- # don't need to be unique.
11573
+ # A descriptive label that is associated with a script. Script names do
11574
+ # not need to be unique.
10173
11575
  #
10174
11576
  # @option params [String] :version
10175
- # Version information associated with a build or script. Version strings
10176
- # don't need to be unique.
11577
+ # Version information that is associated with a build or script. Version
11578
+ # strings do not need to be unique.
10177
11579
  #
10178
11580
  # @option params [Types::S3Location] :storage_location
10179
11581
  # The location of the Amazon S3 bucket where a zipped file containing
@@ -10296,7 +11698,7 @@ module Aws::GameLift
10296
11698
  tracer: tracer
10297
11699
  )
10298
11700
  context[:gem_name] = 'aws-sdk-gamelift'
10299
- context[:gem_version] = '1.94.0'
11701
+ context[:gem_version] = '1.96.0'
10300
11702
  Seahorse::Client::Request.new(handlers, context)
10301
11703
  end
10302
11704