NAME VM::EC2::REST::zone
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
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.