Skip to content

v1.1.0

Latest

Choose a tag to compare

@sbarbett sbarbett released this 21 Mar 02:58
d606ce7

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/zones endpoint. This module supports cursor-based pagination and offers filtering options by parameters such as name, type, status, account, and network. The gathered data is returned as Ansible facts under ansible_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 under ansible_facts.zone_meta.

  • record_facts
    Retrieves DNS record sets (RRsets) for a given zone using the /v3/zones/{zoneName}/rrsets endpoint. This module supports offset-based pagination and accepts several filtering parameters including ttl, owner, value, kind, reverse, and sys_generated. The complete list of RRSet records is returned as Ansible facts under ansible_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.