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

Примечание

Этот плагин входит в коллекцию ngine_io.exoscale (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install ngine_io.exoscale.

Чтобы использовать его в плейбуке, укажите: ngine_io.exoscale.exo_dns_record.

Новое в версии 0.1.0: плагина ngine_io.exoscale

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

Обзор

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

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API Exoscale DNS API. Переменная среды `CLOUDSTACK_KEY` используется в качестве значения по умолчанию, если определена.
api_region строка	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. Переменная среды `CLOUDSTACK_REGION` используется в качестве значения по умолчанию, если определена.
api_secret строка		Секретный ключ API Exoscale DNS API. Переменная среды `CLOUDSTACK_SECRET` используется в качестве значения по умолчанию, если определена.
api_timeout целое число	Значение по умолчанию: 10	Таймаут HTTP запросов к Exoscale DNS API. Переменная среды `CLOUDSTACK_TIMEOUT` используется в качестве значения по умолчанию, если определена.
content строка		Содержимое записи. Требуется, если `state=present` или `multiple=yes`. псевдонимы: значение, адрес
domain строка / обязательный		Домен, к которому относится запись.
multiple булево	Варианты: нет ← да	Указывает, содержит ли запись несколько записей с одинаковым именем и типом записи. Доступно только для некоторых типов записей, например `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, type
state строка	Варианты: present ← absent	Состояние записи.
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
  ngine_io.exoscale.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
  ngine_io.exoscale.exo_dns_record:
    name: web-vm-1
    domain: example.com
    content: 1.2.3.5

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

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

- name: Create another MX record
  ngine_io.exoscale.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
  ngine_io.exoscale.exo_dns_record:
    domain: example.com
    record_type: MX
    content: mx1.example.com
    multiple: yes
    state: absent

- name: Remove a single A record
  ngine_io.exoscale.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

Авторы

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.10/collections/ngine_io/exoscale/exo_dns_record_module.html