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

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

Описание

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

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Ключ API для Exoscale DNS API. Начиная с версии 2.4, переменная среды `CLOUDSTACK_KEY` используется в качестве значения по умолчанию, если она определена.
api_region строка	По умолчанию: "cloudstack"	Имя раздела в файле конфигурации `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 булево	Варианты: нет ← да	Указывает, есть ли несколько записей с одинаковым именем и типом записи. Допускается только для некоторых типов записей, например, `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
  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
  exo_dns_record:
    name: web-vm-1
    domain: example.com
    content: 1.2.3.5

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

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

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

- name: Remove a single A record
  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 целое число	успех	Идентификатор домена Пример: 254324
	id целое число	успех	Идентификатор записи Пример: 254324
	name строка	успех	имя записи Пример: www
	parent_id целое число	успех	Идентификатор родителя
	prio целое число	успех	Приоритет записи Пример: 10
	record_type строка	успех	Тип записи Пример: A
	system_record булево	успех	Является ли запись системной
	ttl целое число	успех	Время жизни записи Пример: 3600
	updated_at строка	успех	Дата обновления записи Пример: 2016-08-12T15:24:23.989Z

Состояние

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

Авторы

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