describe_fleet_location_capacity

describe_fleet_location_capacity(**kwargs)

Retrieves the resource capacity settings for a fleet location. The data returned includes the current capacity (number of EC2 instances) and some scaling settings for the requested fleet location. Use this operation to retrieve capacity information for a fleet's remote location or home Region (you can also retrieve home Region capacity by calling DescribeFleetCapacity ).

To retrieve capacity data, identify a fleet and location.

If successful, a FleetCapacity 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_capacity(
    FleetId='string',
    Location='string'
)

Parameters

• FleetId (string) --

  [REQUIRED]

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

• Location (string) --

  [REQUIRED]

  The fleet location to retrieve capacity 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

{
    'FleetCapacity': {
        'FleetId': 'string',
        'FleetArn': 'string',
        'InstanceType': 't2.micro'|'t2.small'|'t2.medium'|'t2.large'|'c3.large'|'c3.xlarge'|'c3.2xlarge'|'c3.4xlarge'|'c3.8xlarge'|'c4.large'|'c4.xlarge'|'c4.2xlarge'|'c4.4xlarge'|'c4.8xlarge'|'c5.large'|'c5.xlarge'|'c5.2xlarge'|'c5.4xlarge'|'c5.9xlarge'|'c5.12xlarge'|'c5.18xlarge'|'c5.24xlarge'|'c5a.large'|'c5a.xlarge'|'c5a.2xlarge'|'c5a.4xlarge'|'c5a.8xlarge'|'c5a.12xlarge'|'c5a.16xlarge'|'c5a.24xlarge'|'r3.large'|'r3.xlarge'|'r3.2xlarge'|'r3.4xlarge'|'r3.8xlarge'|'r4.large'|'r4.xlarge'|'r4.2xlarge'|'r4.4xlarge'|'r4.8xlarge'|'r4.16xlarge'|'r5.large'|'r5.xlarge'|'r5.2xlarge'|'r5.4xlarge'|'r5.8xlarge'|'r5.12xlarge'|'r5.16xlarge'|'r5.24xlarge'|'r5a.large'|'r5a.xlarge'|'r5a.2xlarge'|'r5a.4xlarge'|'r5a.8xlarge'|'r5a.12xlarge'|'r5a.16xlarge'|'r5a.24xlarge'|'m3.medium'|'m3.large'|'m3.xlarge'|'m3.2xlarge'|'m4.large'|'m4.xlarge'|'m4.2xlarge'|'m4.4xlarge'|'m4.10xlarge'|'m5.large'|'m5.xlarge'|'m5.2xlarge'|'m5.4xlarge'|'m5.8xlarge'|'m5.12xlarge'|'m5.16xlarge'|'m5.24xlarge'|'m5a.large'|'m5a.xlarge'|'m5a.2xlarge'|'m5a.4xlarge'|'m5a.8xlarge'|'m5a.12xlarge'|'m5a.16xlarge'|'m5a.24xlarge'|'c5d.large'|'c5d.xlarge'|'c5d.2xlarge'|'c5d.4xlarge'|'c5d.9xlarge'|'c5d.12xlarge'|'c5d.18xlarge'|'c5d.24xlarge'|'c6a.large'|'c6a.xlarge'|'c6a.2xlarge'|'c6a.4xlarge'|'c6a.8xlarge'|'c6a.12xlarge'|'c6a.16xlarge'|'c6a.24xlarge'|'c6i.large'|'c6i.xlarge'|'c6i.2xlarge'|'c6i.4xlarge'|'c6i.8xlarge'|'c6i.12xlarge'|'c6i.16xlarge'|'c6i.24xlarge'|'r5d.large'|'r5d.xlarge'|'r5d.2xlarge'|'r5d.4xlarge'|'r5d.8xlarge'|'r5d.12xlarge'|'r5d.16xlarge'|'r5d.24xlarge',
        'InstanceCounts': {
            'DESIRED': 123,
            'MINIMUM': 123,
            'MAXIMUM': 123,
            'PENDING': 123,
            'ACTIVE': 123,
            'IDLE': 123,
            'TERMINATING': 123
        },
        'Location': 'string'
    }
}

Response Structure

• (dict) --

  • FleetCapacity (dict) --

    Resource capacity information for the requested fleet location. Capacity 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 .

    • InstanceType (string) --

      The Amazon EC2 instance type that is used for all instances in a fleet. The instance type determines the computing resources in use, including CPU, memory, storage, and networking capacity. See Amazon Elastic Compute Cloud Instance Types for detailed descriptions.

    • InstanceCounts (dict) --

      Resource capacity settings. Fleet capacity is measured in Amazon EC2 instances. Pending and terminating counts are non-zero when the fleet capacity is adjusting to a scaling event or if access to resources is temporarily affected.

      • DESIRED (integer) --

        Ideal number of active instances. GameLift will always try to maintain the desired number of instances. Capacity is scaled up or down by changing the desired instances.

      • MINIMUM (integer) --

        The minimum instance count value allowed.

      • MAXIMUM (integer) --

        The maximum instance count value allowed.

      • PENDING (integer) --

        Number of instances that are starting but not yet active.

      • ACTIVE (integer) --

        Actual number of instances that are ready to host game sessions.

      • IDLE (integer) --

        Number of active instances that are not currently hosting a game session.

      • TERMINATING (integer) --

        Number of instances that are no longer active but haven't yet been terminated.

    • Location (string) --

      The fleet location for the instance count 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