netcup_dns – управление записями DNS Netcup

Новая версия с 2.7.0.

Описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Управляет записями DNS через API Netcup, см. документацию https://ccp.netcup.net/run/webservice/servers/endpoint.php

Требования

Ниже приведены требования к хосту, на котором выполняется этот модуль.

nc-dnsapi >= 0.1.3

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key - / обязательно		Ключ API для аутентификации, должен быть получен через CCP Netcup (https://ccp.netcup.net)
api_password - / обязательно		Пароль API для аутентификации, должен быть получен через CCP Netcup (https://ccp.netcup.net)
customer_id - / обязательно		Идентификатор клиента Netcup
domain - / обязательно		Доменное имя, к которому должны быть добавлены/удалены записи
priority -		Приоритет записи. Требуется для `type=MX`.
record -	По умолчанию: "@"	Запись для добавления или удаления, поддерживает подстановочные знаки (*). По умолчанию `@` (например, имя зоны). Псевдонимы: имя
solo boolean	Варианты: нет ← да	Указывает, должна ли запись быть единственной для данного типа записи и имени записи. Используйте только с `state=present`. Это удалит все другие записи с тем же именем и типом записи.
state -	Варианты: present ← absent	Указывает, должна ли запись существовать или нет
type - / обязательно	Варианты: A AAAA MX CNAME CAA SRV TXT TLSA NS DS	Тип записи
value - / обязательно		Значение записи

Примеры

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

- name: Delete that record
  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
  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
  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
  netcup_dns:
    api_key: "..."
    api_password: "..."
    customer_id: "..."
    name: "demo"
    domain: "example.com"
    type: "AAAA"
    value: "::1"
    solo: true

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ		Возвращаемое	Описание
records complex		success	список, содержащий все записи
	id integer	success	внутренний идентификатор записи Пример: 12345
	name string	success	имя записи Пример: fancy-hostname
	priority integer	success	приоритет записи (актуален только для type=MX)
	type string	succcess	тип записи Пример: A
	value string	success	назначение записи Пример: 127.0.0.1

Статус

Данный модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Nicolai Buchwitz (@nbuchwitz)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/netcup_dns_module.html