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

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

Описание
- Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Требования

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

python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key		Ключ API для API Exoscale DNS. С версии 2.4 в качестве значения по умолчанию используется переменная среды `CLOUDSTACK_KEY`, если она определена.
api_region	Значение по умолчанию: "cloudstack"	Имя раздела ini в файле `cloustack.ini`. С версии 2.4 в качестве значения по умолчанию используется переменная среды `CLOUDSTACK_REGION`, если она определена.
api_secret		Секретный ключ API Exoscale DNS. С версии 2.4 в качестве значения по умолчанию используется переменная среды `CLOUDSTACK_SECRET`, если она определена.
api_timeout	Значение по умолчанию: 10	Таймаут HTTP-запросов к API Exoscale DNS. С версии 2.4 в качестве значения по умолчанию используется переменная среды `CLOUDSTACK_TIMEOUT`, если она определена.
content		Содержание записи. Требуется, если `state=present` или `multiple=yes`. псевдонимы: значение, адрес
domain обязательно		Домен, к которому относится запись.
multiple bool	Варианты: no ← yes	Является ли запись одной из нескольких записей с аналогичным `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, type
state	Варианты: present ← absent	Состояние записи.
ttl	Значение по умолчанию: 3600	TTL записи в секундах.
validate_certs bool	Варианты: no yes ←	Проверять SSL-сертификаты API Exoscale DNS.

Примечания

Примечание

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

Статус

Этот модуль помечен как превью, что означает, что интерфейс не гарантируется как обратная совместимость.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом 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.6/modules/exo_dns_record_module.html