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` или `name=""` псевдонимы: значение, адрес
domain	да			Домен, к которому относится запись.
multiple	нет			Есть ли несколько записей с аналогичным `name`. Допускается только с `record_type=A`. `content` не будет обновлен, так как он используется в качестве ключа для поиска записи. псевдонимы: приоритет
name	нет			Имя записи.
prio	нет			Приоритет записи. псевдонимы: приоритет
record_type	нет	A	A ALIAS CNAME MX SPF URL TXT NS SRV NAPTR PTR AAAA SSHFP HINFO POOL	Тип записи. псевдонимы: rtype, тип
state	нет	present	present absent	Состояние записи.
ttl	нет	3600		TTL записи в секундах.
validate_certs	нет	True	да нет	Проверять SSL-сертификаты Exoscale DNS API.

Примеры

- 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 or update a MX record
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    prio: 10

- name: Delete a MX record
  local_action:
    module: exo_dns_record
    domain: example.com
    record_type: MX
    content: mx1.example.com
    state: absent

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

Возвращаемые значения

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

имя

описание

возвращается

тип

пример

exo_dns_record

Результаты записи API

успех

сложный

содержит:

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

Примечания

Примечание

Поскольку Exoscale DNS использует один и тот же ключ API и секрет для всех служб, мы повторно используем конфигурацию, используемую для Exoscale 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/.
Этот модуль поддерживает режим проверки и diff.

Статус

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

Для получения помощи в разработке модулей, если вас это заинтересует, прочитайте Справочная информация сообщества и участие в разработке, Тестирование Ansible и Разработка модулей.

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