NAME

VM::EC2::Instance::Set - Object describing a set of instances

SYNOPSIS

  use VM::EC2;
  $ec2       = VM::EC2->new(...);
  @instances = $ec2->run_instances(-image_id=>'ami-12345');
  for my $i (@instances) {
     $res    = $i->reservationId;
     $req    = $i->requesterId;
     $owner  = $i->ownerId;
     @groups = $i->groups;
  }

DESCRIPTION

This object is used internally to manage the output of VM::EC2->run_instances(), which returns information about the reservation and security groups as well as the list of launched instances. Because reservations are infrequently used, this object is not used directly; instead the reservation and requester IDs contained within it are stored in the VM::EC2::Instance objects returned by run_instances().

METHODS

One object method is supported:

@instances = $reservation_set->instances()

This will return the instances contained within the instance set.

AUTHOR

Lincoln Stein <lincoln.stein@gmail.com>.