Skip to main content

Simple AWS EC2 devtool.

Project description

https://github.com/MacHu-GWU/simple_aws_ec2-project/workflows/CI/badge.svg https://codecov.io/gh/MacHu-GWU/simple_aws_ec2-project/branch/main/graph/badge.svg https://img.shields.io/pypi/v/simple_aws_ec2.svg https://img.shields.io/pypi/l/simple_aws_ec2.svg https://img.shields.io/pypi/pyversions/simple_aws_ec2.svg https://img.shields.io/badge/Release_History!--None.svg?style=social https://img.shields.io/badge/STAR_Me_on_GitHub!--None.svg?style=social
https://img.shields.io/badge/Link-Install-blue.svg https://img.shields.io/badge/Link-GitHub-blue.svg https://img.shields.io/badge/Link-Submit_Issue-blue.svg https://img.shields.io/badge/Link-Request_Feature-blue.svg https://img.shields.io/badge/Link-Download-blue.svg

Welcome to simple_aws_ec2 Documentation

Usage:

from simple_aws_ec2 import Ec2Instance
from boto_session_manager import BotoSesManager

bsm = BotoSesManager()

# get ec2 by id
ec2_inst = Ec2Instance.from_id(bsm, "i-1a2b3c")
# get ec2 by running code from inside of ec2
ec2_inst = EC2Instance.from_ec2_inside(bsm)
# get ec2 by it's name, it returns a iter proxy that may have multiple ec2
ec2_inst = EC2Instance.from_ec2_name(bsm, "my-server").one_or_none()
# get ec2 by tag key value pair, it returns a iter proxy that may have multiple ec2
ec2_inst = EC2Instance.from_tag_key_value(bsm, key="Env", value="prod").one_or_none()
ec2_inst = EC2Instance.query(bsm, filters=..., instnace_ids=...).all()

print(ec2_inst.id)
print(ec2_inst.status)
print(ec2_inst.public_ip)
print(ec2_inst.private_ip)
print(ec2_inst.vpc_id)
print(ec2_inst.subnet_id)
print(ec2_inst.security_groups)
print(ec2_inst.image_id)
print(ec2_inst.instance_type)
print(ec2_inst.key_name)
print(ec2_inst.tags)
print(ec2_inst.data)

print(ec2_inst.is_running()
print(ec2_inst.is_stopped()
print(ec2_inst.is_pending())
print(ec2_inst.is_shutting_down()
print(ec2_inst.is_stopping()
print(ec2_inst.is_terminated()

print(ec2_inst.is_ready_to_start()
print(ec2_inst.is_ready_to_stop()

Install

simple_aws_ec2 is released on PyPI, so all you need is:

$ pip install simple_aws_ec2

To upgrade to latest version:

$ pip install --upgrade simple_aws_ec2

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

simple_aws_ec2-0.2.1.tar.gz (12.9 kB view hashes)

Uploaded Source

Built Distribution

simple_aws_ec2-0.2.1-py2.py3-none-any.whl (8.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page