aws-sdk-gamelift 1.75.0 → 1.77.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -105,8 +105,7 @@ module Aws::GameLift
105
105
  include Aws::Structure
106
106
  end
107
107
 
108
- # Amazon GameLift Anywhere configuration options for your Anywhere
109
- # fleets.
108
+ # Amazon GameLift configuration options for your Anywhere fleets.
110
109
  #
111
110
  # @!attribute [rw] cost
112
111
  # The cost to run your fleet per hour. Amazon GameLift uses the
@@ -302,6 +301,9 @@ module Aws::GameLift
302
301
  include Aws::Structure
303
302
  end
304
303
 
304
+ # **This data type has been expanded to use with the Amazon GameLift
305
+ # containers feature, which is currently in public preview.**
306
+ #
305
307
  # Determines whether a TLS/SSL certificate is generated for a fleet.
306
308
  # This feature must be enabled when creating the fleet. All instances in
307
309
  # a fleet share the same certificate. The certificate can be retrieved
@@ -396,9 +398,20 @@ module Aws::GameLift
396
398
  include Aws::Structure
397
399
  end
398
400
 
399
- # An Amazon GameLift compute resource for hosting your game servers. A
400
- # compute can be an EC2instance in a managed EC2 fleet or a registered
401
- # compute in an Anywhere fleet.
401
+ # **This data type has been expanded to use with the Amazon GameLift
402
+ # containers feature, which is currently in public preview.**
403
+ #
404
+ # An Amazon GameLift compute resource for hosting your game servers.
405
+ # Computes in an Amazon GameLift fleet differs depending on the fleet's
406
+ # compute type property as follows:
407
+ #
408
+ # * For `EC2` fleets, a compute is an EC2 instance.
409
+ #
410
+ # * For `ANYWHERE` fleets, a compute is a computing resource that you
411
+ # provide and is registered to the fleet.
412
+ #
413
+ # * For `CONTAINER` fleets, a compute is a container that's registered
414
+ # to the fleet.
402
415
  #
403
416
  # @!attribute [rw] fleet_id
404
417
  # A unique identifier for the fleet that the compute belongs to.
@@ -411,13 +424,14 @@ module Aws::GameLift
411
424
  #
412
425
  # @!attribute [rw] compute_name
413
426
  # A descriptive label for the compute resource. For instances in a
414
- # managed EC2 fleet, the compute name is an instance ID.
427
+ # managed EC2 fleet, the compute name is the same value as the
428
+ # `InstanceId` ID.
415
429
  # @return [String]
416
430
  #
417
431
  # @!attribute [rw] compute_arn
418
432
  # The ARN that is assigned to a compute resource and uniquely
419
433
  # identifies it. ARNs are unique across locations. Instances in
420
- # managed EC2 fleets are not assigned a ComputeARN.
434
+ # managed EC2 fleets are not assigned a Compute ARN.
421
435
  # @return [String]
422
436
  #
423
437
  # @!attribute [rw] ip_address
@@ -440,59 +454,1051 @@ module Aws::GameLift
440
454
  # compute resource resides in.
441
455
  # @return [String]
442
456
  #
443
- # @!attribute [rw] creation_time
444
- # A time stamp indicating when this data object was created. Format is
445
- # a number expressed in Unix time as milliseconds (for example
446
- # `"1469498468.057"`).
447
- # @return [Time]
457
+ # @!attribute [rw] creation_time
458
+ # A time stamp indicating when this data object was created. Format is
459
+ # a number expressed in Unix time as milliseconds (for example
460
+ # `"1469498468.057"`).
461
+ # @return [Time]
462
+ #
463
+ # @!attribute [rw] operating_system
464
+ # The type of operating system on the compute resource.
465
+ # @return [String]
466
+ #
467
+ # @!attribute [rw] type
468
+ # The Amazon EC2 instance type that the fleet uses. For registered
469
+ # computes in an Amazon GameLift Anywhere fleet, this property is
470
+ # empty.
471
+ # @return [String]
472
+ #
473
+ # @!attribute [rw] game_lift_service_sdk_endpoint
474
+ # The Amazon GameLift SDK endpoint connection for a registered compute
475
+ # resource in an Anywhere fleet. The game servers on the compute use
476
+ # this endpoint to connect to the Amazon GameLift service.
477
+ # @return [String]
478
+ #
479
+ # @!attribute [rw] game_lift_agent_endpoint
480
+ # The endpoint of the Amazon GameLift Agent.
481
+ # @return [String]
482
+ #
483
+ # @!attribute [rw] instance_id
484
+ # The `InstanceID` of the `Instance` hosting the compute for Container
485
+ # and Managed EC2 fleets.
486
+ # @return [String]
487
+ #
488
+ # @!attribute [rw] container_attributes
489
+ # Some attributes of a container.
490
+ # @return [Types::ContainerAttributes]
491
+ #
492
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/Compute AWS API Documentation
493
+ #
494
+ class Compute < Struct.new(
495
+ :fleet_id,
496
+ :fleet_arn,
497
+ :compute_name,
498
+ :compute_arn,
499
+ :ip_address,
500
+ :dns_name,
501
+ :compute_status,
502
+ :location,
503
+ :creation_time,
504
+ :operating_system,
505
+ :type,
506
+ :game_lift_service_sdk_endpoint,
507
+ :game_lift_agent_endpoint,
508
+ :instance_id,
509
+ :container_attributes)
510
+ SENSITIVE = [:ip_address]
511
+ include Aws::Structure
512
+ end
513
+
514
+ # The requested operation would cause a conflict with the current state
515
+ # of a service resource associated with the request. Resolve the
516
+ # conflict before retrying this request.
517
+ #
518
+ # @!attribute [rw] message
519
+ # @return [String]
520
+ #
521
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ConflictException AWS API Documentation
522
+ #
523
+ class ConflictException < Struct.new(
524
+ :message)
525
+ SENSITIVE = []
526
+ include Aws::Structure
527
+ end
528
+
529
+ # **This operation has been expanded to use with the Amazon GameLift
530
+ # containers feature, which is currently in public preview.**
531
+ #
532
+ # The set of port numbers to open on each instance in a container fleet.
533
+ # Connection ports are used by inbound traffic to connect with processes
534
+ # that are running in containers on the fleet.
535
+ #
536
+ # **Part of:** ContainerGroupsConfiguration, ContainerGroupsAttributes
537
+ #
538
+ # @!attribute [rw] from_port
539
+ # Starting value for the port range.
540
+ # @return [Integer]
541
+ #
542
+ # @!attribute [rw] to_port
543
+ # Ending value for the port. Port numbers are end-inclusive. This
544
+ # value must be equal to or greater than `FromPort`.
545
+ # @return [Integer]
546
+ #
547
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ConnectionPortRange AWS API Documentation
548
+ #
549
+ class ConnectionPortRange < Struct.new(
550
+ :from_port,
551
+ :to_port)
552
+ SENSITIVE = [:from_port, :to_port]
553
+ include Aws::Structure
554
+ end
555
+
556
+ # **This data type is used with the Amazon GameLift containers feature,
557
+ # which is currently in public preview.**
558
+ #
559
+ # Describes attributes of containers that are deployed to a fleet with
560
+ # compute type `CONTAINER`.
561
+ #
562
+ # @!attribute [rw] container_port_mappings
563
+ # Describes how container ports map to connection ports on the fleet
564
+ # instance. Incoming traffic connects to a game via a connection port.
565
+ # A `ContainerPortMapping` directs the traffic from a connection port
566
+ # to a port on the container that hosts the game session.
567
+ # @return [Array<Types::ContainerPortMapping>]
568
+ #
569
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerAttributes AWS API Documentation
570
+ #
571
+ class ContainerAttributes < Struct.new(
572
+ :container_port_mappings)
573
+ SENSITIVE = []
574
+ include Aws::Structure
575
+ end
576
+
577
+ # **This data type is used with the Amazon GameLift containers feature,
578
+ # which is currently in public preview.**
579
+ #
580
+ # Describes a container in a container fleet, the resources available to
581
+ # the container, and the commands that are run when the container
582
+ # starts. Container properties can't be updated. To change a property,
583
+ # create a new container group definition. See also
584
+ # ContainerDefinitionInput.
585
+ #
586
+ # **Part of:** ContainerGroupDefinition
587
+ #
588
+ # **Returned by:** DescribeContainerGroupDefinition,
589
+ # ListContainerGroupDefinitions
590
+ #
591
+ # @!attribute [rw] container_name
592
+ # The container definition identifier. Container names are unique
593
+ # within a container group definition.
594
+ # @return [String]
595
+ #
596
+ # @!attribute [rw] image_uri
597
+ # The URI to the image that $short; copied and deployed to a container
598
+ # fleet. For a more specific identifier, see `ResolvedImageDigest`.
599
+ # @return [String]
600
+ #
601
+ # @!attribute [rw] resolved_image_digest
602
+ # A unique and immutable identifier for the container image that is
603
+ # deployed to a container fleet. The digest is a SHA 256 hash of the
604
+ # container image manifest.
605
+ # @return [String]
606
+ #
607
+ # @!attribute [rw] memory_limits
608
+ # The amount of memory that Amazon GameLift makes available to the
609
+ # container. If memory limits aren't set for an individual container,
610
+ # the container shares the container group's total memory allocation.
611
+ #
612
+ # <b>Related data type: </b> ContainerGroupDefinition$TotalMemoryLimit
613
+ # @return [Types::ContainerMemoryLimits]
614
+ #
615
+ # @!attribute [rw] port_configuration
616
+ # Defines the ports that are available to assign to processes in the
617
+ # container. For example, a game server process requires a container
618
+ # port to allow game clients to connect to it. Container ports aren't
619
+ # directly accessed by inbound traffic. Amazon GameLift maps these
620
+ # container ports to externally accessible connection ports, which are
621
+ # assigned as needed from the container fleet's
622
+ # `ConnectionPortRange`.
623
+ # @return [Types::ContainerPortConfiguration]
624
+ #
625
+ # @!attribute [rw] cpu
626
+ # The number of CPU units that are reserved for the container. Note: 1
627
+ # vCPU unit equals 1024 CPU units. If no resources are reserved, the
628
+ # container shares the total CPU limit for the container group.
629
+ #
630
+ # <b>Related data type: </b> ContainerGroupDefinition$TotalCpuLimit
631
+ # @return [Integer]
632
+ #
633
+ # @!attribute [rw] health_check
634
+ # A configuration for a non-terminal health check. A container, which
635
+ # automatically restarts if it stops functioning, also restarts if it
636
+ # fails this health check. If an essential container in the daemon
637
+ # group fails a health check, the entire container group is restarted.
638
+ # The essential container in the replica group doesn't use this
639
+ # health check mechanism, because the Amazon GameLift Agent
640
+ # automatically handles the task.
641
+ # @return [Types::ContainerHealthCheck]
642
+ #
643
+ # @!attribute [rw] command
644
+ # A command that's passed to the container on startup. Each argument
645
+ # for the command is an additional string in the array. See the
646
+ # [ContainerDefinition::command][1] parameter in the *Amazon Elastic
647
+ # Container Service API reference.*
648
+ #
649
+ #
650
+ #
651
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-command
652
+ # @return [Array<String>]
653
+ #
654
+ # @!attribute [rw] essential
655
+ # Indicates whether the container is vital to the container group. If
656
+ # an essential container fails, the entire container group is
657
+ # restarted.
658
+ # @return [Boolean]
659
+ #
660
+ # @!attribute [rw] entry_point
661
+ # The entry point that's passed to the container on startup. If there
662
+ # are multiple arguments, each argument is an additional string in the
663
+ # array. See the [ContainerDefinition::entryPoint][1] parameter in the
664
+ # *Amazon Elastic Container Service API Reference*.
665
+ #
666
+ #
667
+ #
668
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-entryPoint
669
+ # @return [Array<String>]
670
+ #
671
+ # @!attribute [rw] working_directory
672
+ # The directory in the container where commands are run. See the
673
+ # [ContainerDefinition::workingDirectory][1] parameter in the *Amazon
674
+ # Elastic Container Service API Reference*.
675
+ #
676
+ #
677
+ #
678
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-workingDirectory
679
+ # @return [String]
680
+ #
681
+ # @!attribute [rw] environment
682
+ # A set of environment variables that's passed to the container on
683
+ # startup. See the [ContainerDefinition::environment][1] parameter in
684
+ # the *Amazon Elastic Container Service API Reference*.
685
+ #
686
+ #
687
+ #
688
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-environment
689
+ # @return [Array<Types::ContainerEnvironment>]
690
+ #
691
+ # @!attribute [rw] depends_on
692
+ # Indicates that the container relies on the status of other
693
+ # containers in the same container group during its startup and
694
+ # shutdown sequences. A container might have dependencies on multiple
695
+ # containers.
696
+ # @return [Array<Types::ContainerDependency>]
697
+ #
698
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerDefinition AWS API Documentation
699
+ #
700
+ class ContainerDefinition < Struct.new(
701
+ :container_name,
702
+ :image_uri,
703
+ :resolved_image_digest,
704
+ :memory_limits,
705
+ :port_configuration,
706
+ :cpu,
707
+ :health_check,
708
+ :command,
709
+ :essential,
710
+ :entry_point,
711
+ :working_directory,
712
+ :environment,
713
+ :depends_on)
714
+ SENSITIVE = []
715
+ include Aws::Structure
716
+ end
717
+
718
+ # **This data type is used with the Amazon GameLift containers feature,
719
+ # which is currently in public preview.**
720
+ #
721
+ # Describes a container's configuration, resources, and start
722
+ # instructions. Use this data type to create a container group
723
+ # definition. For the properties of a container that's been deployed to
724
+ # a fleet, see ContainerDefinition. You can't change these properties
725
+ # after you've created the container group definition. If you need a
726
+ # container group with different properties, then you must create a new
727
+ # one.
728
+ #
729
+ # <b>Used with: </b> CreateContainerGroupDefinition
730
+ #
731
+ # @!attribute [rw] container_name
732
+ # A string that uniquely identifies the container definition within a
733
+ # container group.
734
+ # @return [String]
735
+ #
736
+ # @!attribute [rw] image_uri
737
+ # The location of a container image that $short; will copy and deploy
738
+ # to a container fleet. Images in Amazon Elastic Container Registry
739
+ # private repositories are supported. The repository must be in the
740
+ # same Amazon Web Services account and Amazon Web Services Region
741
+ # where you're creating the container group definition. For limits on
742
+ # image size, see [Amazon GameLift endpoints and quotas][1]. You can
743
+ # use any of the following image URI formats:
744
+ #
745
+ # * Image ID only: `[AWS account].dkr.ecr.[AWS
746
+ # region].amazonaws.com/[repository ID]`
747
+ #
748
+ # * Image ID and digest: `[AWS account].dkr.ecr.[AWS
749
+ # region].amazonaws.com/[repository ID]@[digest]`
750
+ #
751
+ # * Image ID and tag: `[AWS account].dkr.ecr.[AWS
752
+ # region].amazonaws.com/[repository ID]:[tag]`
753
+ #
754
+ #
755
+ #
756
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/gamelift.html
757
+ # @return [String]
758
+ #
759
+ # @!attribute [rw] memory_limits
760
+ # The amount of memory to make available to the container. If you
761
+ # don't specify memory limits for this container, then it shares the
762
+ # container group's total memory allocation.
763
+ #
764
+ # <b>Related data type: </b> ContainerGroupDefinition$TotalMemoryLimit
765
+ # @return [Types::ContainerMemoryLimits]
766
+ #
767
+ # @!attribute [rw] port_configuration
768
+ # A set of ports that Amazon GameLift can assign to processes in the
769
+ # container. All processes that accept inbound traffic connections,
770
+ # including game server processes, must be assigned a port from this
771
+ # set. The set of ports must be large enough to assign one to each
772
+ # process in the container that needs one. If the container includes
773
+ # your game server, include enough ports to assign one port to each
774
+ # concurrent server process (as defined in a container fleet's
775
+ # RuntimeConfiguration). For more details, see [Networking for
776
+ # container fleets][1].
777
+ #
778
+ # Container ports aren't directly accessed by inbound traffic. Amazon
779
+ # GameLift maps these container ports to externally accessible
780
+ # connection ports, which are assigned as needed from the container
781
+ # fleet's `ConnectionPortRange`.
782
+ #
783
+ #
784
+ #
785
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-network
786
+ # @return [Types::ContainerPortConfiguration]
787
+ #
788
+ # @!attribute [rw] cpu
789
+ # The number of CPU units to reserve for this container. The container
790
+ # can use more resources when needed, if available. Note: 1 vCPU unit
791
+ # equals 1024 CPU units. If you don't reserve CPU units for this
792
+ # container, then it shares the total CPU limit for the container
793
+ # group. This property is similar to the Amazon ECS container
794
+ # definition parameter [environment][1] (*Amazon Elastic Container
795
+ # Service Developer Guide).*
796
+ #
797
+ # <b>Related data type: </b> ContainerGroupDefinition$TotalCpuLimit
798
+ #
799
+ #
800
+ #
801
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_environment
802
+ # @return [Integer]
803
+ #
804
+ # @!attribute [rw] health_check
805
+ # Configuration for a non-terminal health check. A container
806
+ # automatically restarts if it stops functioning. This parameter lets
807
+ # you define additional reasons to consider a container unhealthy and
808
+ # restart it. You can set a health check for any container except for
809
+ # the essential container in the replica container group. If an
810
+ # essential container in the daemon group fails a health check, the
811
+ # entire container group is restarted.
812
+ # @return [Types::ContainerHealthCheck]
813
+ #
814
+ # @!attribute [rw] command
815
+ # A command to pass to the container on startup. Add multiple
816
+ # arguments as additional strings in the array. See the
817
+ # [ContainerDefinition command][1] parameter in the *Amazon Elastic
818
+ # Container Service API reference.*
819
+ #
820
+ #
821
+ #
822
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-command
823
+ # @return [Array<String>]
824
+ #
825
+ # @!attribute [rw] essential
826
+ # Specifies whether the container is vital for the container group to
827
+ # function properly. If an essential container fails, it causes the
828
+ # entire container group to restart. Each container group must have an
829
+ # essential container.
830
+ #
831
+ # **Replica container groups** - A replica group must have exactly one
832
+ # essential container. Use the following to configure an essential
833
+ # replica container:
834
+ #
835
+ # * Choose a container is running your game server and the Amazon
836
+ # GameLift Agent.
837
+ #
838
+ # * Include a port configuration. This container runs your game server
839
+ # processes, and each process requires a container port to allow
840
+ # access to game clients.
841
+ #
842
+ # * Don't configure a health check. The Agent handles this task for
843
+ # the essential replica container.
844
+ #
845
+ # **Daemon container groups** - A daemon group must have at least one
846
+ # essential container.
847
+ # @return [Boolean]
848
+ #
849
+ # @!attribute [rw] entry_point
850
+ # An entry point to pass to the container on startup. Add multiple
851
+ # arguments as additional strings in the array. See the
852
+ # [ContainerDefinition::entryPoint][1] parameter in the *Amazon
853
+ # Elastic Container Service API Reference*.
854
+ #
855
+ #
856
+ #
857
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-entryPoint
858
+ # @return [Array<String>]
859
+ #
860
+ # @!attribute [rw] working_directory
861
+ # The directory in the container where commands are run. See the
862
+ # [ContainerDefinition::workingDirectory parameter][1] in the *Amazon
863
+ # Elastic Container Service API Reference*.
864
+ #
865
+ #
866
+ #
867
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-workingDirectory
868
+ # @return [String]
869
+ #
870
+ # @!attribute [rw] environment
871
+ # A set of environment variables to pass to the container on startup.
872
+ # See the [ContainerDefinition::environment][1] parameter in the
873
+ # *Amazon Elastic Container Service API Reference*.
874
+ #
875
+ #
876
+ #
877
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_ContainerDefinition.html#ECS-Type-ContainerDefinition-environment
878
+ # @return [Array<Types::ContainerEnvironment>]
879
+ #
880
+ # @!attribute [rw] depends_on
881
+ # Sets up dependencies between this container and the status of other
882
+ # containers in the same container group. A container can have
883
+ # dependencies on multiple different containers.
884
+ #
885
+ # You can use dependencies to establish a startup/shutdown sequence
886
+ # across the container group. A container startup dependency is
887
+ # reversed on shutdown.
888
+ #
889
+ # For example, you might specify that SideCarContainerB has a `START`
890
+ # dependency on SideCarContainerA. This dependency means that
891
+ # SideCarContainerB can't start until after SideCarContainerA has
892
+ # started. This dependency is reversed on shutdown, which means that
893
+ # SideCarContainerB must shut down before SideCarContainerA can shut
894
+ # down.
895
+ # @return [Array<Types::ContainerDependency>]
896
+ #
897
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerDefinitionInput AWS API Documentation
898
+ #
899
+ class ContainerDefinitionInput < Struct.new(
900
+ :container_name,
901
+ :image_uri,
902
+ :memory_limits,
903
+ :port_configuration,
904
+ :cpu,
905
+ :health_check,
906
+ :command,
907
+ :essential,
908
+ :entry_point,
909
+ :working_directory,
910
+ :environment,
911
+ :depends_on)
912
+ SENSITIVE = []
913
+ include Aws::Structure
914
+ end
915
+
916
+ # **This data type is used with the Amazon GameLift containers feature,
917
+ # which is currently in public preview.**
918
+ #
919
+ # A container's dependency on another container in the same container
920
+ # group. The dependency impacts how the dependent container is able to
921
+ # start or shut down based the status of the other container.
922
+ #
923
+ # For example, ContainerA is configured with the following dependency: a
924
+ # `START` dependency on ContainerB. This means that ContainerA can't
925
+ # start until ContainerB has started. It also means that ContainerA must
926
+ # shut down before ContainerB.
927
+ #
928
+ # **Part of:** ContainerDefinition
929
+ #
930
+ # @!attribute [rw] container_name
931
+ # A descriptive label for the container definition that this container
932
+ # depends on.
933
+ # @return [String]
934
+ #
935
+ # @!attribute [rw] condition
936
+ # The condition that the dependency container must reach before the
937
+ # dependent container can start. Valid conditions include:
938
+ #
939
+ # * START - The dependency container must have started.
940
+ #
941
+ # * COMPLETE - The dependency container has run to completion (exits).
942
+ # Use this condition with nonessential containers, such as those
943
+ # that run a script and then exit. The dependency container can't
944
+ # be an essential container.
945
+ #
946
+ # * SUCCESS - The dependency container has run to completion and
947
+ # exited with a zero status. The dependency container can't be an
948
+ # essential container.
949
+ #
950
+ # * HEALTHY - The dependency container has passed its Docker health
951
+ # check. Use this condition with dependency containers that have
952
+ # health checks configured. This condition is confirmed at container
953
+ # group startup only.
954
+ # @return [String]
955
+ #
956
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerDependency AWS API Documentation
957
+ #
958
+ class ContainerDependency < Struct.new(
959
+ :container_name,
960
+ :condition)
961
+ SENSITIVE = []
962
+ include Aws::Structure
963
+ end
964
+
965
+ # **This data type is used with the Amazon GameLift containers feature,
966
+ # which is currently in public preview.**
967
+ #
968
+ # An environment variable to set inside a container, in the form of a
969
+ # key-value pair.
970
+ #
971
+ # <b>Related data type: </b> ContainerDefinition$Environment
972
+ #
973
+ # @!attribute [rw] name
974
+ # The environment variable name.
975
+ # @return [String]
976
+ #
977
+ # @!attribute [rw] value
978
+ # The environment variable value.
979
+ # @return [String]
980
+ #
981
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerEnvironment AWS API Documentation
982
+ #
983
+ class ContainerEnvironment < Struct.new(
984
+ :name,
985
+ :value)
986
+ SENSITIVE = []
987
+ include Aws::Structure
988
+ end
989
+
990
+ # **This data type is used with the Amazon GameLift containers feature,
991
+ # which is currently in public preview.**
992
+ #
993
+ # The properties that describe a container group resource. Container
994
+ # group definition properties can't be updated. To change a property,
995
+ # create a new container group definition.
996
+ #
997
+ # **Used with:** CreateContainerGroupDefinition
998
+ #
999
+ # **Returned by:** DescribeContainerGroupDefinition,
1000
+ # ListContainerGroupDefinitions
1001
+ #
1002
+ # @!attribute [rw] container_group_definition_arn
1003
+ # The Amazon Resource Name ([ARN][1]) that is assigned to an Amazon
1004
+ # GameLift `ContainerGroupDefinition` resource. It uniquely identifies
1005
+ # the resource across all Amazon Web Services Regions. Format is
1006
+ # `arn:aws:gamelift:<region>::containergroupdefinition/[container
1007
+ # group definition name]`.
1008
+ #
1009
+ #
1010
+ #
1011
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-arn-format.html
1012
+ # @return [String]
1013
+ #
1014
+ # @!attribute [rw] creation_time
1015
+ # A time stamp indicating when this data object was created. Format is
1016
+ # a number expressed in Unix time as milliseconds (for example
1017
+ # `"1469498468.057"`).
1018
+ # @return [Time]
1019
+ #
1020
+ # @!attribute [rw] operating_system
1021
+ # The platform required for all containers in the container group
1022
+ # definition.
1023
+ # @return [String]
1024
+ #
1025
+ # @!attribute [rw] name
1026
+ # A descriptive identifier for the container group definition. The
1027
+ # name value is unique in an Amazon Web Services Region.
1028
+ # @return [String]
1029
+ #
1030
+ # @!attribute [rw] scheduling_strategy
1031
+ # The method for deploying the container group across fleet instances.
1032
+ # A replica container group might have multiple copies on each fleet
1033
+ # instance. A daemon container group maintains only one copy per fleet
1034
+ # instance.
1035
+ # @return [String]
1036
+ #
1037
+ # @!attribute [rw] total_memory_limit
1038
+ # The amount of memory (in MiB) on a fleet instance to allocate for
1039
+ # the container group. All containers in the group share these
1040
+ # resources.
1041
+ #
1042
+ # You can set additional limits for each ContainerDefinition in the
1043
+ # group. If individual containers have limits, this value must meet
1044
+ # the following requirements:
1045
+ #
1046
+ # * Equal to or greater than the sum of all container-specific soft
1047
+ # memory limits in the group.
1048
+ #
1049
+ # * Equal to or greater than any container-specific hard limits in the
1050
+ # group.
1051
+ #
1052
+ # For more details on memory allocation, see the [Container fleet
1053
+ # design guide][1].
1054
+ #
1055
+ #
1056
+ #
1057
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-design-fleet
1058
+ # @return [Integer]
1059
+ #
1060
+ # @!attribute [rw] total_cpu_limit
1061
+ # The amount of CPU units on a fleet instance to allocate for the
1062
+ # container group. All containers in the group share these resources.
1063
+ # This property is an integer value in CPU units (1 vCPU is equal to
1064
+ # 1024 CPU units).
1065
+ #
1066
+ # You can set additional limits for each ContainerDefinition in the
1067
+ # group. If individual containers have limits, this value must be
1068
+ # equal to or greater than the sum of all container-specific CPU
1069
+ # limits in the group.
1070
+ #
1071
+ # For more details on memory allocation, see the [Container fleet
1072
+ # design guide][1].
1073
+ #
1074
+ #
1075
+ #
1076
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-design-fleet
1077
+ # @return [Integer]
1078
+ #
1079
+ # @!attribute [rw] container_definitions
1080
+ # The set of container definitions that are included in the container
1081
+ # group.
1082
+ # @return [Array<Types::ContainerDefinition>]
1083
+ #
1084
+ # @!attribute [rw] status
1085
+ # Current status of the container group definition resource. Values
1086
+ # include:
1087
+ #
1088
+ # * `COPYING` -- Amazon GameLift is in the process of making copies of
1089
+ # all container images that are defined in the group. While in this
1090
+ # state, the resource can't be used to create a container fleet.
1091
+ #
1092
+ # * `READY` -- Amazon GameLift has copied the registry images for all
1093
+ # containers that are defined in the group. You can use a container
1094
+ # group definition in this status to create a container fleet.
1095
+ #
1096
+ # * `FAILED` -- Amazon GameLift failed to create a valid container
1097
+ # group definition resource. For more details on the cause of the
1098
+ # failure, see `StatusReason`. A container group definition resource
1099
+ # in failed status will be deleted within a few minutes.
1100
+ # @return [String]
1101
+ #
1102
+ # @!attribute [rw] status_reason
1103
+ # Additional information about a container group definition that's in
1104
+ # `FAILED` status. Possible reasons include:
1105
+ #
1106
+ # * An internal issue prevented Amazon GameLift from creating the
1107
+ # container group definition resource. Delete the failed resource
1108
+ # and call CreateContainerGroupDefinitionagain.
1109
+ #
1110
+ # * An access-denied message means that you don't have permissions to
1111
+ # access the container image on ECR. See [ IAM permission
1112
+ # examples][1] for help setting up required IAM permissions for
1113
+ # Amazon GameLift.
1114
+ #
1115
+ # * The `ImageUri` value for at least one of the containers in the
1116
+ # container group definition was invalid or not found in the current
1117
+ # Amazon Web Services account.
1118
+ #
1119
+ # * At least one of the container images referenced in the container
1120
+ # group definition exceeds the allowed size. For size limits, see [
1121
+ # Amazon GameLift endpoints and quotas][2].
1122
+ #
1123
+ # * At least one of the container images referenced in the container
1124
+ # group definition uses a different operating system than the one
1125
+ # defined for the container group.
1126
+ #
1127
+ #
1128
+ #
1129
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-iam-policy-examples.html
1130
+ # [2]: https://docs.aws.amazon.com/general/latest/gr/gamelift.html
1131
+ # @return [String]
1132
+ #
1133
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerGroupDefinition AWS API Documentation
1134
+ #
1135
+ class ContainerGroupDefinition < Struct.new(
1136
+ :container_group_definition_arn,
1137
+ :creation_time,
1138
+ :operating_system,
1139
+ :name,
1140
+ :scheduling_strategy,
1141
+ :total_memory_limit,
1142
+ :total_cpu_limit,
1143
+ :container_definitions,
1144
+ :status,
1145
+ :status_reason)
1146
+ SENSITIVE = []
1147
+ include Aws::Structure
1148
+ end
1149
+
1150
+ # **This data type is used with the Amazon GameLift containers feature,
1151
+ # which is currently in public preview.**
1152
+ #
1153
+ # The properties of a container group that is deployed to a container
1154
+ # fleet.
1155
+ #
1156
+ # **Part of:** ContainerGroupsAttributes
1157
+ #
1158
+ # **Returned by:** DescribeFleetAttributes
1159
+ #
1160
+ # @!attribute [rw] scheduling_strategy
1161
+ # The method for scheduling and maintaining copies of the container
1162
+ # group across a container fleet.
1163
+ # @return [String]
1164
+ #
1165
+ # @!attribute [rw] container_group_definition_name
1166
+ # The unique identifier for the container group definition.
1167
+ # @return [String]
1168
+ #
1169
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerGroupDefinitionProperty AWS API Documentation
1170
+ #
1171
+ class ContainerGroupDefinitionProperty < Struct.new(
1172
+ :scheduling_strategy,
1173
+ :container_group_definition_name)
1174
+ SENSITIVE = []
1175
+ include Aws::Structure
1176
+ end
1177
+
1178
+ # **This data type is used with the Amazon GameLift containers feature,
1179
+ # which is currently in public preview.**
1180
+ #
1181
+ # The properties of container groups that are running on a container
1182
+ # fleet. Container group properties for a fleet can't be changed.
1183
+ #
1184
+ # **Returned by:** DescribeFleetAttributes, CreateFleet
1185
+ #
1186
+ # @!attribute [rw] container_group_definition_properties
1187
+ # A collection of properties that describe each container group in the
1188
+ # fleet. A container fleet is deployed with one or more
1189
+ # ContainerGroupDefinition resources, which is where these properties
1190
+ # are set.
1191
+ # @return [Array<Types::ContainerGroupDefinitionProperty>]
1192
+ #
1193
+ # @!attribute [rw] connection_port_range
1194
+ # A set of ports that allow inbound traffic to connect to processes
1195
+ # running in the fleet's container groups. Amazon GameLift maps each
1196
+ # connection port to a container port, which is assigned to a specific
1197
+ # container process. A fleet's connection port range can't be
1198
+ # changed, but you can control access to connection ports by updating
1199
+ # a fleet's `EC2InboundPermissions` with UpdateFleetPortSettings.
1200
+ # @return [Types::ConnectionPortRange]
1201
+ #
1202
+ # @!attribute [rw] container_groups_per_instance
1203
+ # Details about the number of replica container groups that Amazon
1204
+ # GameLift deploys to each instance in the container fleet.
1205
+ # @return [Types::ContainerGroupsPerInstance]
1206
+ #
1207
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerGroupsAttributes AWS API Documentation
1208
+ #
1209
+ class ContainerGroupsAttributes < Struct.new(
1210
+ :container_group_definition_properties,
1211
+ :connection_port_range,
1212
+ :container_groups_per_instance)
1213
+ SENSITIVE = []
1214
+ include Aws::Structure
1215
+ end
1216
+
1217
+ # **This data type is used with the Amazon GameLift containers feature,
1218
+ # which is currently in public preview.**
1219
+ #
1220
+ # Configuration details for a set of container groups, for use when
1221
+ # creating a fleet with compute type `CONTAINER`.
1222
+ #
1223
+ # **Used with:** CreateFleet
1224
+ #
1225
+ # @!attribute [rw] container_group_definition_names
1226
+ # The list of container group definition names to deploy to a new
1227
+ # container fleet.
1228
+ # @return [Array<String>]
1229
+ #
1230
+ # @!attribute [rw] connection_port_range
1231
+ # A set of ports to allow inbound traffic, including game clients, to
1232
+ # connect to processes running in the container fleet.
1233
+ #
1234
+ # Connection ports are dynamically mapped to container ports, which
1235
+ # are assigned to individual processes running in a container. The
1236
+ # connection port range must have enough ports to map to all container
1237
+ # ports across a fleet instance. To calculate the minimum connection
1238
+ # ports needed, use the following formula:
1239
+ #
1240
+ # *\[Total number of container ports as defined for containers in the
1241
+ # replica container group\] * \[Desired or calculated number of
1242
+ # replica container groups per instance\] + \[Total number of
1243
+ # container ports as defined for containers in the daemon container
1244
+ # group\]*
1245
+ #
1246
+ # As a best practice, double the minimum number of connection ports.
1247
+ #
1248
+ # <note markdown="1"> Use the fleet's `EC2InboundPermissions` property to control
1249
+ # external access to connection ports. Set this property to the
1250
+ # connection port numbers that you want to open access to. See
1251
+ # IpPermission for more details.
1252
+ #
1253
+ # </note>
1254
+ # @return [Types::ConnectionPortRange]
1255
+ #
1256
+ # @!attribute [rw] desired_replica_container_groups_per_instance
1257
+ # The number of times to replicate the replica container group on each
1258
+ # instance in a container fleet. By default, Amazon GameLift
1259
+ # calculates the maximum number of replica container groups that can
1260
+ # fit on a fleet instance (based on CPU and memory resources). Leave
1261
+ # this parameter empty if you want to use the maximum number, or
1262
+ # specify a desired number to override the maximum. The desired number
1263
+ # is used if it's less than the maximum number.
1264
+ # @return [Integer]
1265
+ #
1266
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerGroupsConfiguration AWS API Documentation
1267
+ #
1268
+ class ContainerGroupsConfiguration < Struct.new(
1269
+ :container_group_definition_names,
1270
+ :connection_port_range,
1271
+ :desired_replica_container_groups_per_instance)
1272
+ SENSITIVE = []
1273
+ include Aws::Structure
1274
+ end
1275
+
1276
+ # **This data type is used with the Amazon GameLift containers feature,
1277
+ # which is currently in public preview.**
1278
+ #
1279
+ # Determines how many replica container groups that Amazon GameLift
1280
+ # deploys to each instance in a container fleet.
1281
+ #
1282
+ # Amazon GameLift calculates the maximum possible replica groups per
1283
+ # instance based on the instance 's CPU and memory resources. When
1284
+ # deploying a fleet, Amazon GameLift places replica container groups on
1285
+ # each fleet instance based on the following:
1286
+ #
1287
+ # * If no desired value is set, Amazon GameLift places the calculated
1288
+ # maximum.
1289
+ #
1290
+ # * If a desired number is set to a value higher than the calculated
1291
+ # maximum, Amazon GameLift places the calculated maximum.
1292
+ #
1293
+ # * If a desired number is set to a value lower than the calculated
1294
+ # maximum, Amazon GameLift places the desired number.
1295
+ #
1296
+ # **Part of:** ContainerGroupsConfiguration, ContainerGroupsAttributes
1297
+ #
1298
+ # **Returned by:** DescribeFleetAttributes, CreateFleet
1299
+ #
1300
+ # @!attribute [rw] desired_replica_container_groups_per_instance
1301
+ # The desired number of replica container groups to place on each
1302
+ # fleet instance.
1303
+ # @return [Integer]
1304
+ #
1305
+ # @!attribute [rw] max_replica_container_groups_per_instance
1306
+ # The maximum possible number of replica container groups that each
1307
+ # fleet instance can have.
1308
+ # @return [Integer]
1309
+ #
1310
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerGroupsPerInstance AWS API Documentation
1311
+ #
1312
+ class ContainerGroupsPerInstance < Struct.new(
1313
+ :desired_replica_container_groups_per_instance,
1314
+ :max_replica_container_groups_per_instance)
1315
+ SENSITIVE = []
1316
+ include Aws::Structure
1317
+ end
1318
+
1319
+ # Instructions on when and how to check the health of a container in a
1320
+ # container fleet. When health check properties are set in a container
1321
+ # definition, they override any Docker health checks in the container
1322
+ # image. For more information on container health checks, see
1323
+ # [HealthCheck command][1] in the *Amazon Elastic Container Service
1324
+ # API*.
1325
+ #
1326
+ # The following example instructions tell the container to wait 100
1327
+ # seconds after launch before counting failed health checks, then
1328
+ # initiate the health check command every 60 seconds. After issuing the
1329
+ # health check command, wait 10 seconds for it to succeed. If it fails,
1330
+ # retry the command 3 times before considering the container to be
1331
+ # unhealthy.
1332
+ #
1333
+ # `\{"Command": [ "CMD-SHELL", "ps cax | grep "processmanager" || exit
1334
+ # 1" ], "Interval": 300, "Timeout": 30, "Retries": 5, "StartPeriod": 100
1335
+ # \}`
1336
+ #
1337
+ # **Part of:** ContainerDefinition$HealthCheck
1338
+ #
1339
+ #
1340
+ #
1341
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_HealthCheck.html#ECS-Type-HealthCheck-command
1342
+ #
1343
+ # @!attribute [rw] command
1344
+ # A string array that specifies the command that the container runs to
1345
+ # determine if it's healthy.
1346
+ # @return [Array<String>]
1347
+ #
1348
+ # @!attribute [rw] interval
1349
+ # The time period (in seconds) between each health check.
1350
+ # @return [Integer]
1351
+ #
1352
+ # @!attribute [rw] timeout
1353
+ # The time period (in seconds) to wait for a health check to succeed
1354
+ # before a failed health check is counted.
1355
+ # @return [Integer]
1356
+ #
1357
+ # @!attribute [rw] retries
1358
+ # The number of times to retry a failed health check before the
1359
+ # container is considered unhealthy. The first run of the command does
1360
+ # not count as a retry.
1361
+ # @return [Integer]
1362
+ #
1363
+ # @!attribute [rw] start_period
1364
+ # The optional grace period (in seconds) to give a container time to
1365
+ # bootstrap before the first failed health check counts toward the
1366
+ # number of retries.
1367
+ # @return [Integer]
1368
+ #
1369
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerHealthCheck AWS API Documentation
1370
+ #
1371
+ class ContainerHealthCheck < Struct.new(
1372
+ :command,
1373
+ :interval,
1374
+ :timeout,
1375
+ :retries,
1376
+ :start_period)
1377
+ SENSITIVE = []
1378
+ include Aws::Structure
1379
+ end
1380
+
1381
+ # Specifies how much memory is available to a container. You can't
1382
+ # change this value after you create this object.
1383
+ #
1384
+ # <b>Part of: </b> ContainerDefinition$MemoryLimits
1385
+ #
1386
+ # @!attribute [rw] soft_limit
1387
+ # The amount of memory that is reserved for a container. When the
1388
+ # container group's shared memory is under contention, the system
1389
+ # attempts to maintain the container memory usage at this soft limit.
1390
+ # However, the container can use more memory when needed, if
1391
+ # available. This property is similar to the Amazon ECS container
1392
+ # definition parameter [memoryreservation][1] (*Amazon Elastic
1393
+ # Container Service Developer Guide*).
1394
+ #
1395
+ #
1396
+ #
1397
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#ContainerDefinition-memoryReservation
1398
+ # @return [Integer]
1399
+ #
1400
+ # @!attribute [rw] hard_limit
1401
+ # The maximum amount of memory that the container can use. If a
1402
+ # container attempts to exceed this limit, the container is stopped.
1403
+ # This property is similar to the Amazon ECS container definition
1404
+ # parameter [memory][1] in the *Amazon Elastic Container Service
1405
+ # Developer Guide.*
1406
+ #
1407
+ #
1408
+ #
1409
+ # [1]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definition_parameters.html#container_definition_memory
1410
+ # @return [Integer]
1411
+ #
1412
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerMemoryLimits AWS API Documentation
1413
+ #
1414
+ class ContainerMemoryLimits < Struct.new(
1415
+ :soft_limit,
1416
+ :hard_limit)
1417
+ SENSITIVE = []
1418
+ include Aws::Structure
1419
+ end
1420
+
1421
+ # Defines ranges of ports that server processes can connect to.
1422
+ #
1423
+ # **Part of:** ContainerDefinition$PortConfiguration
1424
+ #
1425
+ # @!attribute [rw] container_port_ranges
1426
+ # Specifies one or more ranges of ports on a container. These ranges
1427
+ # must not overlap.
1428
+ # @return [Array<Types::ContainerPortRange>]
1429
+ #
1430
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerPortConfiguration AWS API Documentation
1431
+ #
1432
+ class ContainerPortConfiguration < Struct.new(
1433
+ :container_port_ranges)
1434
+ SENSITIVE = []
1435
+ include Aws::Structure
1436
+ end
1437
+
1438
+ # **This data type is used with the Amazon GameLift containers feature,
1439
+ # which is currently in public preview.**
1440
+ #
1441
+ # Defines how an internal-facing container port is mapped to an
1442
+ # external-facing connection port on a fleet instance of compute type
1443
+ # `CONTAINER`. Incoming traffic, such as a game client, uses a
1444
+ # connection port to connect to a process in the container fleet. Amazon
1445
+ # GameLift directs the inbound traffic to the container port that is
1446
+ # assigned to the process, such as a game session, running on a
1447
+ # container.
448
1448
  #
449
- # @!attribute [rw] operating_system
450
- # The type of operating system on the compute resource.
451
- # @return [String]
1449
+ # **Part of:** ContainerAttributes
452
1450
  #
453
- # @!attribute [rw] type
454
- # The Amazon EC2 instance type that the fleet uses. For registered
455
- # computes in an Amazon GameLift Anywhere fleet, this property is
456
- # empty.
457
- # @return [String]
1451
+ # @!attribute [rw] container_port
1452
+ # The port opened on the container.
1453
+ # @return [Integer]
458
1454
  #
459
- # @!attribute [rw] game_lift_service_sdk_endpoint
460
- # The Amazon GameLift SDK endpoint connection for a registered compute
461
- # resource in an Anywhere fleet. The game servers on the compute use
462
- # this endpoint to connect to the Amazon GameLift service.
1455
+ # @!attribute [rw] connection_port
1456
+ # The port opened on the fleet instance. This is also called the
1457
+ # "host port".
1458
+ # @return [Integer]
1459
+ #
1460
+ # @!attribute [rw] protocol
1461
+ # The network protocol that this mapping supports.
463
1462
  # @return [String]
464
1463
  #
465
- # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/Compute AWS API Documentation
1464
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerPortMapping AWS API Documentation
466
1465
  #
467
- class Compute < Struct.new(
468
- :fleet_id,
469
- :fleet_arn,
470
- :compute_name,
471
- :compute_arn,
472
- :ip_address,
473
- :dns_name,
474
- :compute_status,
475
- :location,
476
- :creation_time,
477
- :operating_system,
478
- :type,
479
- :game_lift_service_sdk_endpoint)
480
- SENSITIVE = [:ip_address]
1466
+ class ContainerPortMapping < Struct.new(
1467
+ :container_port,
1468
+ :connection_port,
1469
+ :protocol)
1470
+ SENSITIVE = [:container_port, :connection_port]
481
1471
  include Aws::Structure
482
1472
  end
483
1473
 
484
- # The requested operation would cause a conflict with the current state
485
- # of a service resource associated with the request. Resolve the
486
- # conflict before retrying this request.
1474
+ # **This data type is used with the Amazon GameLift containers feature,
1475
+ # which is currently in public preview.**
487
1476
  #
488
- # @!attribute [rw] message
1477
+ # A set of one or more port numbers that can be opened on the container.
1478
+ #
1479
+ # **Part of:** ContainerPortConfiguration
1480
+ #
1481
+ # @!attribute [rw] from_port
1482
+ # A starting value for the range of allowed port numbers.
1483
+ # @return [Integer]
1484
+ #
1485
+ # @!attribute [rw] to_port
1486
+ # An ending value for the range of allowed port numbers. Port numbers
1487
+ # are end-inclusive. This value must be equal to or greater than
1488
+ # `FromPort`.
1489
+ # @return [Integer]
1490
+ #
1491
+ # @!attribute [rw] protocol
1492
+ # The network protocol that these ports support.
489
1493
  # @return [String]
490
1494
  #
491
- # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ConflictException AWS API Documentation
1495
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ContainerPortRange AWS API Documentation
492
1496
  #
493
- class ConflictException < Struct.new(
494
- :message)
495
- SENSITIVE = []
1497
+ class ContainerPortRange < Struct.new(
1498
+ :from_port,
1499
+ :to_port,
1500
+ :protocol)
1501
+ SENSITIVE = [:from_port, :to_port]
496
1502
  include Aws::Structure
497
1503
  end
498
1504
 
@@ -662,6 +1668,94 @@ module Aws::GameLift
662
1668
  include Aws::Structure
663
1669
  end
664
1670
 
1671
+ # @!attribute [rw] name
1672
+ # A descriptive identifier for the container group definition. The
1673
+ # name value must be unique in an Amazon Web Services Region.
1674
+ # @return [String]
1675
+ #
1676
+ # @!attribute [rw] scheduling_strategy
1677
+ # The method for deploying the container group across fleet instances.
1678
+ # A replica container group might have multiple copies on each fleet
1679
+ # instance. A daemon container group has one copy per fleet instance.
1680
+ # Default value is `REPLICA`.
1681
+ # @return [String]
1682
+ #
1683
+ # @!attribute [rw] total_memory_limit
1684
+ # The maximum amount of memory (in MiB) to allocate to the container
1685
+ # group. All containers in the group share this memory. If you specify
1686
+ # memory limits for individual containers, set this parameter based on
1687
+ # the following guidelines. The value must be (1) greater than the sum
1688
+ # of the soft memory limits for all containers in the group, and (2)
1689
+ # greater than any individual container's hard memory limit.
1690
+ # @return [Integer]
1691
+ #
1692
+ # @!attribute [rw] total_cpu_limit
1693
+ # The maximum amount of CPU units to allocate to the container group.
1694
+ # Set this parameter to an integer value in CPU units (1 vCPU is equal
1695
+ # to 1024 CPU units). All containers in the group share this memory.
1696
+ # If you specify CPU limits for individual containers, set this
1697
+ # parameter based on the following guidelines. The value must be equal
1698
+ # to or greater than the sum of the CPU limits for all containers in
1699
+ # the group.
1700
+ # @return [Integer]
1701
+ #
1702
+ # @!attribute [rw] container_definitions
1703
+ # Definitions for all containers in this group. Each container
1704
+ # definition identifies the container image and specifies
1705
+ # configuration settings for the container. See the [ Container fleet
1706
+ # design guide][1] for container guidelines.
1707
+ #
1708
+ #
1709
+ #
1710
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/containers-design-fleet.html
1711
+ # @return [Array<Types::ContainerDefinitionInput>]
1712
+ #
1713
+ # @!attribute [rw] operating_system
1714
+ # The platform that is used by containers in the container group
1715
+ # definition. All containers in a group must run on the same operating
1716
+ # system.
1717
+ # @return [String]
1718
+ #
1719
+ # @!attribute [rw] tags
1720
+ # A list of labels to assign to the container group definition
1721
+ # resource. Tags are developer-defined key-value pairs. Tagging Amazon
1722
+ # Web Services resources are useful for resource management, access
1723
+ # management and cost allocation. For more information, see [ Tagging
1724
+ # Amazon Web Services Resources][1] in the *Amazon Web Services
1725
+ # General Reference*.
1726
+ #
1727
+ #
1728
+ #
1729
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1730
+ # @return [Array<Types::Tag>]
1731
+ #
1732
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateContainerGroupDefinitionInput AWS API Documentation
1733
+ #
1734
+ class CreateContainerGroupDefinitionInput < Struct.new(
1735
+ :name,
1736
+ :scheduling_strategy,
1737
+ :total_memory_limit,
1738
+ :total_cpu_limit,
1739
+ :container_definitions,
1740
+ :operating_system,
1741
+ :tags)
1742
+ SENSITIVE = []
1743
+ include Aws::Structure
1744
+ end
1745
+
1746
+ # @!attribute [rw] container_group_definition
1747
+ # The properties of the newly created container group definition
1748
+ # resource. You use this resource to create a container fleet.
1749
+ # @return [Types::ContainerGroupDefinition]
1750
+ #
1751
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateContainerGroupDefinitionOutput AWS API Documentation
1752
+ #
1753
+ class CreateContainerGroupDefinitionOutput < Struct.new(
1754
+ :container_group_definition)
1755
+ SENSITIVE = []
1756
+ include Aws::Structure
1757
+ end
1758
+
665
1759
  # @!attribute [rw] name
666
1760
  # A descriptive label that is associated with a fleet. Fleet names do
667
1761
  # not need to be unique.
@@ -673,17 +1767,18 @@ module Aws::GameLift
673
1767
  #
674
1768
  # @!attribute [rw] build_id
675
1769
  # The unique identifier for a custom game server build to be deployed
676
- # on fleet instances. You can use either the build ID or ARN. The
677
- # build must be uploaded to Amazon GameLift and in `READY` status.
678
- # This fleet property can't be changed after the fleet is created.
1770
+ # to a fleet with compute type `EC2`. You can use either the build ID
1771
+ # or ARN. The build must be uploaded to Amazon GameLift and in `READY`
1772
+ # status. This fleet property can't be changed after the fleet is
1773
+ # created.
679
1774
  # @return [String]
680
1775
  #
681
1776
  # @!attribute [rw] script_id
682
1777
  # The unique identifier for a Realtime configuration script to be
683
- # deployed on fleet instances. You can use either the script ID or
684
- # ARN. Scripts must be uploaded to Amazon GameLift prior to creating
685
- # the fleet. This fleet property can't be changed after the fleet is
686
- # created.
1778
+ # deployed to a fleet with compute type `EC2`. You can use either the
1779
+ # script ID or ARN. Scripts must be uploaded to Amazon GameLift prior
1780
+ # to creating the fleet. This fleet property can't be changed after
1781
+ # the fleet is created.
687
1782
  # @return [String]
688
1783
  #
689
1784
  # @!attribute [rw] server_launch_path
@@ -712,8 +1807,8 @@ module Aws::GameLift
712
1807
  # @return [Array<String>]
713
1808
  #
714
1809
  # @!attribute [rw] ec2_instance_type
715
- # The Amazon GameLift-supported Amazon EC2 instance type to use for
716
- # all fleet instances. Instance type determines the computing
1810
+ # The Amazon GameLift-supported Amazon EC2 instance type to use with
1811
+ # EC2 and container fleets. Instance type determines the computing
717
1812
  # resources that will be used to host your game servers, including
718
1813
  # CPU, memory, storage, and networking capacity. See [Amazon Elastic
719
1814
  # Compute Cloud Instance Types][1] for detailed descriptions of Amazon
@@ -725,11 +1820,20 @@ module Aws::GameLift
725
1820
  # @return [String]
726
1821
  #
727
1822
  # @!attribute [rw] ec2_inbound_permissions
728
- # The allowed IP address ranges and port settings that allow inbound
729
- # traffic to access game sessions on this fleet. If the fleet is
730
- # hosting a custom game build, this property must be set before
731
- # players can connect to game sessions. For Realtime Servers fleets,
732
- # Amazon GameLift automatically sets TCP and UDP ranges.
1823
+ # The IP address ranges and port settings that allow inbound traffic
1824
+ # to access game server processes and other processes on this fleet.
1825
+ # Set this parameter for EC2 and container fleets. You can leave this
1826
+ # parameter empty when creating the fleet, but you must call
1827
+ # UpdateFleetPortSettings to set it before players can connect to game
1828
+ # sessions. As a best practice, we recommend opening ports for remote
1829
+ # access only when you need them and closing them when you're
1830
+ # finished. For Realtime Servers fleets, Amazon GameLift automatically
1831
+ # sets TCP and UDP ranges.
1832
+ #
1833
+ # To manage inbound access for a container fleet, set this parameter
1834
+ # to the same port numbers that you set for the fleet's connection
1835
+ # port range. During the life of the fleet, update this parameter to
1836
+ # control which connection ports are open to inbound traffic.
733
1837
  # @return [Array<Types::IpPermission>]
734
1838
  #
735
1839
  # @!attribute [rw] new_game_session_protection_policy
@@ -747,14 +1851,15 @@ module Aws::GameLift
747
1851
  # @return [String]
748
1852
  #
749
1853
  # @!attribute [rw] runtime_configuration
750
- # Instructions for how to launch and maintain server processes on
751
- # instances in the fleet. The runtime configuration defines one or
752
- # more server process configurations, each identifying a build
753
- # executable or Realtime script file and the number of processes of
754
- # that type to run concurrently.
755
- #
756
- # <note markdown="1"> The `RuntimeConfiguration` parameter is required unless the fleet is
757
- # being configured using the older parameters `ServerLaunchPath` and
1854
+ # Instructions for how to launch and run server processes on the
1855
+ # fleet. Set runtime configuration for EC2 fleets and container
1856
+ # fleets. For an Anywhere fleets, set this parameter only if the fleet
1857
+ # is running the Amazon GameLift Agent. The runtime configuration
1858
+ # defines one or more server process configurations. Each server
1859
+ # process identifies a game executable or Realtime script file and the
1860
+ # number of processes to run concurrently.
1861
+ #
1862
+ # <note markdown="1"> This parameter replaces the parameters `ServerLaunchPath` and
758
1863
  # `ServerLaunchParameters`, which are still supported for backward
759
1864
  # compatibility.
760
1865
  #
@@ -854,11 +1959,12 @@ module Aws::GameLift
854
1959
  # creating fleets in Amazon Web Services Regions that support multiple
855
1960
  # locations. You can add any Amazon GameLift-supported Amazon Web
856
1961
  # Services Region as a remote location, in the form of an Amazon Web
857
- # Services Region code such as `us-west-2`. To create a fleet with
858
- # instances in the home Region only, don't use this parameter.
1962
+ # Services Region code, such as `us-west-2` or Local Zone code. To
1963
+ # create a fleet with instances in the home Region only, don't set
1964
+ # this parameter.
859
1965
  #
860
- # To use this parameter, Amazon GameLift requires you to use your home
861
- # location in the request.
1966
+ # When using this parameter, Amazon GameLift requires you to include
1967
+ # your home location in the request.
862
1968
  # @return [Array<Types::LocationConfiguration>]
863
1969
  #
864
1970
  # @!attribute [rw] tags
@@ -875,10 +1981,20 @@ module Aws::GameLift
875
1981
  # @return [Array<Types::Tag>]
876
1982
  #
877
1983
  # @!attribute [rw] compute_type
878
- # The type of compute resource used to host your game servers. You can
879
- # use your own compute resources with Amazon GameLift Anywhere or use
880
- # Amazon EC2 instances with managed Amazon GameLift. By default, this
881
- # property is set to `EC2`.
1984
+ # The type of compute resource used to host your game servers.
1985
+ #
1986
+ # * `EC2` The game server build is deployed to Amazon EC2 instances
1987
+ # for cloud hosting. This is the default setting.
1988
+ #
1989
+ # * `CONTAINER` – Container images with your game server build and
1990
+ # supporting software are deployed to Amazon EC2 instances for cloud
1991
+ # hosting. With this compute type, you must specify the
1992
+ # `ContainerGroupsConfiguration` parameter.
1993
+ #
1994
+ # * `ANYWHERE` – Game servers or container images with your game
1995
+ # server and supporting software are deployed to compute resources
1996
+ # that are provided and managed by you. With this compute type, you
1997
+ # can also set the `AnywhereConfiguration` parameter.
882
1998
  # @return [String]
883
1999
  #
884
2000
  # @!attribute [rw] anywhere_configuration
@@ -887,19 +2003,28 @@ module Aws::GameLift
887
2003
  #
888
2004
  # @!attribute [rw] instance_role_credentials_provider
889
2005
  # Prompts Amazon GameLift to generate a shared credentials file for
890
- # the IAM role defined in `InstanceRoleArn`. The shared credentials
891
- # file is stored on each fleet instance and refreshed as needed. Use
892
- # shared credentials for applications that are deployed along with the
893
- # game server executable, if the game server is integrated with server
894
- # SDK version 5.x. For more information about using shared
895
- # credentials, see [ Communicate with other Amazon Web Services
896
- # resources from your fleets][1].
2006
+ # the IAM role that's defined in `InstanceRoleArn`. The shared
2007
+ # credentials file is stored on each fleet instance and refreshed as
2008
+ # needed. Use shared credentials for applications that are deployed
2009
+ # along with the game server executable, if the game server is
2010
+ # integrated with server SDK version 5.x. For more information about
2011
+ # using shared credentials, see [ Communicate with other Amazon Web
2012
+ # Services resources from your fleets][1].
897
2013
  #
898
2014
  #
899
2015
  #
900
2016
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
901
2017
  # @return [String]
902
2018
  #
2019
+ # @!attribute [rw] container_groups_configuration
2020
+ # The container groups to deploy to instances in the container fleet
2021
+ # and other fleet-level configuration settings. Use the
2022
+ # CreateContainerGroupDefinition action to create container groups. A
2023
+ # container fleet must have exactly one replica container group, and
2024
+ # can optionally have one daemon container group. You can't change
2025
+ # this property after you create the fleet.
2026
+ # @return [Types::ContainerGroupsConfiguration]
2027
+ #
903
2028
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/CreateFleetInput AWS API Documentation
904
2029
  #
905
2030
  class CreateFleetInput < Struct.new(
@@ -925,7 +2050,8 @@ module Aws::GameLift
925
2050
  :tags,
926
2051
  :compute_type,
927
2052
  :anywhere_configuration,
928
- :instance_role_credentials_provider)
2053
+ :instance_role_credentials_provider,
2054
+ :container_groups_configuration)
929
2055
  SENSITIVE = []
930
2056
  include Aws::Structure
931
2057
  end
@@ -1946,6 +3072,19 @@ module Aws::GameLift
1946
3072
  include Aws::Structure
1947
3073
  end
1948
3074
 
3075
+ # @!attribute [rw] name
3076
+ # The unique identifier for the container group definition to delete.
3077
+ # You can use either the `Name` or `ARN` value.
3078
+ # @return [String]
3079
+ #
3080
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeleteContainerGroupDefinitionInput AWS API Documentation
3081
+ #
3082
+ class DeleteContainerGroupDefinitionInput < Struct.new(
3083
+ :name)
3084
+ SENSITIVE = []
3085
+ include Aws::Structure
3086
+ end
3087
+
1949
3088
  # @!attribute [rw] fleet_id
1950
3089
  # A unique identifier for the fleet to be deleted. You can use either
1951
3090
  # the fleet ID or ARN value.
@@ -2215,8 +3354,11 @@ module Aws::GameLift
2215
3354
  # @return [String]
2216
3355
  #
2217
3356
  # @!attribute [rw] compute_name
2218
- # The name of the compute resource to remove from the specified
2219
- # Anywhere fleet.
3357
+ # The unique identifier of the compute resource to deregister. For an
3358
+ # Anywhere fleet compute, use the registered compute name. For a
3359
+ # container fleet, use the compute name (for example,
3360
+ # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
3361
+ # or the compute ARN.
2220
3362
  # @return [String]
2221
3363
  #
2222
3364
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DeregisterComputeInput AWS API Documentation
@@ -2302,14 +3444,17 @@ module Aws::GameLift
2302
3444
  end
2303
3445
 
2304
3446
  # @!attribute [rw] fleet_id
2305
- # A unique identifier for the fleet that the compute is registered to.
2306
- # You can use either the fleet ID or ARN value.
3447
+ # A unique identifier for the fleet that the compute belongs to. You
3448
+ # can use either the fleet ID or ARN value.
2307
3449
  # @return [String]
2308
3450
  #
2309
3451
  # @!attribute [rw] compute_name
2310
3452
  # The unique identifier of the compute resource to retrieve properties
2311
3453
  # for. For an Anywhere fleet compute, use the registered compute name.
2312
- # For a managed EC2 fleet instance, use the instance ID.
3454
+ # For an EC2 fleet instance, use the instance ID. For a container
3455
+ # fleet, use the compute name (for example,
3456
+ # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
3457
+ # or the compute ARN.
2313
3458
  # @return [String]
2314
3459
  #
2315
3460
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeComputeInput AWS API Documentation
@@ -2333,6 +3478,31 @@ module Aws::GameLift
2333
3478
  include Aws::Structure
2334
3479
  end
2335
3480
 
3481
+ # @!attribute [rw] name
3482
+ # The unique identifier for the container group definition to retrieve
3483
+ # properties for. You can use either the `Name` or `ARN` value.
3484
+ # @return [String]
3485
+ #
3486
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeContainerGroupDefinitionInput AWS API Documentation
3487
+ #
3488
+ class DescribeContainerGroupDefinitionInput < Struct.new(
3489
+ :name)
3490
+ SENSITIVE = []
3491
+ include Aws::Structure
3492
+ end
3493
+
3494
+ # @!attribute [rw] container_group_definition
3495
+ # The properties of the requested container group definition resource.
3496
+ # @return [Types::ContainerGroupDefinition]
3497
+ #
3498
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeContainerGroupDefinitionOutput AWS API Documentation
3499
+ #
3500
+ class DescribeContainerGroupDefinitionOutput < Struct.new(
3501
+ :container_group_definition)
3502
+ SENSITIVE = []
3503
+ include Aws::Structure
3504
+ end
3505
+
2336
3506
  # @!attribute [rw] ec2_instance_type
2337
3507
  # Name of an Amazon EC2 instance type that is supported in Amazon
2338
3508
  # GameLift. A fleet instance type determines the computing resources
@@ -3406,8 +4576,8 @@ module Aws::GameLift
3406
4576
  end
3407
4577
 
3408
4578
  # @!attribute [rw] runtime_configuration
3409
- # Instructions that describe how server processes should be launched
3410
- # and maintained on each instance in the fleet.
4579
+ # Instructions that describe how server processes are launched and
4580
+ # maintained on computes in the fleet.
3411
4581
  # @return [Types::RuntimeConfiguration]
3412
4582
  #
3413
4583
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/DescribeRuntimeConfigurationOutput AWS API Documentation
@@ -3894,6 +5064,10 @@ module Aws::GameLift
3894
5064
  # Amazon GameLift console.
3895
5065
  # @return [String]
3896
5066
  #
5067
+ # @!attribute [rw] count
5068
+ # The number of times that this event occurred.
5069
+ # @return [Integer]
5070
+ #
3897
5071
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/Event AWS API Documentation
3898
5072
  #
3899
5073
  class Event < Struct.new(
@@ -3902,7 +5076,8 @@ module Aws::GameLift
3902
5076
  :event_code,
3903
5077
  :message,
3904
5078
  :event_time,
3905
- :pre_signed_log_url)
5079
+ :pre_signed_log_url,
5080
+ :count)
3906
5081
  SENSITIVE = []
3907
5082
  include Aws::Structure
3908
5083
  end
@@ -3926,9 +5101,25 @@ module Aws::GameLift
3926
5101
  include Aws::Structure
3927
5102
  end
3928
5103
 
3929
- # Describes a Amazon GameLift fleet of game hosting resources.
5104
+ # **This operation has been expanded to use with the Amazon GameLift
5105
+ # containers feature, which is currently in public preview.**
3930
5106
  #
3931
- # **Related actions**
5107
+ # Describes an Amazon GameLift fleet of game hosting resources.
5108
+ # Attributes differ based on the fleet's compute type, as follows:
5109
+ #
5110
+ # * EC2 fleet attributes identify a `Build` resource (for fleets with
5111
+ # customer game server builds) or a `Script` resource (for Realtime
5112
+ # Servers fleets).
5113
+ #
5114
+ # * Container fleets have `ContainerGroupsAttributes`, which identify
5115
+ # the fleet's `ContainerGroupDefinition` resources.
5116
+ #
5117
+ # * Amazon GameLift Anywhere fleets have an abbreviated set of
5118
+ # attributes, because most fleet configurations are set directly on
5119
+ # the fleet's computes. Attributes include fleet identifiers and
5120
+ # descriptive properties, creation/termination time, and fleet status.
5121
+ #
5122
+ # **Returned by:** DescribeFleetAttributes
3932
5123
  #
3933
5124
  # @!attribute [rw] fleet_id
3934
5125
  # A unique identifier for the fleet.
@@ -3948,10 +5139,9 @@ module Aws::GameLift
3948
5139
  # @return [String]
3949
5140
  #
3950
5141
  # @!attribute [rw] fleet_type
3951
- # Indicates whether to use On-Demand or Spot instances for this fleet.
3952
- # By default, this property is set to `ON_DEMAND`. Learn more about
3953
- # when to use [ On-Demand versus Spot Instances][1]. This fleet
3954
- # property can't be changed after the fleet is created.
5142
+ # Indicates whether the fleet uses On-Demand or Spot instances. For
5143
+ # more information, see [ On-Demand versus Spot Instances][1]. This
5144
+ # fleet property can't be changed after the fleet is created.
3955
5145
  #
3956
5146
  #
3957
5147
  #
@@ -3959,10 +5149,12 @@ module Aws::GameLift
3959
5149
  # @return [String]
3960
5150
  #
3961
5151
  # @!attribute [rw] instance_type
3962
- # The Amazon EC2 instance type that determines the computing resources
3963
- # of each instance in the fleet. Instance type defines the CPU,
3964
- # memory, storage, and networking capacity. See [Amazon Elastic
3965
- # Compute Cloud Instance Types][1] for detailed descriptions.
5152
+ # The Amazon EC2 instance type that the fleet uses. Instance type
5153
+ # determines the computing resources of each instance in the fleet,
5154
+ # including CPU, memory, storage, and networking capacity. See [Amazon
5155
+ # Elastic Compute Cloud Instance Types][1] for detailed descriptions.
5156
+ # This attribute is used with fleets where `ComputeType` is "EC2" or
5157
+ # "Container".
3966
5158
  #
3967
5159
  #
3968
5160
  #
@@ -3994,33 +5186,35 @@ module Aws::GameLift
3994
5186
  # Current status of the fleet. Possible fleet statuses include the
3995
5187
  # following:
3996
5188
  #
3997
- # * **NEW** -- A new fleet has been defined and desired instances is
3998
- # set to 1.
5189
+ # * NEW -- A new fleet has been defined and desired instances is set
5190
+ # to 1.
3999
5191
  #
4000
- # * **DOWNLOADING/VALIDATING/BUILDING/ACTIVATING** -- Amazon GameLift
4001
- # is setting up the new fleet, creating new instances with the game
5192
+ # * DOWNLOADING/VALIDATING/BUILDING/ACTIVATING -- Amazon GameLift is
5193
+ # setting up the new fleet, creating new instances with the game
4002
5194
  # build or Realtime script and starting server processes.
4003
5195
  #
4004
- # * **ACTIVE** -- Hosts can now accept game sessions.
5196
+ # * ACTIVE -- Hosts can now accept game sessions.
4005
5197
  #
4006
- # * **ERROR** -- An error occurred when downloading, validating,
4007
- # building, or activating the fleet.
5198
+ # * ERROR -- An error occurred when downloading, validating, building,
5199
+ # or activating the fleet.
4008
5200
  #
4009
- # * **DELETING** -- Hosts are responding to a delete fleet request.
5201
+ # * DELETING -- Hosts are responding to a delete fleet request.
4010
5202
  #
4011
- # * **TERMINATED** -- The fleet no longer exists.
5203
+ # * TERMINATED -- The fleet no longer exists.
4012
5204
  # @return [String]
4013
5205
  #
4014
5206
  # @!attribute [rw] build_id
4015
5207
  # A unique identifier for the build resource that is deployed on
4016
- # instances in this fleet.
5208
+ # instances in this fleet. This attribute is used with fleets where
5209
+ # `ComputeType` is "EC2".
4017
5210
  # @return [String]
4018
5211
  #
4019
5212
  # @!attribute [rw] build_arn
4020
5213
  # The Amazon Resource Name ([ARN][1]) associated with the Amazon
4021
5214
  # GameLift build resource that is deployed on instances in this fleet.
4022
5215
  # In a GameLift build ARN, the resource ID matches the `BuildId`
4023
- # value.
5216
+ # value. This attribute is used with fleets where `ComputeType` is
5217
+ # "EC2".
4024
5218
  #
4025
5219
  #
4026
5220
  #
@@ -4029,7 +5223,8 @@ module Aws::GameLift
4029
5223
  #
4030
5224
  # @!attribute [rw] script_id
4031
5225
  # A unique identifier for the Realtime script resource that is
4032
- # deployed on instances in this fleet.
5226
+ # deployed on instances in this fleet. This attribute is used with
5227
+ # fleets where `ComputeType` is "EC2".
4033
5228
  # @return [String]
4034
5229
  #
4035
5230
  # @!attribute [rw] script_arn
@@ -4045,7 +5240,7 @@ module Aws::GameLift
4045
5240
  # @!attribute [rw] server_launch_path
4046
5241
  # **This parameter is no longer used.** Server launch paths are now
4047
5242
  # defined using the fleet's [RuntimeConfiguration][1] . Requests that
4048
- # use this parameter instead continue to be valid.
5243
+ # use this parameter continue to be valid.
4049
5244
  #
4050
5245
  #
4051
5246
  #
@@ -4055,7 +5250,7 @@ module Aws::GameLift
4055
5250
  # @!attribute [rw] server_launch_parameters
4056
5251
  # **This parameter is no longer used.** Server launch parameters are
4057
5252
  # now defined using the fleet's runtime configuration . Requests that
4058
- # use this parameter instead continue to be valid.
5253
+ # use this parameter continue to be valid.
4059
5254
  # @return [String]
4060
5255
  #
4061
5256
  # @!attribute [rw] log_paths
@@ -4071,7 +5266,8 @@ module Aws::GameLift
4071
5266
  #
4072
5267
  # @!attribute [rw] new_game_session_protection_policy
4073
5268
  # The type of game session protection to set on all new instances that
4074
- # are started in the fleet.
5269
+ # are started in the fleet. This attribute is used with fleets where
5270
+ # `ComputeType` is "EC2" or "Container".
4075
5271
  #
4076
5272
  # * **NoProtection** -- The game session can be terminated during a
4077
5273
  # scale-down event.
@@ -4083,7 +5279,8 @@ module Aws::GameLift
4083
5279
  # @!attribute [rw] operating_system
4084
5280
  # The operating system of the fleet's computing resources. A fleet's
4085
5281
  # operating system is determined by the OS of the build or script that
4086
- # is deployed on this fleet.
5282
+ # is deployed on this fleet. This attribute is used with fleets where
5283
+ # `ComputeType` is "EC2" or "Container".
4087
5284
  # @return [String]
4088
5285
  #
4089
5286
  # @!attribute [rw] resource_creation_limit_policy
@@ -4101,12 +5298,15 @@ module Aws::GameLift
4101
5298
  # Name of a metric group that metrics for this fleet are added to. In
4102
5299
  # Amazon CloudWatch, you can view aggregated metrics for fleets that
4103
5300
  # are in a metric group. A fleet can be included in only one metric
4104
- # group at a time.
5301
+ # group at a time. This attribute is used with fleets where
5302
+ # `ComputeType` is "EC2" or "Container".
4105
5303
  # @return [Array<String>]
4106
5304
  #
4107
5305
  # @!attribute [rw] stopped_actions
4108
5306
  # A list of fleet activity that has been suspended using
4109
- # [StopFleetActions][1] . This includes fleet auto-scaling.
5307
+ # [StopFleetActions][1]. This includes fleet auto-scaling. This
5308
+ # attribute is used with fleets where `ComputeType` is "EC2" or
5309
+ # "Container".
4110
5310
  #
4111
5311
  #
4112
5312
  #
@@ -4121,7 +5321,8 @@ module Aws::GameLift
4121
5321
  # Amazon Web Services resources that you own or have access to. For
4122
5322
  # more information about using the role with your game server builds,
4123
5323
  # see [ Communicate with other Amazon Web Services resources from your
4124
- # fleets][1].
5324
+ # fleets][1]. This attribute is used with fleets where `ComputeType`
5325
+ # is "EC2" or "Container".
4125
5326
  #
4126
5327
  #
4127
5328
  #
@@ -4131,13 +5332,7 @@ module Aws::GameLift
4131
5332
  # @!attribute [rw] certificate_configuration
4132
5333
  # Determines whether a TLS/SSL certificate is generated for a fleet.
4133
5334
  # This feature must be enabled when creating the fleet. All instances
4134
- # in a fleet share the same certificate. The certificate can be
4135
- # retrieved by calling the [Amazon GameLift Server SDK][1] operation
4136
- # `GetInstanceCertificate`.
4137
- #
4138
- #
4139
- #
4140
- # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/reference-serversdk.html
5335
+ # in a fleet share the same certificate.
4141
5336
  # @return [Types::CertificateConfiguration]
4142
5337
  #
4143
5338
  # @!attribute [rw] compute_type
@@ -4147,8 +5342,12 @@ module Aws::GameLift
4147
5342
  # @return [String]
4148
5343
  #
4149
5344
  # @!attribute [rw] anywhere_configuration
4150
- # Amazon GameLift Anywhere configuration options for your Anywhere
4151
- # fleets.
5345
+ # **This property is used with the Amazon GameLift containers feature,
5346
+ # which is currently in public preview.** A set of attributes that
5347
+ # describe the container groups that are deployed on the fleet. These
5348
+ # attributes are included for fleets with compute type `CONTAINER`
5349
+ # only. This attribute is used with fleets where `ComputeType` is
5350
+ # "Container".
4152
5351
  # @return [Types::AnywhereConfiguration]
4153
5352
  #
4154
5353
  # @!attribute [rw] instance_role_credentials_provider
@@ -4159,13 +5358,20 @@ module Aws::GameLift
4159
5358
  # property is used only when the game server is integrated with the
4160
5359
  # server SDK version 5.x. For more information about using shared
4161
5360
  # credentials, see [ Communicate with other Amazon Web Services
4162
- # resources from your fleets][1].
5361
+ # resources from your fleets][1]. This attribute is used with fleets
5362
+ # where `ComputeType` is "EC2" or "Container".
4163
5363
  #
4164
5364
  #
4165
5365
  #
4166
5366
  # [1]: https://docs.aws.amazon.com/gamelift/latest/developerguide/gamelift-sdk-server-resources.html
4167
5367
  # @return [String]
4168
5368
  #
5369
+ # @!attribute [rw] container_groups_attributes
5370
+ # A set of properties that describe the container groups that are
5371
+ # deployed to the fleet. These attributes are included for fleets with
5372
+ # compute type `CONTAINER`.
5373
+ # @return [Types::ContainerGroupsAttributes]
5374
+ #
4169
5375
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/FleetAttributes AWS API Documentation
4170
5376
  #
4171
5377
  class FleetAttributes < Struct.new(
@@ -4194,19 +5400,18 @@ module Aws::GameLift
4194
5400
  :certificate_configuration,
4195
5401
  :compute_type,
4196
5402
  :anywhere_configuration,
4197
- :instance_role_credentials_provider)
5403
+ :instance_role_credentials_provider,
5404
+ :container_groups_attributes)
4198
5405
  SENSITIVE = []
4199
5406
  include Aws::Structure
4200
5407
  end
4201
5408
 
4202
- # Current resource capacity settings in a specified fleet or location.
4203
- # The location value might refer to a fleet's remote location or its
4204
- # home Region.
4205
- #
4206
- # **Related actions**
5409
+ # Current resource capacity settings for managed EC2 fleets and
5410
+ # container fleets. For multi-location fleets, location values might
5411
+ # refer to a fleet's remote location or its home Region.
4207
5412
  #
4208
- # [DescribeFleetCapacity][1] \| [DescribeFleetLocationCapacity][2] \|
4209
- # [UpdateFleetCapacity][3]
5413
+ # **Returned by:** [DescribeFleetCapacity][1],
5414
+ # [DescribeFleetLocationCapacity][2], [UpdateFleetCapacity][3]
4210
5415
  #
4211
5416
  #
4212
5417
  #
@@ -4230,10 +5435,10 @@ module Aws::GameLift
4230
5435
  # @return [String]
4231
5436
  #
4232
5437
  # @!attribute [rw] instance_type
4233
- # The Amazon EC2 instance type that is used for all instances in a
4234
- # fleet. The instance type determines the computing resources in use,
4235
- # including CPU, memory, storage, and networking capacity. See [Amazon
4236
- # Elastic Compute Cloud Instance Types][1] for detailed descriptions.
5438
+ # The Amazon EC2 instance type that is used for instances in a fleet.
5439
+ # Instance type determines the computing resources in use, including
5440
+ # CPU, memory, storage, and networking capacity. See [Amazon Elastic
5441
+ # Compute Cloud Instance Types][1] for detailed descriptions.
4237
5442
  #
4238
5443
  #
4239
5444
  #
@@ -4241,10 +5446,10 @@ module Aws::GameLift
4241
5446
  # @return [String]
4242
5447
  #
4243
5448
  # @!attribute [rw] instance_counts
4244
- # Resource capacity settings. Fleet capacity is measured in Amazon EC2
4245
- # instances. Pending and terminating counts are non-zero when the
4246
- # fleet capacity is adjusting to a scaling event or if access to
4247
- # resources is temporarily affected.
5449
+ # The current number of instances in the fleet, listed by instance
5450
+ # status. Counts for pending and terminating instances might be
5451
+ # non-zero if the fleet is adjusting to a scaling event or if access
5452
+ # to resources is temporarily affected.
4248
5453
  # @return [Types::EC2InstanceCounts]
4249
5454
  #
4250
5455
  # @!attribute [rw] location
@@ -4252,6 +5457,12 @@ module Aws::GameLift
4252
5457
  # an Amazon Web Services Region code, such as `us-west-2`.
4253
5458
  # @return [String]
4254
5459
  #
5460
+ # @!attribute [rw] replica_container_group_counts
5461
+ # **This property is used with the Amazon GameLift containers feature,
5462
+ # which is currently in public preview.** The number and status of
5463
+ # replica container groups in a container fleet.
5464
+ # @return [Types::ReplicaContainerGroupCounts]
5465
+ #
4255
5466
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/FleetCapacity AWS API Documentation
4256
5467
  #
4257
5468
  class FleetCapacity < Struct.new(
@@ -4259,7 +5470,8 @@ module Aws::GameLift
4259
5470
  :fleet_arn,
4260
5471
  :instance_type,
4261
5472
  :instance_counts,
4262
- :location)
5473
+ :location,
5474
+ :replica_container_group_counts)
4263
5475
  SENSITIVE = []
4264
5476
  include Aws::Structure
4265
5477
  end
@@ -4281,9 +5493,7 @@ module Aws::GameLift
4281
5493
 
4282
5494
  # Current resource utilization statistics in a specified fleet or
4283
5495
  # location. The location value might refer to a fleet's remote location
4284
- # or its home Region.
4285
- #
4286
- # **Related actions**
5496
+ # or its home region.
4287
5497
  #
4288
5498
  # @!attribute [rw] fleet_id
4289
5499
  # A unique identifier for the fleet associated with the location.
@@ -5274,15 +6484,17 @@ module Aws::GameLift
5274
6484
  end
5275
6485
 
5276
6486
  # @!attribute [rw] fleet_id
5277
- # A unique identifier for the fleet that contains the compute resource
5278
- # you want to connect to. You can use either the fleet ID or ARN
6487
+ # A unique identifier for the fleet that holds the compute resource
6488
+ # that you want to connect to. You can use either the fleet ID or ARN
5279
6489
  # value.
5280
6490
  # @return [String]
5281
6491
  #
5282
6492
  # @!attribute [rw] compute_name
5283
6493
  # A unique identifier for the compute resource that you want to
5284
- # connect to. You can use either a registered compute name or an
5285
- # instance ID.
6494
+ # connect to. For an EC2 fleet compute, use the instance ID. For a
6495
+ # container fleet, use the compute name (for example,
6496
+ # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
6497
+ # or the compute ARN.
5286
6498
  # @return [String]
5287
6499
  #
5288
6500
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GetComputeAccessInput AWS API Documentation
@@ -5295,8 +6507,7 @@ module Aws::GameLift
5295
6507
  end
5296
6508
 
5297
6509
  # @!attribute [rw] fleet_id
5298
- # The ID of the fleet that contains the compute resource to be
5299
- # accessed.
6510
+ # The ID of the fleet that holds the compute resource to be accessed.
5300
6511
  # @return [String]
5301
6512
  #
5302
6513
  # @!attribute [rw] fleet_arn
@@ -5332,6 +6543,11 @@ module Aws::GameLift
5332
6543
  # (SSM).
5333
6544
  # @return [Types::AwsCredentials]
5334
6545
  #
6546
+ # @!attribute [rw] target
6547
+ # (For container fleets only) The instance ID where the compute
6548
+ # resource is running.
6549
+ # @return [String]
6550
+ #
5335
6551
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GetComputeAccessOutput AWS API Documentation
5336
6552
  #
5337
6553
  class GetComputeAccessOutput < Struct.new(
@@ -5339,7 +6555,8 @@ module Aws::GameLift
5339
6555
  :fleet_arn,
5340
6556
  :compute_name,
5341
6557
  :compute_arn,
5342
- :credentials)
6558
+ :credentials,
6559
+ :target)
5343
6560
  SENSITIVE = [:credentials]
5344
6561
  include Aws::Structure
5345
6562
  end
@@ -5350,7 +6567,11 @@ module Aws::GameLift
5350
6567
  #
5351
6568
  # @!attribute [rw] compute_name
5352
6569
  # The name of the compute resource you are requesting the
5353
- # authentication token for.
6570
+ # authentication token for. For an Anywhere fleet compute, use the
6571
+ # registered compute name. For an EC2 fleet instance, use the instance
6572
+ # ID. For a container fleet, use the compute name (for example,
6573
+ # `a123b456c789012d3e4567f8a901b23c/1a234b56-7cd8-9e0f-a1b2-c34d567ef8a9`)
6574
+ # or the compute ARN.
5354
6575
  # @return [String]
5355
6576
  #
5356
6577
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/GetComputeAuthTokenInput AWS API Documentation
@@ -5755,12 +6976,13 @@ module Aws::GameLift
5755
6976
  end
5756
6977
 
5757
6978
  # A range of IP addresses and port settings that allow inbound traffic
5758
- # to connect to server processes on an instance in a fleet. New game
5759
- # sessions are assigned an IP address/port number combination, which
5760
- # must fall into the fleet's allowed ranges. Fleets with custom game
5761
- # builds must have permissions explicitly set. For Realtime Servers
5762
- # fleets, Amazon GameLift automatically opens two port ranges, one for
5763
- # TCP messaging and one for UDP.
6979
+ # to connect to processes on an instance in a fleet. Processes are
6980
+ # assigned an IP address/port number combination, which must fall into
6981
+ # the fleet's allowed ranges. For container fleets, the port settings
6982
+ # must use the same port numbers as the fleet's connection ports.
6983
+ #
6984
+ # For Realtime Servers fleets, Amazon GameLift automatically opens two
6985
+ # port ranges, one for TCP messaging and one for UDP.
5764
6986
  #
5765
6987
  # @!attribute [rw] from_port
5766
6988
  # A starting value for a range of allowed port numbers.
@@ -5981,7 +7203,11 @@ module Aws::GameLift
5981
7203
  # @return [String]
5982
7204
  #
5983
7205
  # @!attribute [rw] location
5984
- # The name of a location to retrieve compute resources for.
7206
+ # The name of a location to retrieve compute resources for. For an
7207
+ # Amazon GameLift Anywhere fleet, use a custom location. For a
7208
+ # multi-location EC2 or container fleet, provide a Amazon Web Services
7209
+ # Region or Local Zone code (for example: `us-west-2` or
7210
+ # `us-west-2-lax-1`).
5985
7211
  # @return [String]
5986
7212
  #
5987
7213
  # @!attribute [rw] limit
@@ -6026,6 +7252,58 @@ module Aws::GameLift
6026
7252
  include Aws::Structure
6027
7253
  end
6028
7254
 
7255
+ # @!attribute [rw] scheduling_strategy
7256
+ # The type of container group definitions to retrieve.
7257
+ #
7258
+ # * `DAEMON` -- Daemon container groups run background processes and
7259
+ # are deployed once per fleet instance.
7260
+ #
7261
+ # * `REPLICA` -- Replica container groups run your game server
7262
+ # application and supporting software. Replica groups might be
7263
+ # deployed multiple times per fleet instance.
7264
+ # @return [String]
7265
+ #
7266
+ # @!attribute [rw] limit
7267
+ # The maximum number of results to return. Use this parameter with
7268
+ # `NextToken` to get results as a set of sequential pages.
7269
+ # @return [Integer]
7270
+ #
7271
+ # @!attribute [rw] next_token
7272
+ # A token that indicates the start of the next sequential page of
7273
+ # results. Use the token that is returned with a previous call to this
7274
+ # operation. To start at the beginning of the result set, do not
7275
+ # specify a value.
7276
+ # @return [String]
7277
+ #
7278
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListContainerGroupDefinitionsInput AWS API Documentation
7279
+ #
7280
+ class ListContainerGroupDefinitionsInput < Struct.new(
7281
+ :scheduling_strategy,
7282
+ :limit,
7283
+ :next_token)
7284
+ SENSITIVE = []
7285
+ include Aws::Structure
7286
+ end
7287
+
7288
+ # @!attribute [rw] container_group_definitions
7289
+ # A result set of container group definitions that match the request.
7290
+ # @return [Array<Types::ContainerGroupDefinition>]
7291
+ #
7292
+ # @!attribute [rw] next_token
7293
+ # A token that indicates where to resume retrieving results on the
7294
+ # next call to this operation. If no token is returned, these results
7295
+ # represent the end of the list.
7296
+ # @return [String]
7297
+ #
7298
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ListContainerGroupDefinitionsOutput AWS API Documentation
7299
+ #
7300
+ class ListContainerGroupDefinitionsOutput < Struct.new(
7301
+ :container_group_definitions,
7302
+ :next_token)
7303
+ SENSITIVE = []
7304
+ include Aws::Structure
7305
+ end
7306
+
6029
7307
  # @!attribute [rw] build_id
6030
7308
  # A unique identifier for the build to request fleets for. Use this
6031
7309
  # parameter to return only fleets using a specified build. Use either
@@ -6038,6 +7316,12 @@ module Aws::GameLift
6038
7316
  # Use either the script ID or ARN value.
6039
7317
  # @return [String]
6040
7318
  #
7319
+ # @!attribute [rw] container_group_definition_name
7320
+ # The container group definition name to request fleets for. Use this
7321
+ # parameter to return only fleets that are deployed with the specified
7322
+ # container group definition.
7323
+ # @return [String]
7324
+ #
6041
7325
  # @!attribute [rw] limit
6042
7326
  # The maximum number of results to return. Use this parameter with
6043
7327
  # `NextToken` to get results as a set of sequential pages.
@@ -6055,6 +7339,7 @@ module Aws::GameLift
6055
7339
  class ListFleetsInput < Struct.new(
6056
7340
  :build_id,
6057
7341
  :script_id,
7342
+ :container_group_definition_name,
6058
7343
  :limit,
6059
7344
  :next_token)
6060
7345
  SENSITIVE = []
@@ -6316,6 +7601,9 @@ module Aws::GameLift
6316
7601
  include Aws::Structure
6317
7602
  end
6318
7603
 
7604
+ # **This data type has been expanded to use with the Amazon GameLift
7605
+ # containers feature, which is currently in public preview.**
7606
+ #
6319
7607
  # A remote location where a multi-location fleet can deploy game servers
6320
7608
  # for game hosting.
6321
7609
  #
@@ -6331,7 +7619,13 @@ module Aws::GameLift
6331
7619
  include Aws::Structure
6332
7620
  end
6333
7621
 
6334
- # Properties of a location
7622
+ # Properties of a custom location for use in an Amazon GameLift Anywhere
7623
+ # fleet. This data type is returned in response to a call to
7624
+ # [https://docs.aws.amazon.com/gamelift/latest/apireference/API\_CreateLocation.html][1].
7625
+ #
7626
+ #
7627
+ #
7628
+ # [1]: https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateLocation.html
6335
7629
  #
6336
7630
  # @!attribute [rw] location_name
6337
7631
  # The location's name.
@@ -6825,6 +8119,25 @@ module Aws::GameLift
6825
8119
  include Aws::Structure
6826
8120
  end
6827
8121
 
8122
+ # The operation failed because Amazon GameLift has not yet finished
8123
+ # validating this compute. We recommend attempting 8 to 10 retries over
8124
+ # 3 to 5 minutes with [exponential backoffs and jitter][1].
8125
+ #
8126
+ #
8127
+ #
8128
+ # [1]: http://aws.amazon.com/blogs/https:/aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/
8129
+ #
8130
+ # @!attribute [rw] message
8131
+ # @return [String]
8132
+ #
8133
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/NotReadyException AWS API Documentation
8134
+ #
8135
+ class NotReadyException < Struct.new(
8136
+ :message)
8137
+ SENSITIVE = []
8138
+ include Aws::Structure
8139
+ end
8140
+
6828
8141
  # The specified game server group has no available game servers to
6829
8142
  # fulfill a `ClaimGameServer` request. Clients can retry such requests
6830
8143
  # immediately or after a waiting period.
@@ -7402,6 +8715,46 @@ module Aws::GameLift
7402
8715
  include Aws::Structure
7403
8716
  end
7404
8717
 
8718
+ # **This data type is used with the Amazon GameLift containers feature,
8719
+ # which is currently in public preview.**
8720
+ #
8721
+ # The number and status of replica container groups that are deployed
8722
+ # across a fleet with compute type `CONTAINER`. This information,
8723
+ # combined with the number of server processes being hosted per
8724
+ # container group (see `RuntimeConfiguration`), tells you how many game
8725
+ # sessions the fleet is currently capable of hosting concurrently.
8726
+ #
8727
+ # **Returned by:** DescribeFleetCapacity, DescribeFleetLocationCapacity
8728
+ #
8729
+ # @!attribute [rw] pending
8730
+ # The number of container groups that are starting up but have not yet
8731
+ # registered.
8732
+ # @return [Integer]
8733
+ #
8734
+ # @!attribute [rw] active
8735
+ # The number of container groups that have active game sessions.
8736
+ # @return [Integer]
8737
+ #
8738
+ # @!attribute [rw] idle
8739
+ # The number of container groups that have no active game sessions.
8740
+ # @return [Integer]
8741
+ #
8742
+ # @!attribute [rw] terminating
8743
+ # The number of container groups that are in the process of shutting
8744
+ # down.
8745
+ # @return [Integer]
8746
+ #
8747
+ # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ReplicaContainerGroupCounts AWS API Documentation
8748
+ #
8749
+ class ReplicaContainerGroupCounts < Struct.new(
8750
+ :pending,
8751
+ :active,
8752
+ :idle,
8753
+ :terminating)
8754
+ SENSITIVE = []
8755
+ include Aws::Structure
8756
+ end
8757
+
7405
8758
  # @!attribute [rw] build_id
7406
8759
  # A unique identifier for the build to get credentials for. You can
7407
8760
  # use either the build ID or ARN value.
@@ -7577,18 +8930,24 @@ module Aws::GameLift
7577
8930
  include Aws::Structure
7578
8931
  end
7579
8932
 
7580
- # A collection of server process configurations that describe the set of
7581
- # processes to run on each instance in a fleet. Server processes run
7582
- # either an executable in a custom game build or a Realtime Servers
7583
- # script. Amazon GameLift launches the configured processes, manages
7584
- # their life cycle, and replaces them as needed. Each instance checks
7585
- # regularly for an updated runtime configuration.
8933
+ # **This data type has been expanded to use with the Amazon GameLift
8934
+ # containers feature, which is currently in public preview.**
8935
+ #
8936
+ # A set of instructions that define the set of server processes to run
8937
+ # on computes in a fleet. Server processes run either an executable in a
8938
+ # custom game build or a Realtime Servers script. Amazon GameLift
8939
+ # launches the processes, manages their life cycle, and replaces them as
8940
+ # needed. Computes check regularly for an updated runtime configuration.
8941
+ #
8942
+ # On a container fleet, the Amazon GameLift Agent uses the runtime
8943
+ # configuration to manage the lifecycle of server processes in a replica
8944
+ # container group.
7586
8945
  #
7587
- # A Amazon GameLift instance is limited to 50 processes running
7588
- # concurrently. To calculate the total number of processes in a runtime
7589
- # configuration, add the values of the `ConcurrentExecutions` parameter
7590
- # for each server process. Learn more about [ Running Multiple Processes
7591
- # on a Fleet][1].
8946
+ # An Amazon GameLift instance is limited to 50 processes running
8947
+ # concurrently. To calculate the total number of processes defined in a
8948
+ # runtime configuration, add the values of the `ConcurrentExecutions`
8949
+ # parameter for each server process. Learn more about [ Running Multiple
8950
+ # Processes on a Fleet][1].
7592
8951
  #
7593
8952
  #
7594
8953
  #
@@ -7596,13 +8955,13 @@ module Aws::GameLift
7596
8955
  #
7597
8956
  # @!attribute [rw] server_processes
7598
8957
  # A collection of server process configurations that identify what
7599
- # server processes to run on each instance in a fleet.
8958
+ # server processes to run on fleet computes.
7600
8959
  # @return [Array<Types::ServerProcess>]
7601
8960
  #
7602
8961
  # @!attribute [rw] max_concurrent_game_session_activations
7603
8962
  # The number of game sessions in status `ACTIVATING` to allow on an
7604
- # instance. This setting limits the instance resources that can be
7605
- # used for new game activations at any one time.
8963
+ # instance or container. This setting limits the instance resources
8964
+ # that can be used for new game activations at any one time.
7606
8965
  # @return [Integer]
7607
8966
  #
7608
8967
  # @!attribute [rw] game_session_activation_timeout_seconds
@@ -8048,8 +9407,8 @@ module Aws::GameLift
8048
9407
  include Aws::Structure
8049
9408
  end
8050
9409
 
8051
- # A set of instructions for launching server processes on each instance
8052
- # in a fleet. Server processes run either an executable in a custom game
9410
+ # A set of instructions for launching server processes on fleet
9411
+ # computes. Server processes run either an executable in a custom game
8053
9412
  # build or a Realtime Servers script. Server process configurations are
8054
9413
  # part of a fleet's runtime configuration.
8055
9414
  #
@@ -8079,7 +9438,7 @@ module Aws::GameLift
8079
9438
  #
8080
9439
  # @!attribute [rw] concurrent_executions
8081
9440
  # The number of server processes using this configuration that run
8082
- # concurrently on each instance.
9441
+ # concurrently on each instance or container..
8083
9442
  # @return [Integer]
8084
9443
  #
8085
9444
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/ServerProcess AWS API Documentation
@@ -9426,11 +10785,11 @@ module Aws::GameLift
9426
10785
  # @return [String]
9427
10786
  #
9428
10787
  # @!attribute [rw] runtime_configuration
9429
- # Instructions for launching server processes on each instance in the
9430
- # fleet. Server processes run either a custom game build executable or
9431
- # a Realtime Servers script. The runtime configuration lists the types
9432
- # of server processes to run on an instance, how to launch them, and
9433
- # the number of processes to run concurrently.
10788
+ # Instructions for launching server processes on fleet computes.
10789
+ # Server processes run either a custom game build executable or a
10790
+ # Realtime Servers script. The runtime configuration lists the types
10791
+ # of server processes to run, how to launch them, and the number of
10792
+ # processes to run concurrently.
9434
10793
  # @return [Types::RuntimeConfiguration]
9435
10794
  #
9436
10795
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateRuntimeConfigurationInput AWS API Documentation
@@ -9443,8 +10802,8 @@ module Aws::GameLift
9443
10802
  end
9444
10803
 
9445
10804
  # @!attribute [rw] runtime_configuration
9446
- # The runtime configuration currently in use by all instances in the
9447
- # fleet. If the update was successful, all property changes are shown.
10805
+ # The runtime configuration currently in use by computes in the fleet.
10806
+ # If the update is successful, all property changes are shown.
9448
10807
  # @return [Types::RuntimeConfiguration]
9449
10808
  #
9450
10809
  # @see http://docs.aws.amazon.com/goto/WebAPI/gamelift-2015-10-01/UpdateRuntimeConfigurationOutput AWS API Documentation