Parse ARNs using Python
Motivation
Sometimes, you want to parse an Amazon Resource Name (ARN) into its components to get some useful information from the ARN (e.g. AWS region, account ID, etc).
You can find documentation on ARNs and their components here: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
Installation
pip install arnparse
Examples
S3 Object
from arnparse import arnparse arn = arnparse('arn:aws:s3:::my_corporate_bucket/exampleobject.png') assert arn.partition == 'aws' assert arn.service == 's3' assert arn.region is None assert arn.account_id is None assert arn.resource_type is None assert arn.resource == 'my_corporate_bucket/exampleobject.png'
VPC
from arnparse import arnparse arn = arnparse('arn:aws:ec2:us-east-1:123456789012:vpc/vpc-fd580e98') assert arn.partition == 'aws' assert arn.service == 'ec2' assert arn.region == 'us-east-1' assert arn.account_id == '123456789012' assert arn.resource_type == 'vpc' assert arn.resource == 'vpc-fd580e98'
CloudWatch Alarm
from arnparse import arnparse arn = arnparse('arn:aws:cloudwatch:us-east-1:123456789012:alarm:MyAlarmName') assert arn.partition == 'aws' assert arn.service == 'cloudwatch' assert arn.region == 'us-east-1' assert arn.account_id == '123456789012' assert arn.resource_type == 'alarm' assert arn.resource == 'MyAlarmName'
SNS Topic
from arnparse import arnparse arn = arnparse('arn:aws:sns:*:123456789012:my_corporate_topic') assert arn.partition == 'aws' assert arn.service == 'sns' assert arn.region == '*' assert arn.account_id == '123456789012' assert arn.resource_type is None assert arn.resource == 'my_corporate_topic'
API Gateway
from arnparse import arnparse arn = arnparse('arn:aws:apigateway:us-east-1::a123456789012bc3de45678901f23a45:/test/mydemoresource/*') assert arn.partition == 'aws' assert arn.service == 'apigateway' assert arn.region == 'us-east-1' assert arn.account_id is None assert arn.resource_type is None assert arn.resource == 'a123456789012bc3de45678901f23a45:/test/mydemoresource/*'