Skip to content

UpdateContainerFleetInput

Source code in docs_src/capo_gamelift/types/update_container_fleet_input.py
class UpdateContainerFleetInput(TypedDict, closed=True):
    fleet_id: NotRequired["capo_gamelift.types.fleet_id_or_arn.FleetIdOrArn"]
    """<p>A unique identifier for the container fleet to update. You can use either the fleet ID or ARN value.</p>"""
    game_server_container_group_definition_name: NotRequired[
        "capo_gamelift.types.container_group_definition_name_or_arn.ContainerGroupDefinitionNameOrArn"
    ]
    """<p>The name or ARN value of a new game server container group definition to deploy on the fleet. If you're updating the fleet to a specific version of a container group definition, use the ARN value and include the version number. If you're updating the fleet to the latest version of a container group definition, you can use the name value. You can't remove a fleet's game server container group definition, you can only update or replace it with another definition.</p> <p>Update a container group definition by calling <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateContainerGroupDefinition.html">UpdateContainerGroupDefinition</a>. This operation creates a <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_ContainerGroupDefinition.html">ContainerGroupDefinition</a> resource with an incremented version. </p>"""
    per_instance_container_group_definition_name: NotRequired[
        "capo_gamelift.types.container_group_definition_name_or_arn.ContainerGroupDefinitionNameOrArn"
    ]
    """<p>The name or ARN value of a new per-instance container group definition to deploy on the fleet. If you're updating the fleet to a specific version of a container group definition, use the ARN value and include the version number. If you're updating the fleet to the latest version of a container group definition, you can use the name value.</p> <p>Update a container group definition by calling <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateContainerGroupDefinition.html">UpdateContainerGroupDefinition</a>. This operation creates a <a href="https://docs.aws.amazon.com/gamelift/latest/apireference/API_ContainerGroupDefinition.html">ContainerGroupDefinition</a> resource with an incremented version. </p> <p>To remove a fleet's per-instance container group definition, leave this parameter empty and use the parameter <code>RemoveAttributes</code>.</p>"""
    game_server_container_groups_per_instance: NotRequired[
        "capo_gamelift.types.game_server_container_groups_per_instance.GameServerContainerGroupsPerInstance"
    ]
    """<p>The number of times to replicate the game server container group on each fleet instance. By default, Amazon GameLift Servers calculates the maximum number of game server container groups that can fit on each instance. You can remove this property value to use the calculated value, or set it manually. If you set this number manually, Amazon GameLift Servers uses your value as long as it's less than the calculated maximum.</p>"""
    instance_connection_port_range: NotRequired[
        "capo_gamelift.types.connection_port_range.ConnectionPortRange"
    ]
    """<p>A revised set of port numbers to open on each fleet instance. By default, Amazon GameLift Servers calculates an optimal port range based on your fleet configuration. If you previously set this parameter manually, you can't reset this to use the calculated settings.</p> <p>The port range must not overlap with the Amazon GameLift Servers reserved port range <code>4092-4191</code>. This range is reserved for internal Amazon GameLift Servers services.</p>"""
    instance_inbound_permission_authorizations: NotRequired[
        "capo_gamelift.types.ip_permissions_list.IpPermissionsList"
    ]
    """<p>A set of ports to add to the container fleet's inbound permissions.</p> <p>The port range must not overlap with the Amazon GameLift Servers reserved port range <code>4092-4191</code>. This range is reserved for internal Amazon GameLift Servers services.</p>"""
    instance_inbound_permission_revocations: NotRequired[
        "capo_gamelift.types.ip_permissions_list.IpPermissionsList"
    ]
    """<p>A set of ports to remove from the container fleet's inbound permissions.</p>"""
    deployment_configuration: NotRequired[
        "capo_gamelift.types.deployment_configuration.DeploymentConfiguration"
    ]
    """<p>Instructions for how to deploy updates to a container fleet, if the fleet update initiates a deployment. The deployment configuration lets you determine how to replace fleet instances and what actions to take if the deployment fails.</p>"""
    description: NotRequired[
        "capo_gamelift.types.non_zero_and_max_string.NonZeroAndMaxString"
    ]
    """<p>A meaningful description of the container fleet.</p>"""
    metric_groups: NotRequired["capo_gamelift.types.metric_group_list.MetricGroupList"]
    """<p>The name of an Amazon Web Services CloudWatch metric group to add this fleet to. </p>"""
    new_game_session_protection_policy: NotRequired[
        "capo_gamelift.types.protection_policy.ProtectionPolicy"
    ]
    """<p>The game session protection policy to apply to all new game sessions that are started in this fleet. Game sessions that already exist are not affected. </p>"""
    game_session_creation_limit_policy: NotRequired[
        "capo_gamelift.types.game_session_creation_limit_policy.GameSessionCreationLimitPolicy"
    ]
    """<p>A policy that limits the number of game sessions that each individual player can create on instances in this fleet. The limit applies for a specified span of time.</p>"""
    log_configuration: NotRequired[
        "capo_gamelift.types.log_configuration.LogConfiguration"
    ]
    """<p>The method for collecting container logs for the fleet. </p>"""
    remove_attributes: NotRequired[
        "capo_gamelift.types.container_fleet_remove_attribute_list.ContainerFleetRemoveAttributeList"
    ]
    """<p>If set, this update removes a fleet's per-instance container group definition. You can't remove a fleet's game server container group definition.</p>"""

deployment_configuration instance-attribute

deployment_configuration: NotRequired[DeploymentConfiguration]

Instructions for how to deploy updates to a container fleet, if the fleet update initiates a deployment. The deployment configuration lets you determine how to replace fleet instances and what actions to take if the deployment fails.

description instance-attribute

description: NotRequired[NonZeroAndMaxString]

A meaningful description of the container fleet.

fleet_id instance-attribute

fleet_id: NotRequired[FleetIdOrArn]

A unique identifier for the container fleet to update. You can use either the fleet ID or ARN value.

game_server_container_group_definition_name instance-attribute

game_server_container_group_definition_name: NotRequired[
    ContainerGroupDefinitionNameOrArn
]

The name or ARN value of a new game server container group definition to deploy on the fleet. If you're updating the fleet to a specific version of a container group definition, use the ARN value and include the version number. If you're updating the fleet to the latest version of a container group definition, you can use the name value. You can't remove a fleet's game server container group definition, you can only update or replace it with another definition.

Update a container group definition by calling UpdateContainerGroupDefinition. This operation creates a ContainerGroupDefinition resource with an incremented version.

game_server_container_groups_per_instance instance-attribute

game_server_container_groups_per_instance: NotRequired[
    GameServerContainerGroupsPerInstance
]

The number of times to replicate the game server container group on each fleet instance. By default, Amazon GameLift Servers calculates the maximum number of game server container groups that can fit on each instance. You can remove this property value to use the calculated value, or set it manually. If you set this number manually, Amazon GameLift Servers uses your value as long as it's less than the calculated maximum.

game_session_creation_limit_policy instance-attribute

game_session_creation_limit_policy: NotRequired[GameSessionCreationLimitPolicy]

A policy that limits the number of game sessions that each individual player can create on instances in this fleet. The limit applies for a specified span of time.

instance_connection_port_range instance-attribute

instance_connection_port_range: NotRequired[ConnectionPortRange]

A revised set of port numbers to open on each fleet instance. By default, Amazon GameLift Servers calculates an optimal port range based on your fleet configuration. If you previously set this parameter manually, you can't reset this to use the calculated settings.

The port range must not overlap with the Amazon GameLift Servers reserved port range 4092-4191. This range is reserved for internal Amazon GameLift Servers services.

instance_inbound_permission_authorizations instance-attribute

instance_inbound_permission_authorizations: NotRequired[IpPermissionsList]

A set of ports to add to the container fleet's inbound permissions.

The port range must not overlap with the Amazon GameLift Servers reserved port range 4092-4191. This range is reserved for internal Amazon GameLift Servers services.

instance_inbound_permission_revocations instance-attribute

instance_inbound_permission_revocations: NotRequired[IpPermissionsList]

A set of ports to remove from the container fleet's inbound permissions.

log_configuration instance-attribute

log_configuration: NotRequired[LogConfiguration]

The method for collecting container logs for the fleet.

metric_groups instance-attribute

metric_groups: NotRequired[MetricGroupList]

The name of an Amazon Web Services CloudWatch metric group to add this fleet to.

new_game_session_protection_policy instance-attribute

new_game_session_protection_policy: NotRequired[ProtectionPolicy]

The game session protection policy to apply to all new game sessions that are started in this fleet. Game sessions that already exist are not affected.

per_instance_container_group_definition_name instance-attribute

per_instance_container_group_definition_name: NotRequired[
    ContainerGroupDefinitionNameOrArn
]

The name or ARN value of a new per-instance container group definition to deploy on the fleet. If you're updating the fleet to a specific version of a container group definition, use the ARN value and include the version number. If you're updating the fleet to the latest version of a container group definition, you can use the name value.

Update a container group definition by calling UpdateContainerGroupDefinition. This operation creates a ContainerGroupDefinition resource with an incremented version.

To remove a fleet's per-instance container group definition, leave this parameter empty and use the parameter RemoveAttributes.

remove_attributes instance-attribute

remove_attributes: NotRequired[ContainerFleetRemoveAttributeList]

If set, this update removes a fleet's per-instance container group definition. You can't remove a fleet's game server container group definition.