Net::Amazon::R53::HostedZone - Representation of a Route53 HostedZone
This document describes version 0.002 of Net::Amazon::R53::HostedZone - released January 09, 2013 as part of Net-Amazon-R53.
This class represents a Route53 hosted zone entity. You should never need to construct this class yourself, as the parent will do it for you when appropriate.
These attributes are required, and must have their values supplied during object construction.
This attribute reflects the number of mutable records; which will always be two less than the total number. Accordingly, this number is adjusted down two from the raw count returned from Route53 in a hosted zone query.
These attributes are lazily constructed from another source (e.g. required attributes, external source, a BUILD() method, or some combo thereof). You can set these values at construction time, though this is generally neither required nor recommended.
The full hosted zone ID Amazon returns looks something like:
However, most operations (and indeed, this library) use just the last part:
This attribute builds the short form for you on demand.
Contains the set of two Amazon-created records that lead every host zone's record set set.
Contains this hosted zone's last fetched set of resource records. This set does not include the Amazon-supplied "immutable" ones.
Clears our cached set of resource records. (Will be rebuilt on next access)
True if the resource records for this zone have been fetched. Useful to determine if this has happened without calling anything that may cause the fetch operation to be executed.
Returns true if the zone contains no resource record sets other than the immutable ones Amazon supplies. A "pristine" zone can be deleted.
Given an AtomicChange instance, apply the changes described to this hosted zone.
Takes a set of either Net::Amazon::R53::ResourceRecordSet::Change or array references suitable to passing to that class' constructor. We return a Net::Amazon::R53::ChangeInfo instance representing the submitted change.
On failure, we throw an error.
We also accept a
multi_batch_ok option, that defaults to false. If set true, change sets with greater than 100 changes are broken up and submitted as multiple requests, in batches of no more than 100 changes at a time.
If we're called in list context, we return the list of change-info objects returned from the multiple operations. If we're called in scalar context, we return the last of the returned info objects.
Delete all records from the zone that Route53 requires to be removed before the zone may be deleted. (That is, all records save the two "immutable" first records, the Route53-generated NS and SOA records.)
Please see those modules/websites for more information related to this module.
Chris Weyl <email@example.com>
Chris Weyl <firstname.lastname@example.org>
This software is Copyright (c) 2012 by Campus Explorer, Inc.
This is free software, licensed under:
The GNU Lesser General Public License, Version 2.1, February 1999