Модуль ngine_io.exoscale.exo_dns_record — Управление записями DNS в Exoscale DNS.

Примечание

Этот модуль входит в коллекцию ngine_io.exoscale (версия 1.1.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install ngine_io.exoscale. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: ngine_io.exoscale.exo_dns_record.

Добавлен в ngine_io.exoscale 0.1.0

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

Описание

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

Требования

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

python >= 2.6

Параметры

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

Примечания

Примечание

Поскольку 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 логическое	Является ли запись системной Возвращено: успешно Пример: `false`
ttl целое число	Время жизни записи Возвращено: успешно Пример: `3600`
updated_at строка	Время обновления записи Возвращено: успешно Пример: `"2016-08-12T15:24:23.989Z"`

Авторы

René Moser (@resmo)

Ссылки на коллекции

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