Amazon EC2 Metadata Helper Script

ec2-metadata.sh

#!/bin/bash
#
#########################################################################
#This software code is made available "AS IS" without warranties of any #
#kind. You may copy, display, modify and redistribute the software      #
#code either by itself or as incorporated into your code; provided that #
#you do not remove any proprietary notices. Your use of this software   #
#code is at your own risk and you waive any claim against Amazon        #
#Digital Services, Inc. or its affiliates with respect to your use of   #
#this software code. (c) 2006-2007 Amazon Digital Services, Inc. or its #
#affiliates.                                                            #
#########################################################################

function print_help()
{
echo "ec2-metadata v0.1.1
Use to retrieve EC2 instance metadata from within a running EC2 instance. 
e.g. to retrieve instance id: ec2-metadata -i
		 to retrieve ami id: ec2-metadata -a
		 to get help: ec2-metadata --help
For more information on Amazon EC2 instance meta-data, refer to the documentation at
http://docs.amazonwebservices.com/AWSEC2/2008-05-05/DeveloperGuide/AESDG-chapter-instancedata.html

Usage: ec2-metadata <option>
Options:
--all                     Show all metadata information for this host (also default).
-a/--ami-id               The AMI ID used to launch this instance
-l/--ami-launch-index     The index of this instance in the reservation (per AMI).
-m/--ami-manifest-path    The manifest path of the AMI with which the instance was launched.
-n/--ancestor-ami-ids     The AMI IDs of any instances that were rebundled to create this AMI.
-b/--block-device-mapping Defines native device names to use when exposing virtual devices.
-i/--instance-id          The ID of this instance
-t/--instance-type        The type of instance to launch. For more information, see Instance Types.
-h/--local-hostname       The local hostname of the instance.
-o/--local-ipv4           Public IP address if launched with direct addressing; private IP address if launched with public addressing.
-k/--kernel-id            The ID of the kernel launched with this instance, if applicable.
-z/--availability-zone    The availability zone in which the instance launched. Same as placement
-c/--product-codes        Product codes associated with this instance.
-p/--public-hostname      The public hostname of the instance.
-v/--public-ipv4          NATted public IP Address
-u/--public-keys          Public keys. Only available if supplied at instance launch time
-r/--ramdisk-id           The ID of the RAM disk launched with this instance, if applicable.
-e/--reservation-id       ID of the reservation.
-s/--security-groups      Names of the security groups the instance is launched in. Only available if supplied at instance launch time
-d/--user-data            User-supplied data.Only available if supplied at instance launch time."
}

#check some basic configurations before running the code
function chk_config()
{
	#check if run inside an ec2-instance
	x=$(curl -s http://169.254.169.254/)
	if [ $? -gt 0 ]; then
		echo '[ERROR] Command not valid outside EC2 instance. Please run this command within a running EC2 instance.'
		exit 1
	fi
}

#print standard metric
function print_normal_metric() {
	metric_path=$2
	echo -n $1": "
	RESPONSE=$(curl -fs http://169.254.169.254/latest/${metric_path}/)
	if [ $? == 0 ]; then
		echo $RESPONSE
	else
		echo not available
	fi
}

#print block-device-mapping
function print_block-device-mapping()
{
echo 'block-device-mapping: '
x=$(curl -fs http://169.254.169.254/latest/meta-data/block-device-mapping/)
if [ $? -eq 0 ]; then
	for i in $x; do
		echo -e '\t' $i: $(curl -s http://169.254.169.254/latest/meta-data/block-device-mapping/$i)
	done
else
	echo not available
fi
}

#print public-keys
function print_public-keys()
{
	echo 'public-keys: '
	x=$(curl -fs http://169.254.169.254/latest/meta-data/public-keys/)
	if [ $? -eq 0 ]; then
		for i in $x; do
			index=$(echo $i|cut -d = -f 1)
			keyname=$(echo $i|cut -d = -f 2)
			echo keyname:$keyname
			echo index:$index
			format=$(curl -s http://169.254.169.254/latest/meta-data/public-keys/$index/)
			echo format:$format
			echo 'key:(begins from next line)'
			echo $(curl -s http://169.254.169.254/latest/meta-data/public-keys/$index/$format)
		done
	else
		echo not available
	fi
}


function print_all()
{
	print_normal_metric ami-id meta-data/ami-id
	print_normal_metric ami-launch-index meta-data/ami-launch-index
	print_normal_metric ami-manifest-path meta-data/ami-manifest-path
	print_normal_metric ancestor-ami-ids meta-data/ancestor-ami-ids
	print_block-device-mapping
	print_normal_metric instance-id meta-data/instance-id
	print_normal_metric instance-type meta-data/instance-type
	print_normal_metric local-hostname meta-data/local-hostname
	print_normal_metric local-ipv4 meta-data/local-ipv4
	print_normal_metric kernel-id meta-data/kernel-id
	print_normal_metric placement meta-data/placement/availability-zone
	print_normal_metric product-codes meta-data/product-codes
	print_normal_metric public-hostname meta-data/public-hostname
	print_normal_metric public-ipv4 meta-data/public-ipv4
	print_public-keys
	print_normal_metric ramdisk-id /meta-data/ramdisk-id
	print_normal_metric reservation-id /meta-data/reservation-id
	print_normal_metric security-groups meta-data/security-groups
	print_normal_metric user-data user-data
}

#check if run inside an EC2 instance
chk_config

#command called in default mode
if [ "$#" -eq 0 ]; then
	print_all
fi

#start processing command line arguments
while [ "$1" != "" ]; do
	case $1 in
	-a | --ami-id )                print_normal_metric ami-id meta-data/ami-id
																 ;;
	-l | --ami-launch-index )      print_normal_metric ami-launch-index meta-data/ami-launch-index
																 ;;
	-m | --ami-manifest-path )     print_normal_metric ami-manifest-path meta-data/ami-manifest-path
																 ;;
	-n | --ancestor-ami-ids )      print_normal_metric ancestor-ami-ids meta-data/ancestor-ami-ids
																 ;;
	-b | --block-device-mapping )  print_block-device-mapping
																 ;;
	-i | --instance-id )           print_normal_metric instance-id meta-data/instance-id
																 ;;
	-t | --instance-type )         print_normal_metric instance-type meta-data/instance-type
																 ;;
	-h | --local-hostname )        print_normal_metric local-hostname meta-data/local-hostname
																 ;;
	-o | --local-ipv4 )            print_normal_metric local-ipv4 meta-data/local-ipv4
																 ;;
	-k | --kernel-id )             print_normal_metric kernel-id meta-data/kernel-id
																 ;;
	-z | --availability-zone )     print_normal_metric placement meta-data/placement/availability-zone
																 ;;
	-c | --product-codes )         print_normal_metric product-codes meta-data/product-codes
																 ;;
	-p | --public-hostname )       print_normal_metric public-hostname meta-data/public-hostname
																 ;;
	-v | --public-ipv4 )           print_normal_metric public-ipv4 meta-data/public-ipv4
																 ;;
	-u | --public-keys )           print_public-keys
																 ;;
	-r | --ramdisk-id )            print_normal_metric ramdisk-id /meta-data/ramdisk-id
																 ;;
	-e | --reservation-id )        print_normal_metric reservation-id /meta-data/reservation-id
																 ;;
	-s | --security-groups )       print_normal_metric security-groups meta-data/security-groups
																 ;;
	-d | --user-data )             print_normal_metric user-data user-data
																 ;;
	-h | --help )                  print_help
								 exit
																 ;;
	--all )                        print_all
								 exit 
																 ;;
	* )                            print_help
								 exit 1
	esac
	shift
done

https://aws.amazon.com/code/ec2-instance-metadata-query-tool/