Menu
Amazon GameLift
Developer Guide (Version )

Manage Fleet Records

Use the Amazon GameLift console or the AWS CLI to manage your existing fleets, including updating the fleet's attributes, port settings, and runtime configuration. You can also delete a fleet.

Update a Fleet

Use the Edit fleet page in the Amazon GameLift console to change a fleet's configuration. All fleet properties can be changed except for the build ID and the instance type. To change scaling settings, see Auto-Scale Fleet Capacity.

Note

An active fleet may be deployed with a build that has been deleted or is in an error state. This does not affect the fleet's status or ability to host game sessions. In this situation, you may see a Build status of Deleted or Error (if an error occurred while retrieving the build info).

You can also update a fleet using the following AWS CLI commands:

To update a fleet configuration

  1. Open the Amazon GameLift console at https://console.aws.amazon.com/gamelift/.

  2. Choose Fleets from the menu bar to view a list of fleets, and click on the name of the fleet you want to update. A fleet must be in ACTIVE status before it can be edited.

  3. On the Fleet detail page, under Actions, choose Edit fleet.

  4. On the Edit fleet page, you can make the following updates (see Create a Fleet for more detailed field descriptions):

    • Change the fleet attributes such as Name and Description.

    • Add or remove Metric groups, which are are used in Amazon CloudWatch to track aggregated Amazon GameLift metrics for multiple fleets.

    • Change how you want server processes to run and host game sessions by updating the Server process allocation (runtime configuration) and game session activation settings.

    • Update the EC2 port settings used to connect to server processes on this fleet.

    • Update resource creation limit settings.

    • Turn game session protection on or off.

  5. Click Submit to save your changes.

Delete a Fleet

You can delete a fleet when it is no longer needed. Deleting a fleet also permanently removes all data associated with game sessions and player sessions, as well as collected metric data. As an alternative, you can retain the fleet, disable any auto-scaling, and manually scale the fleet to 0 instances.

Note

Before a fleet can be deleted, it must be scaled down to 0. Set desired instances to 0 and wait for the fleet to scale down the active instance count to 0.

You can also delete a fleet using the following AWS CLI command:

To delete a fleet

  1. Open the Amazon GameLift console at https://console.aws.amazon.com/gamelift/.

  2. Choose Fleets from the menu bar to view a list of fleets, and click on the name of the fleet you want to delete. A fleet must be in ACTIVE status before it can be deleted.

  3. On the Fleet detail page, under Actions, choose Terminate fleet.

  4. In the Terminate fleet dialog box, confirm the deletion by typing the name of the fleet.

  5. Click Delete.