0.0
No release in over a year
Retrieve AWS IP ranges with ease.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 0.7.0
~> 2.0
>= 1.0, < 3.0
 Project Readme

aws-ip-ranges

Gem Version Workflow

Retrieve AWS IP ranges with ease.

Installation

Run:

gem install aws-ip-ranges

Usage

Code

AwsIpRanges.fetch(service: ['cloudfront', 's3']) # => [#<IPAddr: IPv4:3.2.34.0/255.255.255.192>,  #<IPAddr: IPv4:3.5.140.0/255.255.252.0>]
AwsIpRanges.fetch(region: 'eu-west-3')
AwsIpRanges.fetch(only_ipv4: true)
AwsIpRanges.fetch(only_ipv6: true)

CLI

Execute:

$ aws-ip-ranges list
35.172.155.192/27
35.172.155.96/27
44.192.134.240/28
...
2600:1f70:c000:400::/56

See the help for more usage:

Command:
  aws-ip-ranges list

Usage:
  aws-ip-ranges list

Description:
  List all AWS IP ranges

Options:
  --[no-]only-ipv6                  # Whether to include only IPv6 ranges., default: false
  --[no-]only-ipv4                  # Whether to include only IPv4 ranges., default: false
  --service=VALUE1,VALUE2,..        # Which services to include. By default, includes all.
  --region=VALUE1,VALUE2,..         # Which regions to include. By default, includes all.
  --help, -h                        # Print this help

Examples:
  aws-ip-ranges list                                             # Prints all AWS IP ranges
  aws-ip-ranges list --only-ipv4                                 # Prints all AWS IPv4 ranges
  aws-ip-ranges list --only-ipv6 --service=cloudfront,global     # Prints AWS Cloudfront and Global IPv6 ranges
  aws-ip-ranges list --only-ipv6 --service=s3 --region=eu-west-1 # Prints AWS S3 IPv6 ranges in the eu-west-1 region

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

We are not accepting outside contribution on this library at the moment.

License

The gem is available as open source under the terms of the MIT License.