NAME

Net::Amazon::EC2::Metadata - Retrieves data from EC2 Metadata service. Both script and API; Works only from an EC2 instance.

VERSION

This document describes Net::Amazon::EC2::Metadata; version 0.10

SYNOPSIS

    #  running on an EC2 instance.
    use Perl6::Say;
    use Net::Amazon::EC2::Metadata;
    no warnings 'uninitialized';
    my $data = Net::Amazon::EC2::Metadata->all_data;
    for (sort keys %$data)      {
        say "$_: $data->{$_}";
    }

    ###############
    use Net::Amazon::EC2::Metadata;
    my $metadata_service= Net::Amazon::EC2::Metadata->new();  
    warn $metadata_service->ami_id; 

DESCRIPTION

This module queries Amazon's Elastic Compute Cloud Metadata service described at: http://docs.amazonwebservices.com/AWSEC2/2007-08-29/DeveloperGuide/AESDG-chapter-instancedata.html . It also fetches 'user_data' which follows the same API but is often no considered part of the metadata service by Amazons documentation. The module also ships with a command line tool ec2meta that provides the same data.

THIS MODULE WILL ONLY WORK ON AN EC2 INSTANCE.

METHODS

new()

A constructor - for convenience all methods are class methods.

all_data()

Returns a hash ref of all the keys, and their values. Note: this means that public_keys is a listing of the keys not a listing of the values.

available_data()

A listing of all the meta_data and user_data available from this module.

ami_id
ami_manifest_path
ami_launch_index
ancestor_ami_ids
instance_id
instance_type
local_hostname
public_hostname
local_ipv4
public_ipv4
reservation_id
security_groups
product_codes
user_data

These methods all return the verbatim data from the calls to the service, and take no parameters.

public_keys($key)
public_key($key)

Lists public keys if no key given, returns content of key if a key is given.

AUTHOR

Nathan McFarland nathan@cpan.org

COPYRIGHT

Copyright (c) 2008 Nathan McFarland. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

 Amazon EC2 Documentation: L<http://docs.amazonwebservices.com/AWSEC2/2007-08-29/DeveloperGuide/>
 Amazon EC2 Metadata Documentation: L<http://docs.amazonwebservices.com/AWSEC2/2007-08-29/DeveloperGuide/AESDG-chapter-instancedata.html>
 Amazon Tutorial on EC2 Metadata: L<http://developer.amazonwebservices.com/connect/entry.jspa?externalID=1085&categoryID=100>