EC2 Instance Listing with Filters

Retrieve detailed information about your EC2 instances using filters. This tool utilizes the boto3 library in Python to interact with AWS. Below is an example demonstrating how to list instances based on specific criteria. For a complete script, see examples/ec2_list_instances.py.

Filtering Instances by State and Tag

This example shows how to filter instances that are in the 'running' state and have a specific tag.

>>> import boto3
>>> ec2 = boto3.Session(profile_name='prod', region_name='eu-west-1').client('ec2')
>>> instances = ec2.instances.filter(Filters=[{'Name': 'instance-state-name', 'Values': ['running']},{'Name': 'tag:Name', 'Values': ['my-instance-group-name']}])
>>> for instance in instances:
...     print(instance.id, instance.instance_type, instance.private_ip_address)
...
('i-00bceb55c1cec0c00', 'c5.large', '172.30.34.253')
('i-007f2ef27779f3f00', 'c5.large', '172.30.34.245')
('i-00228d357d1ddd200', 'c5.large', '172.30.36.188')
('i-00a0087392f7ebe00', 'c5.large', '172.30.37.192')
('i-008895f213ae84000', 'c5.large', '172.30.38.170')

Understanding the Output

The output displays the instance ID, instance type, and private IP address for each instance that matches the specified filters. This information can be useful for monitoring and managing your AWS EC2 infrastructure.

Further Exploration

Explore additional filtering options and instance attributes using the boto3 documentation. You can filter by various criteria such as instance ID, AMI ID, and more.