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 -	Варианты: существует ← отсутствует	Указывает, должна ли запись существовать
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 сложное		успех	список, содержащий все записи
	id целое число	успех	внутренний идентификатор записи Пример: 12345
	name строка	успех	имя записи Пример: fancy-hostname
	priority целое число	успех	приоритет записи (актуален только если type=MX)
	type строка	успех	тип записи Пример: A
	value строка	успех	назначение записи Пример: 127.0.0.1

Статус

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

Авторы

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.9/modules/netcup_dns_module.html