#!/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
