oracular (3) VM::EC2::REST::zone.3pm.gz

NAME VM::EC2::REST::zone - Fetch information on EC2 regions and availability zones

SYNOPSIS

        use VM::EC2 qw(:standard);

EC2 REGIONS AND AVAILABILITY ZONES

       This section describes methods that allow you to fetch information on EC2 regions and availability zones.
       These methods return objects of type VM::EC2::Region and VM::EC2::AvailabilityZone.

       Implemented:
        DescribeAvailabilityZones
        DescribeRegions

       Unimplemented:
        (none)

   @regions = $ec2->describe_regions(@list)
   @regions = $ec2->describe_regions(-region_name=>\@list)
       Describe regions and return a list of VM::EC2::Region objects. Call with no arguments to return all
       regions. You may provide a list of regions in either of the two forms shown above in order to restrict
       the list returned. Glob-style wildcards, such as "*east") are allowed.

   @zones = $ec2->describe_availability_zones(@names)
   @zones = $ec2->describe_availability_zones(-zone_name=>\@names,-filter=>\%filters)
       Describe availability zones and return a list of VM::EC2::AvailabilityZone objects. Call with no
       arguments to return all availability regions. You may provide a list of zones in either of the two forms
       shown above in order to restrict the list returned. Glob-style wildcards, such as "*east") are allowed.

       If you provide a single argument consisting of a hashref, it is treated as a -filter argument. In other
       words:

        $ec2->describe_availability_zones({state=>'available'})

       is equivalent to

        $ec2->describe_availability_zones(-filter=>{state=>'available'})

       Availability zone filters are described at
       http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeAvailabilityZones.html

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.