awslimitchecker.services.ec2 module

class awslimitchecker.services.ec2._Ec2Service(warning_threshold, critical_threshold, account_id=None, account_role=None, region=None, external_id=None)

Bases: awslimitchecker.services.base._AwsService

Describes an AWS service and its limits, and provides methods to query current utilization.

Constructors of _AwsService subclasses must not make any external connections; these must be made lazily as needed in other methods. _AwsService subclasses should be usable without any external network connections.

Parameters:

• warning_threshold (int) – the default warning threshold, as an integer percentage, for any limits without a specifically-set threshold.
• critical_threshold (int) – the default critical threshold, as an integer percentage, for any limits without a specifically-set threshold.
• account_id (str) – AWS Account ID (12-digit string, currently numeric) for the account to connect to (destination) via STS
• account_role (str) – the name of an IAM Role (in the destination account) to assume
• region (str) – AWS region name to connect to
• external_id (str) – (optional) the External ID string to use when assuming a role via STS.

__abstractmethods__ = frozenset([])

__module__ = 'awslimitchecker.services.ec2'

_abc_cache = <_weakrefset.WeakSet object>

_abc_negative_cache = <_weakrefset.WeakSet object>

_abc_negative_cache_version = 25

_abc_registry = <_weakrefset.WeakSet object>

_find_usage_instances()

calculate On-Demand instance usage for all types and update Limits

_find_usage_networking_eips()

_find_usage_networking_eni_sg()

_find_usage_networking_sgs()

calculate usage for VPC-related things

_get_limits_instances()

Return a dict of limits for EC2 instances only. This method should only be used internally by :py:meth:~.get_limits`.

Return type:dict

_get_limits_networking()

Return a dict of VPC-related limits only. This method should only be used internally by :py:meth:~.get_limits`.

Return type:dict

_get_reserved_instance_count()

For each availability zone, get the count of current instance reservations of each instance type. Return as a nested dict of AZ name to dict of instance type to reservation count.

Return type:dict

_instance_types()

Return a list of all known EC2 instance types

Returns:list of all valid known EC2 instance types Return type:list

_instance_usage()

Find counts of currently-running EC2 Instances (On-Demand or Reserved) by placement (Availability Zone) and instance type (size). Return as a nested dict of AZ name to dict of instance type to count.

Return type:dict

_update_limits_from_api()

Query EC2’s DescribeAccountAttributes API action, and update limits with the quotas returned. Updates self.limits.

connect()

Connect to API if not already connected; set self.conn.

find_usage()

Determine the current usage for each limit of this service, and update corresponding Limit via _add_current_usage().

get_limits()

Return all known limits for this service, as a dict of their names to AwsLimit objects.

Returns:dict of limit names to AwsLimit objects Return type:dict

required_iam_permissions()

Return a list of IAM Actions required for this Service to function properly. All Actions will be shown with an Effect of “Allow” and a Resource of “*”.

Returns:list of IAM Action strings Return type:list

service_name = 'EC2'