Release Summary
This release introduces three new modules. The new modules provide fact-gathering functionalities, enabling users to retrieve zone information, specific zone metadata, and DNS record sets from within their playbooks.
New Modules
-
zone_facts
Retrieves a list of zones from UltraDNS via the/v3/zonesendpoint. This module supports cursor-based pagination and offers filtering options by parameters such asname,type,status,account, andnetwork. The gathered data is returned as Ansible facts underansible_facts.zones. -
zone_meta_facts
Fetches metadata for specific zones by sending GET requests to the/v3/zones/{zone_name}endpoint. Users can supply a list of zone names, and the module will query each one individually. It gracefully handles cases where a zone is not found and returns the metadata as Ansible facts underansible_facts.zone_meta. -
record_facts
Retrieves DNS record sets (RRsets) for a given zone using the/v3/zones/{zoneName}/rrsetsendpoint. This module supports offset-based pagination and accepts several filtering parameters includingttl,owner,value,kind,reverse, andsys_generated. The complete list of RRSet records is returned as Ansible facts underansible_facts.record_facts.
Additional Information
These modules are built in line with Ansible best practices for fact gathering and have been designed to provide clear separation between data retrieval and state-changing operations.
Examples
For detailed usage instructions and examples, please refer to the respective module documentation within the collection, and refer to the demonstration playbooks in the examples directory.