Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
A basic boto3 based tool for retrieving information from running EC2 instances.
from collections import defaultdict
import boto3
A tool for retrieving basic information from the running EC2 instances.
# Connect to EC2
ec2 = boto3.resource('ec2')
# Get information for all running instances
running_instances = ec2.instances.filter(Filters=[{
'Name': 'instance-state-name',
'Values': ['running']}])
ec2info = defaultdict()
for instance in running_instances:
for tag in instance.tags:
if 'Name'in tag['Key']:
name = tag['Value']
# Add instance info to a dictionary
ec2info[] = {
'Name': name,
'Type': instance.instance_type,
'State': instance.state['Name'],
'Private IP': instance.private_ip_address,
'Public IP': instance.public_ip_address,
'Launch Time': instance.launch_time
attributes = ['Name', 'Type', 'State', 'Private IP', 'Public IP', 'Launch Time']
for instance_id, instance in ec2info.items():
for key in attributes:
print("{0}: {1}".format(key, instance[key]))

This comment has been minimized.

Copy link

sandygvs commented Sep 6, 2017

is there a way to filter out ASG specific to VPC or subnets via python boto? I tried with filter but no luck.

Any help is much appreciated


This comment has been minimized.

Copy link

ikekim commented Sep 15, 2018

I like this code because I was unable to find any other code example of using boto3 and printing the specific tag values.

However, looks like this code would not run properly if the running EC2s have multiple tag names that have "Name" in the tag names.

For example, the running instances has a tag name "Name" and value "web1" and has another tag name "Cluster Name" and value "US-West". I have not tested it yet, but I will circle back after I test it.


This comment has been minimized.

Copy link

TacMechMonkey commented Feb 11, 2019

@sandygvs / anyone else looking for an answer to the above (if I understand the question correctly) - if you're referring to filtering this code by VPC, subnets etc or limiting to a region you can add things like:

import boto3
from collections import defaultdict

region = 'ap-southeast-2'
az = 'ap-southeast-2a'
vpc = 'vpc-12345678'
subnet = 'subnet-12345678'
ec2 = boto3.resource('ec2', region)

running_instances = ec2.instances.filter(
        'Name': 'instance-state-name',
        'Values': ['running']
        'Name': 'availability-zone',
        'Values': [az]
        'Name': 'vpc-id',
        'Values': [vpc]
        'Name': 'subnet-id',
        'Values': [subnet]

If you mean ASG as in outputting security groups, you can add 'SG': instance.security_groups at the end of ec2info, and include it as an attribute.


This comment has been minimized.

Copy link

ghost commented May 24, 2019

As @ikekim said this will not work properly if instance.tags has more than one tag with a value which has 'Name` as a substring, e.g.

>>> 'Name' in 'NameOfEmployee'
>>> 'name' in 'dog'
>>> 'Name' in 'Names'

I used

if tag['Key'] == 'Name'

...because if you examine the instance.tags list of dicts there is only one 'Key' with a value of 'Name'


This comment has been minimized.

Copy link

LilianaChan commented Dec 2, 2019

Hola buen dia tengo una duda, como podria obtener el nombre de la instancia ?


This comment has been minimized.

Copy link

ahmadzaikk commented Apr 28, 2020

Is there a way to send the result to email?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.