fortinet.fortimanager.fmgr_devprof_system_dns – Настройка DNS.

Примечание

Этот плагин входит в коллекцию fortinet.fortimanager (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install fortinet.fortimanager.

Чтобы использовать его в плейбуке, укажите: fortinet.fortimanager.fmgr_devprof_system_dns.

Добавлено в версии 2.10: модуля fortinet.fortimanager

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательный			параметр (adom) в запрошенном URL
bypass_validation логическое		Варианты: нет ← да	устанавливается в True только тогда, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без проверки параметров
devprof строка / обязательный			параметр (devprof) в запрошенном URL
devprof_system_dns словарь			параметры верхнего уровня
	cache-notfound-responses строка	Варианты: выкл вкл	Включает/отключает ответ от DNS-сервера, когда запись отсутствует в кэше.
	dns-cache-limit целое число		Максимальное количество записей в кэше DNS.
	dns-cache-ttl целое число		Срок хранения информации в кэше DNS в секундах.
	domain строка		Суффикс доменного имени для IP-адресов DNS-сервера.
	ip6-primary строка		IP-адрес первичного DNS-сервера (IPv6).
	ip6-secondary строка		IP-адрес вторичного DNS-сервера (IPv6).
	primary строка		IP-адрес первичного DNS-сервера.
	secondary строка		IP-адрес вторичного DNS-сервера.
rc_failed список / элементы=строка			список кодов rc, при которых условия будут нарушены
rc_succeeded список / элементы=строка			список кодов rc, при которых условия будут выполнены
state строка / обязательный		Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom строка			домен для блокировки FortiManager в режиме рабочего пространства, значение может быть глобальным и другими, включая root
workspace_locking_timeout целое число		По умолчанию: 300	максимальное время ожидания в секундах, пока другой пользователь не разблокирует рабочее пространство

Примечания

Примечание

Поддержка режима блокировки рабочего пространства в этом модуле FortiManager, параметры верхнего уровня workspace_locking_adom и workspace_locking_timeout помогают в работе.
Для создания или обновления объекта используйте директиву state present.
Для удаления объекта используйте директиву state absent.
Обычно выполнение одного модуля может завершиться сбоем, если возвращен ненулевой код rc. Также можно переопределить условия сбоя или успеха параметрами rc_failed и rc_succeeded

Примеры

- hosts: fortimanager-inventory
  collections:
    - fortinet.fortimanager
  connection: httpapi
  vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
  tasks:
   - name: Configure DNS.
     fmgr_devprof_system_dns:
        bypass_validation: False
        workspace_locking_adom: <value in [global, custom adom including root]>
        workspace_locking_timeout: 300
        rc_succeeded: [0, -2, -3, ...]
        rc_failed: [-2, -3, ...]
        adom: <your own value>
        devprof: <your own value>
        devprof_system_dns:
           cache-notfound-responses: <value in [disable, enable]>
           dns-cache-limit: <value of integer>
           dns-cache-ttl: <value of integer>
           domain: <value of string>
           ip6-primary: <value of string>
           ip6-secondary: <value of string>
           primary: <value of string>
           secondary: <value of string>

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

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

Ключ	Возвращаемое значение	Описание
request_url строка	всегда	полный запрашиваемый URL Пример: /sys/login/user
response_code целое число	всегда	статус запроса API
response_message строка	всегда	описательное сообщение ответа API Пример: OK.

Авторы

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
Frank Shen (@fshen01)
Hongbin Lu (@fgtdev-hblu)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/fortinet/fortimanager/fmgr_devprof_system_dns_module.html