NAME VM::EC2::REST::placement_group - Placement groups

SYNOPSIS

        use VM::EC2 ':hpc'

METHODS

       Placement groups provide low latency and high-bandwidth connectivity between cluster
       instances within a single Availability Zone. Create a placement group and then launch
       cluster instances into it. Instances launched within a placement group participate in a
       full-bisection bandwidth cluster appropriate for HPC applications.

       Implemented:
        CreatePlacementGroup
        DeletePlacementGroup
        DescribePlacementGroups

   @groups = $ec2->describe_placement_groups(@group_names)
   @groups = $ec2->describe_placement_groups(\%filters)
   @groups = $ec2->describe_placement_groups(-group_name=>\@ids,-filter=>\%filters)
       This method will return information about cluster placement groups as a list of
       VM::EC2::PlacementGroup objects.

       Optional arguments:

        -group_name         -- Scalar or arrayref of placement group names.

        -filter             -- Tags and other filters to apply.

       The filters available are described fully at:
       http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribePlacementGroups.html

           group-name
           state
           strategy

   $success = $ec2->create_placement_group($group_name)
   $success = $ec2->create_placement_group(-group_name=>$name,-strategy=>$strategy)
       Creates a placement group that cluster instances are launched into.

       Required arguments:
        -group_name          -- The name of the placement group to create

       Optional:
        -strategy            -- As of 2012-12-23, the only available option is 'cluster'
                                so the parameter defaults to that.

       Returns true on success.

   $success = $ec2->delete_placement_group($group_name)
   $success = $ec2->delete_placement_group(-group_name=>$group_name)
       Deletes a placement group from the account.

       Required arguments:
        -group_name          -- The name of the placement group to delete

       Returns true on success.

SEE ALSO

       VM::EC2

AUTHOR

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

       Copyright (c) 2011 Ontario Institute for Cancer Research

       This package and its accompanying libraries is free software; you can redistribute it
       and/or modify it under the terms of the GPL (either version 1, or at your option, any
       later version) or the Artistic License 2.0.  Refer to LICENSE for the full license text.
       In addition, please see DISCLAIMER.txt for disclaimers of warranty.