awsipranges
Work with the AWS IP address ranges in native Python.
Amazon Web Services (AWS) publishes its current IP address ranges in JSON format. Python v3 provides an ipaddress module in the standard library that allows you to create, manipulate, and perform operations on IPv4 and IPv6 addresses and networks. Wouldn't it be nice if you could work with the AWS IP address ranges like native Python objects?
Features
- Work with the AWS IP prefixes as a simple
AWSIPPrefixescollection. - Quickly check if an IP address, interface, or network is contained in the AWS IP address ranges.
- Get the AWS IP prefix that contains an IP address, interface, or network.
- See what services are served from an IP prefix.
- Filter the AWS IP prefixes by region, network border group, service, and IP prefix version.
- Use the AWS prefix data in your app or automation scripts in the format required by your infrastructure.
- Easily validate the TLS certificate presented by the IP ranges server.
- awsipranges has no third-party dependencies and is compatible with CPython v3.7+.
>>> import awsipranges
>>> aws_ip_ranges = awsipranges.get_ranges(cafile="amazon_root_certificates.pem")
>>> '52.94.5.15' in aws_ip_ranges
True
>>> aws_ip_ranges['52.94.5.15']
AWSIPv4Prefix('52.94.5.0/24', region='eu-west-1', network_border_group='eu-west-1', services=('AMAZON', 'DYNAMODB'))
>>> aws_ip_ranges.filter(services='CODEBUILD')
{'create_date': datetime.datetime(2021, 8, 24, 1, 31, 14, tzinfo=datetime.timezone.utc),
'ipv4_prefixes': (AWSIPv4Prefix('3.26.127.24/29', region='ap-southeast-2', network_border_group='ap-southeast-2', services=('CODEBUILD',)),
AWSIPv4Prefix('3.38.90.8/29', region='ap-northeast-2', network_border_group='ap-northeast-2', services=('CODEBUILD',)),
AWSIPv4Prefix('3.68.251.232/29', region='eu-central-1', network_border_group='eu-central-1', services=('CODEBUILD',)),
AWSIPv4Prefix('3.98.171.224/29', region='ca-central-1', network_border_group='ca-central-1', services=('CODEBUILD',)),
AWSIPv4Prefix('3.101.177.48/29', region='us-west-1', network_border_group='us-west-1', services=('CODEBUILD',)),
...),
'ipv6_prefixes': (),
'sync_token': '1629768674'}
>>> for prefix in aws_ip_ranges.filter(regions='eu-west-1', services='DYNAMODB'):
... print(prefix.network_address, prefix.netmask)
...
52.94.5.0 255.255.255.0
52.94.24.0 255.255.254.0
52.94.26.0 255.255.254.0
52.119.240.0 255.255.248.0
Installation
Installing and upgrading awsipranges is easy:
Install via PIP
❯ pip install awsipranges
Upgrade to the latest version
❯ pip install --upgrade awsipranges
Documentation
Excellent documentation is now available at: https://aws-samples.github.io/awsipranges/
Check out the Quickstart to dive in and begin using awsipranges.
Contribute
See CONTRIBUTING for information on how to contribute to this project.
Security
See CONTRIBUTING for information on how to report a security issue with this project.
License
This project is licensed under the Apache-2.0 License.
4 Nov 7, 2022
3 Aug 31, 2022
89 Jan 5, 2023
7 Oct 18, 2022
1 May 20, 2022
3 Feb 2, 2022
325 Dec 1, 2022
92 Apr 6, 2022
109 Dec 30, 2022
2 Jan 05, 2022
4 Jun 08, 2022
2 Oct 22, 2021
304 Jan 01, 2023
2 Jul 20, 2022
83 Dec 20, 2022
1 Feb 07, 2022
4 May 27, 2022
2 Jun 17, 2022
10 Feb 19, 2022
8 Feb 15, 2022
4 Nov 02, 2022
6 Aug 21, 2022
3 Jun 26, 2022
4.5k Dec 30, 2022
28 Oct 20, 2022
1 Nov 08, 2021
![Hüzünlü Artemis [HuzunluArtemis]](https://avatars.githubusercontent.com/u/84624971?v=4&s=60)
5 Jun 29, 2022
36 Dec 23, 2022
201 Jan 03, 2023