community.dns.hetzner_dns_zone_info module – Retrieve zone information in Hetzner DNS service

Note

This module is part of the community.dns collection (version 2.8.3).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.dns.

To use it in a playbook, specify: community.dns.hetzner_dns_zone_info.

New in community.dns 2.0.0

Synopsis

  • Retrieves zone information in Hetzner DNS service.

Parameters

Parameter

Comments

hetzner_token

aliases: api_token

string / required

The token for the Hetzner API.

If not provided, will be read from the environment variable HETZNER_DNS_TOKEN.

zone_id

string

added in community.dns 0.2.0

The ID of the DNS zone to query.

Exactly one of zone_name and zone_id must be specified.

zone_name

aliases: zone

string

The DNS zone to query.

Exactly one of zone_name and zone_id must be specified.

Attributes

Attribute

Support

Description

action_group

Action group: community.dns.hetzner

added in community.dns 2.4.0

Use group/community.dns.hetzner in module_defaults to set defaults for this module.

check_mode

Support: full

This action does not modify state.

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: N/A

This action does not modify state.

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Examples

- name: Retrieve details for foo.com zone
  community.dns.hetzner_dns_zone_info:
    zone: foo.com
    hetzner_token: access_token
  register: rec

- name: Retrieve details for zone 23
  community.dns.hetzner_dns_zone_info:
    zone_id: 23
    hetzner_token: access_token

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

zone_id

string

The ID of the zone.

Returned: success

Sample: "23"

zone_info

dictionary

Extra information returned by the API.

Returned: success

created

string

The time when the zone was created.

Returned: success

Sample: "2021-07-15T19:23:58Z"

is_secondary_dns

boolean

Indicates whether the zone is a secondary DNS zone.

Returned: success

Sample: true

legacy_dns_host

string

Unknown.

Returned: success

legacy_ns

list / elements=string

List of nameservers during import.

Returned: success

modified

string

The time the zone was last modified.

Returned: success

Sample: "2021-07-15T19:23:58Z"

ns

list / elements=string

List of nameservers the zone should have for using Hetzner’s DNS.

Returned: success

owner

string

Owner of the zone.

Returned: success

paused

boolean

Unknown.

Returned: success

Sample: true

permission

string

Zone’s permissions.

Returned: success

project

string

Unknown.

Returned: success

records_count

integer

Number of records associated to this zone.

Returned: success

Sample: 0

registrar

string

Unknown.

Returned: success

status

string

Status of the zone.

Can be one of verified, failed and pending.

Returned: success

Sample: "verified"

ttl

integer

TTL of zone.

Returned: success

Sample: 0

txt_verification

dictionary

Shape of the TXT record that has to be set to verify a zone.

If name and token are empty, no TXT record needs to be set.

Returned: success

Sample: {"name": "", "token": ""}

name

string

The TXT record’s name.

Returned: success

token

string

The TXT record’s content.

Returned: success

verified

string

Time when zone was verified.

Returned: success

Sample: "2021-07-15T19:23:58Z"

zone_name

integer

The name of the zone.

Returned: success

Sample: "example.com"

Authors

  • Markus Bergholz (@markuman)

  • Felix Fontein (@felixfontein)