diff --git a/README-dnszone.md b/README-dnszone.md index 48b019a99b7dcd59a6c84a00df9cd72d713e6b94..3f4827b9af4ee1d42f570cb316049df3659c86da 100644 --- a/README-dnszone.md +++ b/README-dnszone.md @@ -190,6 +190,17 @@ Variable | Description | Required `skip_nameserver_check` | Force DNS zone creation even if nameserver is not resolvable | no +Return Values +============= + +ipadnszone +---------- + +Variable | Description | Returned When +-------- | ----------- | ------------- +`dnszone` | DNS Zone dict with zone name infered from `name_from_ip`. <br>Options: | If `state` is `present`, `name_from_ip` is used, and a zone was created. + | `name` - The name of the zone created, inferred from `name_from_ip`. | Always + Authors ======= diff --git a/playbooks/dnszone/dnszone-reverse-from-ip.yml b/playbooks/dnszone/dnszone-reverse-from-ip.yml index 56938721a29253c8d350cc079f34a505f37a7454..218a31895d285096eb0a1ce75b18e304b77cccae 100644 --- a/playbooks/dnszone/dnszone-reverse-from-ip.yml +++ b/playbooks/dnszone/dnszone-reverse-from-ip.yml @@ -7,4 +7,9 @@ - name: Ensure zone exist, finding zone name from IP address. ipadnszone: ipaadmin_password: SomeADMINpassword - name_from_ip: 10.1.2.3 + name_from_ip: 10.1.2.3/24 + register: result + + - name: Zone name inferred from `name_from_ip` + debug: + msg: "Zone created: {{ result.dnszone.name }}" diff --git a/plugins/modules/ipadnszone.py b/plugins/modules/ipadnszone.py index 6a90fa2b2c80a2ca713efbb5503d209bc447867c..93eac07cd04cbf42363f2d39219a9ad8629e2170 100644 --- a/plugins/modules/ipadnszone.py +++ b/plugins/modules/ipadnszone.py @@ -192,6 +192,14 @@ EXAMPLES = """ """ RETURN = """ +dnszone: + description: DNS Zone dict with zone name infered from `name_from_ip`. + returned: + If `state` is `present`, `name_from_ip` is used, and a zone was created. + options: + name: + description: The name of the zone created, inferred from `name_from_ip`. + returned: always """ from ipapython.dnsutil import DNSName # noqa: E402