GameLift / Client / delete_fleet_locations

delete_fleet_locations#

GameLift.Client.delete_fleet_locations(**kwargs)#

Removes locations from a multi-location fleet. When deleting a location, all game server process and all instances that are still active in the location are shut down.

To delete fleet locations, identify the fleet ID and provide a list of the locations to be deleted.

If successful, GameLift sets the location status to DELETING , and begins to shut down existing server processes and terminate instances in each location being deleted. When completed, the location status changes to TERMINATED .

See also: AWS API Documentation

Request Syntax

response = client.delete_fleet_locations(
    FleetId='string',
    Locations=[
        'string',
    ]
)
Parameters:

  • FleetId (string) –

    [REQUIRED]

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

  • Locations (list) –

    [REQUIRED]

    The list of fleet locations to delete. Specify locations in the form of an Amazon Web Services Region code, such as us-west-2 .

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'FleetId': 'string',
    'FleetArn': 'string',
    'LocationStates': [
        {
            'Location': 'string',
            'Status': 'NEW'|'DOWNLOADING'|'VALIDATING'|'BUILDING'|'ACTIVATING'|'ACTIVE'|'DELETING'|'ERROR'|'TERMINATED'|'NOT_FOUND'
        },
    ]
}

Response Structure

  • (dict) –

    • FleetId (string) –

      A unique identifier for the fleet that location attributes are being deleted for.

    • FleetArn (string) –

      The Amazon Resource Name ( ARN ) that is assigned to a GameLift fleet resource and uniquely identifies it. ARNs are unique across all Regions. Format is arn:aws:gamelift:<region>::fleet/fleet-a1234567-b8c9-0d1e-2fa3-b45c6d7e8912 .

    • LocationStates (list) –

      The remote locations that are being deleted, with each location status set to DELETING .

      • (dict) –

        A fleet location and its life-cycle state. A location state object might be used to describe a fleet’s remote location or home Region. Life-cycle state tracks the progress of launching the first instance in a new location and preparing it for game hosting, and then removing all instances and deleting the location from the fleet.

        • NEW – A new fleet location has been defined and desired instances is set to 1.

        • DOWNLOADING/VALIDATING/BUILDING/ACTIVATING – GameLift is setting up the new fleet location, creating new instances with the game build or Realtime script and starting server processes.

        • ACTIVE – Hosts can now accept game sessions.

        • ERROR – An error occurred when downloading, validating, building, or activating the fleet location.

        • DELETING – Hosts are responding to a delete fleet location request.

        • TERMINATED – The fleet location no longer exists.

        • NOT_FOUND – The fleet location was not found. This could be because the custom location was removed or not created.

        • Location (string) –

          The fleet location, expressed as an Amazon Web Services Region code such as us-west-2 .

        • Status (string) –

          The life-cycle status of a fleet location.

Exceptions

  • GameLift.Client.exceptions.InternalServiceException

  • GameLift.Client.exceptions.InvalidRequestException

  • GameLift.Client.exceptions.UnauthorizedException

  • GameLift.Client.exceptions.NotFoundException

  • GameLift.Client.exceptions.UnsupportedRegionException