You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

community.general.netcup_dns – manage Netcup DNS records

Note

This plugin is part of the community.general collection (version 3.8.3).

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.general.

To use it in a playbook, specify: community.general.netcup_dns.

Synopsis

• Manages DNS records via the Netcup API, see the docs https://ccp.netcup.net/run/webservice/servers/endpoint.php

Requirements

The below requirements are needed on the host that executes this module.

• nc-dnsapi >= 0.1.3

Parameters

Parameter	Comments
api_key string / required	API key for authentication, must be obtained via the netcup CCP (https://ccp.netcup.net)
api_password string / required	API password for authentication, must be obtained via the netcup CCP (https://ccp.netcup.net)
customer_id integer / required	Netcup customer id
domain string / required	Domainname the records should be added / removed
priority integer	Record priority. Required for type=MX
record aliases: name string	Record to add or delete, supports wildcard (*). Default is @ (e.g. the zone name) Default: “@”
solo boolean	Whether the record should be the only one for that record type and record name. Only use with state=present This will delete all other records with the same record name and type. Choices: no ← (default) yes
state string	Whether the record should exist or not Choices: present ← (default) absent
type string / required	Record type Choices: A AAAA MX CNAME CAA SRV TXT TLSA NS DS
value string / required	Record value

Examples

- name: Create a record of type A
  community.general.netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    domain: "example.com"
    name: "mail"
    type: "A"
    value: "127.0.0.1"

- name: Delete that record
  community.general.netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    domain: "example.com"
    name: "mail"
    type: "A"
    value: "127.0.0.1"
    state: absent

- name: Create a wildcard record
  community.general.netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    domain: "example.com"
    name: "*"
    type: "A"
    value: "127.0.1.1"

- name: Set the MX record for example.com
  community.general.netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    domain: "example.com"
    type: "MX"
    value: "mail.example.com"

- name: Set a record and ensure that this is the only one
  community.general.netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    name: "demo"
    domain: "example.com"
    type: "AAAA"
    value: "::1"
    solo: true

Return Values

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

Key	Description
records complex	list containing all records Returned: success
id integer	internal id of the record Returned: success Sample: 12345
name string	the record name Returned: success Sample: “fancy-hostname”
priority integer	the record priority (only relevant if type=MX) Returned: success Sample: 0
type string	the record type Returned: succcess Sample: “A”
value string	the record destination Returned: success Sample: “127.0.0.1”

Authors

• Nicolai Buchwitz (@nbuchwitz)