Spec-Zone.ru › Ansible 2.4

ipa_dnsrecord - Управление записями DNS FreeIPA

Новая версия 2.4.

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

Обзор

  • Добавление, изменение и удаление записей DNS IPA с помощью API IPA

Параметры

параметр обязательно по умолчанию значения комментарии
ipa_host
нет ipa.example.com
IP-адрес или имя хоста сервера IPA
ipa_pass
да
Пароль административного пользователя
ipa_port
нет 443
Порт сервера IPA
ipa_prot
нет https
  • http
  • https
Протокол, используемый сервером IPA
ipa_user
нет admin
Используемый административный аккаунт на сервере IPA
record_name
да
Имя записи DNS для управления.
алиасы: name
record_type
нет A
  • A
  • AAAA
  • PTR
Тип имени записи DNS
В настоящее время поддерживаются типы 'A', 'AAAA' и 'PTR'
record_value
да
Управление именем записи DNS с этим значением.
В случае типов записей 'A' или 'AAAA' это будет IP-адрес.
В случае типа записи 'PTR' это будет имя хоста.
state
нет present
  • present
  • absent
Состояние, которое нужно обеспечить
validate_certs
нет True
Это применимо только если ipa_prot равно https.
Если установлено в no, сертификаты SSL не будут проверены.
Это следует установить в no только для сайтов, управляемых самостоятельно, с использованием самозаверяющих сертификатов.
zone_name
да
Имя зоны DNS, для которой необходимо управлять записью DNS.

Примеры

# Ensure dns record is present
- ipa_dnsrecord:
    ipa_host: spider.example.com
    ipa_pass: Passw0rd!
    state: present
    zone_name: example.com
    record_name: vm-001
    record_type: 'AAAA'
    record_value: '::1'

# Ensure a PTR record is present
- ipa_dnsrecord:
    ipa_host: spider.example.com
    ipa_pass: Passw0rd!
    state: present
    zone_name: 2.168.192.in-addr.arpa
    record_name: 5
    record_type: 'PTR'
    record_value: 'internal.ipa.example.com'

# Ensure that dns record is removed
- ipa_dnsrecord:
    name: host01
    zone_name: example.com
    record_type: 'AAAA'
    record_value: '::1'
    ipa_host: ipa.example.com
    ipa_user: admin
    ipa_pass: topsecret
    state: absent

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

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

название описание возвращаемое значение тип образец
dnsrecord
Запись DNS, возвращенная API IPA.
всегда словарь

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, прочтите Информация о сообществе и вклад, Тестирование 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/ipa_dnsrecord_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API