describe_fleet_location_utilization

GameLift.Client.describe_fleet_location_utilization(**kwargs)

Retrieves current usage data for a fleet location. Utilization data provides a snapshot of current game hosting activity at the requested location. Use this operation to retrieve utilization information for a fleet's remote location or home Region (you can also retrieve home Region utilization by calling DescribeFleetUtilization ).

To retrieve utilization data, identify a fleet and location.

If successful, a FleetUtilization object is returned for the requested fleet location.

Learn more

Setting up GameLift fleets

GameLift metrics for fleets

See also: AWS API Documentation

Request Syntax

response = client.describe_fleet_location_utilization(
    FleetId='string',
    Location='string'
)

Parameters

• FleetId (string) --

  [REQUIRED]

  A unique identifier for the fleet to request location utilization for. You can use either the fleet ID or ARN value.

• Location (string) --

  [REQUIRED]

  The fleet location to retrieve utilization information for. Specify a location in the form of an Amazon Web Services Region code, such as us-west-2 .

Return type

dict

Returns

Response Syntax

{
    'FleetUtilization': {
        'FleetId': 'string',
        'FleetArn': 'string',
        'ActiveServerProcessCount': 123,
        'ActiveGameSessionCount': 123,
        'CurrentPlayerSessionCount': 123,
        'MaximumPlayerSessionCount': 123,
        'Location': 'string'
    }
}

Response Structure

• (dict) --

  • FleetUtilization (dict) --

    Utilization information for the requested fleet location. Utilization objects are returned only for fleets and locations that currently exist.

    • FleetId (string) --

      A unique identifier for the fleet associated with the location.

    • 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 .

    • ActiveServerProcessCount (integer) --

      The number of server processes in ACTIVE status that are currently running across all instances in the fleet location.

    • ActiveGameSessionCount (integer) --

      The number of active game sessions that are currently being hosted across all instances in the fleet location.

    • CurrentPlayerSessionCount (integer) --

      The number of active player sessions that are currently being hosted across all instances in the fleet location.

    • MaximumPlayerSessionCount (integer) --

      The maximum number of players allowed across all game sessions that are currently being hosted across all instances in the fleet location.

    • Location (string) --

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

Exceptions

• GameLift.Client.exceptions.InternalServiceException
• GameLift.Client.exceptions.InvalidRequestException
• GameLift.Client.exceptions.UnauthorizedException
• GameLift.Client.exceptions.NotFoundException
• GameLift.Client.exceptions.UnsupportedRegionException