EC2 Handler

Amazon EC2 (Elastic Compute Cloud) is a service that provides secure, resizable compute capacity in the cloud. It allows you to launch virtual servers (instances), manage storage volumes, security groups, and networking configurations. With the EC2 handler, you can programmatically retrieve and manage EC2 resources such as instances, volumes, AMIs, snapshots, and more.

Example

To create the AWSEC2Handler object with AWS credentials. The AWSEC2Handler connects to AWS EC2 using access credentials (access key, secret key) and a region name. It enables seamless interaction with EC2 for retrieving and managing compute resources.

ec2_handler_test.py

import os
from superagentx_handlers.aws.ec2 import AWSEC2Handler

ec2_handler = AWSEC2Handler(
    aws_access_key_id=os.getenv("AWS_ACCESS_KEY_ID"),
    aws_secret_access_key=os.getenv("AWS_SECRET_ACCESS_KEY"),
    region_name="eu-central-1"
)

Get Instances:
The get_instances method fetches all EC2 instances.

await ec2_handler.get_instances()
print(instances)

Get Security Groups:
The get_security_groups method fetches all security groups.

await ec2_handler.get_security_groups()
print(security_groups)

Get Volumes:
The get_volumes method fetches all EBS volumes.

await ec2_handler.get_volumes()
print(volumes)

Get AMIs:
The get_amis method fetches all AMIs owned by the account.

await ec2_handler.get_amis()
print(amis)

Get Snapshots:
The get_snapshots method fetches all snapshots owned by the account.

await ec2_handler.get_snapshots()
print(snapshots)

Get Key Pairs:
The get_key_pairs method fetches all key pairs.

key_pairs = await ec2_handler.get_key_pairs()
print(key_pairs)

Get Network Interfaces:
The get_network_interfaces method fetches all network interfaces.

network_interfaces = await ec2_handler.get_network_interfaces()
print(network_interfaces)

Collect All EC2 Resources:
The collect_all_ec2 method fetches all EC2 resources in parallel.

await ec2_handler.collect_all_ec2()
print(all_ec2_data)

Get Started

Key Components

Pipe Interface

Handlers (Tools)

Example

​Example

Example