community.dns.hosttech_dns_record_set_info module – Retrieve record sets in Hosttech DNS service
Note
This module is part of the community.dns collection (version 2.4.2).
You might already have this collection installed if you are using the ansible
package.
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
.
You need further requirements to be able to use this module,
see Requirements for details.
To use it in a playbook, specify: community.dns.hosttech_dns_record_set_info
.
New in community.dns 0.1.0
Synopsis
Retrieves DNS record sets in Hosttech DNS service.
This module was renamed from
community.dns.hosttech_dns_record_info
tocommunity.dns.hosttech_dns_record_set_info
in community.dns 2.0.0.
Requirements
The below requirements are needed on the host that executes this module.
lxml
Parameters
Parameter |
Comments |
---|---|
The password for the Hosttech API user. If provided, hosttech_username must also be provided. Mutually exclusive with hosttech_token. |
|
The password for the Hosttech API user. Mutually exclusive with hosttech_username and hosttech_password. Since community.dns 1.2.0, the alias api_token can be used. |
|
The username for the Hosttech API user. If provided, hosttech_password must also be provided. Mutually exclusive with hosttech_token. |
|
The prefix of the DNS record. This is the part of record before zone_name. For example, if the record to be modified is If what is |
|
The full DNS record to retrieve. If what is |
|
Determines how TXT entry values are converted between the API and this module’s input and output. The value The value The value The default value, Note: the conversion code assumes UTF-8 encoding for values. If you need another encoding use txt_transformation=api and handle the encoding yourself. Choices:
|
|
The type of DNS record to retrieve. Required if what is Choices:
|
|
Describes whether to fetch a single record and type combination, all types for a record, or all records. By default, a single record and type combination is fetched. Note that the return value structure depends on this option. Choices:
|
|
The ID of the DNS zone to modify. Exactly one of zone_name and zone_id must be specified. |
|
The DNS zone to modify. Exactly one of zone and zone_id must be specified. |
Attributes
Attribute |
Support |
Description |
---|---|---|
Action group: community.dns.hosttech added in community.dns 2.4.0 |
Use |
|
Support: full This action does not modify state. |
Can run in |
|
Support: N/A This action does not modify state. |
Will return details on what has changed (or possibly needs changing in |
Examples
- name: Retrieve the details for the A records of new.foo.com
community.dns.hosttech_dns_record_set_info:
zone_name: foo.com
record: new.foo.com
type: A
hosttech_token: access_token
register: rec
- name: Print the A record set
ansible.builtin.debug:
msg: "{{ rec.set }}"
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The fetched record set. Is empty if record set does not exist. Returned: success and what is Sample: |
|
The record prefix. Returned: success Sample: |
|
The record name. Returned: success Sample: |
|
The TTL. If there are records in this set with different TTLs, the minimum of the TTLs will be presented here. Returned: success Sample: |
|
If there are records with different TTL values in this set, this will be the list of TTLs appearing in the records. Every distinct TTL will appear once, and the TTLs are in ascending order. Returned: When there is more than one distinct TTL Sample: |
|
The DNS record type. Returned: success Sample: |
|
The DNS record set’s value. Returned: success Sample: |
|
The list of fetched record sets. Returned: success and what is not Sample: |
|
The record prefix. Returned: success Sample: |
|
The record name. Returned: success Sample: |
|
The TTL. If there are records in this set with different TTLs, the minimum of the TTLs will be presented here. Returned: success Sample: |
|
If there are records with different TTL values in this set, this will be the list of TTLs appearing in the records. Every distinct TTL will appear once, and the TTLs are in ascending order. Returned: When there is more than one distinct TTL Sample: |
|
The DNS record type. Returned: success Sample: |
|
The DNS record set’s value. Returned: success Sample: |
|
The ID of the zone. Returned: success Sample: |
Collection links
Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication