community.dns.hosttech_dns_record module – Add or delete a single record 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
.
New in community.dns 2.0.0
Synopsis
Creates and deletes single DNS records in Hosttech DNS service.
If you do not want to add/remove values, but replace values, you will be interested in modifying a record set and not a single record. This is in particular important when working with
CNAME
andSOA
records. Use the community.dns.hosttech_dns_record_set module for working with record sets.Records are matched by prefix / record name and value.
This module replaces
hosttech_dns_record
from community.dns before 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 Exactly one of record and prefix must be specified. |
|
The full DNS record to create or delete. Exactly one of record and prefix must be specified. |
|
Specifies the state of the resource record. Choices:
|
|
The TTL to give the new record, in seconds. This is not used for record deletion. Default: |
|
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 create or delete. Choices:
|
|
The new value when creating a DNS record. When deleting a record all values for the record must be specified or it will not be deleted. |
|
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_name 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 |
Can run in |
|
Support: full |
Will return details on what has changed (or possibly needs changing in |
Examples
- name: Add a new.foo.com A record
community.dns.hosttech_dns_record:
state: present
zone: foo.com
record: new.foo.com
type: A
ttl: 7200
value: 1.1.1.1
hosttech_token: access_token
- name: Remove a new.foo.com A record
community.dns.hosttech_dns_record:
state: absent
zone_name: foo.com
record: new.foo.com
type: A
ttl: 7200
value: 2.2.2.2
hosttech_token: access_token
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key |
Description |
---|---|
The ID of the zone. Returned: success Sample: |
Collection links
Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication