exo_dns_record – Управляет записями DNS в Exoscale DNS

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

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

Обзор

Создание, обновление и удаление записей.

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Exoscale DNS API. С версии 2.4 в качестве значения по умолчанию используется переменная окружения `CLOUDSTACK_KEY`, если она определена.
api_region строка	По умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. С версии 2.4 в качестве значения по умолчанию используется переменная окружения `CLOUDSTACK_REGION`, если она определена.
api_secret строка		Секретный ключ Exoscale DNS API. С версии 2.4 в качестве значения по умолчанию используется переменная окружения `CLOUDSTACK_SECRET`, если она определена.
api_timeout целое число	По умолчанию: 10	Таймаут HTTP для Exoscale DNS API. С версии 2.4 в качестве значения по умолчанию используется переменная окружения `CLOUDSTACK_TIMEOUT`, если она определена.
content -		Содержание записи. Требуется, если `state=present` или `multiple=yes`. псевдонимы: значение, адрес
domain - / обязательно		Домен, к которому относится запись.
multiple булево	Варианты: нет ← да	Присутствует ли более одной записи с аналогичными `name` и `record_type`. Допускается только для некоторых типов записей, например, `record_type=A`, `record_type=NS` или `record_type=MX`. `content` не будет обновляться, а вместо этого используется в качестве ключа для поиска существующих записей.
name -	По умолчанию: ""	Имя записи.
prio -		Приоритет записи. псевдонимы: приоритет
record_type -	Варианты: A ← ALIAS CNAME MX SPF URL TXT NS SRV NAPTR PTR AAAA SSHFP HINFO POOL	Тип записи. псевдонимы: rtype, тип
state -	Варианты: присутствует ← отсутствует	Состояние записи.
ttl -	По умолчанию: 3600	TTL записи в секундах.
validate_certs булево	Варианты: нет да ←	Проверять SSL-сертификаты Exoscale DNS API.

Примечания

Примечание

Так как Exoscale DNS использует один и тот же ключ API и секрет для всех сервисов, мы используем конфигурацию, используемую для Exscale Compute на основе CloudStack. Конфигурация считывается из нескольких мест в следующем порядке. Переменные окружения CLOUDSTACK_KEY, CLOUDSTACK_SECRET. Переменная окружения CLOUDSTACK_CONFIG, указывающая на файл .ini. Файл cloudstack.ini в текущей рабочей директории. Файл .cloudstack.ini в домашнем каталоге пользователя. Дополнительно можно указать несколько учетных данных и конечных точек, используя разделы ini в файле cloudstack.ini. Используйте аргумент api_region для выбора имени раздела, по умолчанию используется раздел cloudstack.
Этот модуль не поддерживает несколько записей A и будет правильно сообщать об ошибке, если вы попытаетесь это сделать.
Дополнительную информацию об Exoscale DNS можно найти на странице https://community.exoscale.ch/documentation/dns/.
Этот модуль поддерживает режим проверки и сравнения.

Примеры

- name: Create or update an A record
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.4

- name: Update an existing A record with a new IP
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.5

- name: Create another A record with same name
  local_action:
    module: exo_dns_record
    name: web-vm-1
    domain: example.com
    content: 1.2.3.6
    multiple: yes

- name: Create or update a CNAME record
  local_action:
    module: exo_dns_record
    name: www
    domain: example.com
    record_type: CNAME
    content: web-vm-1

- name: Create another MX record
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    prio: 10
    multiple: yes

- name: Delete one MX record out of multiple
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    multiple: yes
    state: absent

- name: Remove a single A record
  local_action:
    module: exo_dns_record
    name: www
    domain: example.com
    state: absent

Значения возврата

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

Ключ		Возвращаемое значение	Описание
exo_dns_record сложный		успех	Результаты API-запроса для записи
	content строка	успех	значение записи Пример: 1.2.3.4
	created_at строка	успех	Время создания записи Пример: 2016-08-12T15:24:23.989Z
	domain строка	успех	Имя домена Пример: example.com
	domain_id целое число	успех	ID домена Пример: 254324
	id целое число	успех	ID записи Пример: 254324
	name строка	успех	имя записи Пример: www
	parent_id целое число	успех	ID родителя
	prio целое число	успех	Приоритет записи Пример: 10
	record_type строка	успех	Приоритет записи Пример: A
	system_record булево	успех	Является ли запись системной
	ttl целое число	успех	Время жизни записи Пример: 3600
	updated_at строка	успех	Время обновления записи Пример: 2016-08-12T15:24:23.989Z

Статус

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

Авторы

René Moser (@resmo)

Подсказка

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

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