1VM::EC2::REST::zone(3)User Contributed Perl DocumentationVM::EC2::REST::zone(3)
2
3
4

NAME VM::EC2::REST::zone

SYNOPSIS

7        use VM::EC2 qw(:standard);
8

EC2 REGIONS AND AVAILABILITY ZONES

10       This section describes methods that allow you to fetch information on
11       EC2 regions and availability zones. These methods return objects of
12       type VM::EC2::Region and VM::EC2::AvailabilityZone.
13
14       Implemented:
15        DescribeAvailabilityZones
16        DescribeRegions
17
18       Unimplemented:
19        (none)
20
21   @regions = $ec2->describe_regions(@list)
22   @regions = $ec2->describe_regions(-region_name=>\@list)
23       Describe regions and return a list of VM::EC2::Region objects. Call
24       with no arguments to return all regions. You may provide a list of
25       regions in either of the two forms shown above in order to restrict the
26       list returned. Glob-style wildcards, such as "*east") are allowed.
27
28   @zones = $ec2->describe_availability_zones(@names)
29   @zones =
30       $ec2->describe_availability_zones(-zone_name=>\@names,-filter=>\%filters)
31       Describe availability zones and return a list of
32       VM::EC2::AvailabilityZone objects. Call with no arguments to return all
33       availability regions. You may provide a list of zones in either of the
34       two forms shown above in order to restrict the list returned. Glob-
35       style wildcards, such as "*east") are allowed.
36
37       If you provide a single argument consisting of a hashref, it is treated
38       as a -filter argument. In other words:
39
40        $ec2->describe_availability_zones({state=>'available'})
41
42       is equivalent to
43
44        $ec2->describe_availability_zones(-filter=>{state=>'available'})
45
46       Availability zone filters are described at
47       http://docs.amazonwebservices.com/AWSEC2/latest/APIReference/ApiReference-query-DescribeAvailabilityZones.html
48

SEE ALSO

50       VM::EC2
51

AUTHOR

53       Lincoln Stein <lincoln.stein@gmail.com>.
54
55       Copyright (c) 2011 Ontario Institute for Cancer Research
56
57       This package and its accompanying libraries is free software; you can
58       redistribute it and/or modify it under the terms of the GPL (either
59       version 1, or at your option, any later version) or the Artistic
60       License 2.0.  Refer to LICENSE for the full license text. In addition,
61       please see DISCLAIMER.txt for disclaimers of warranty.
62
63
64
65perl v5.28.0                      2018-07-15            VM::EC2::REST::zone(3)