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

Примечание

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

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

Для использования в книге задач укажите: fortinet.fortimanager.fmgr_system_dns.

Новое в версии 2.10: модуля fortinet.fortimanager

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
bypass_validation boolean		Варианты: нет ← да	устанавливается в значение True только при расхождении схемы модуля со структурой API FortiManager, модуль продолжает выполнение без проверки параметров
rc_failed список / элементы=строка			список кодов rc, при которых выполнение будет прервано
rc_succeeded список / элементы=строка			список кодов rc, при которых выполнение будет завершено успешно
state строка / обязательный		Варианты: present absent	указание на создание, обновление или удаление объекта
system_dns словарь			параметры верхнего уровня
	ip6-primary строка	Значение по умолчанию: "::"	IP IPv6 первичного DNS.
	ip6-secondary строка	Значение по умолчанию: "::"	IP IPv6 вторичного DNS.
	primary строка	Значение по умолчанию: "0.0.0.0"	IP первичного DNS.
	secondary строка	Значение по умолчанию: "0.0.0.0"	IP вторичного DNS.
workspace_locking_adom строка			адрес adom для блокировки при работе FortiManager в режиме рабочей области. Значение может быть глобальным и другими, включая корневой
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: DNS configuration.
     fmgr_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, ...]
        system_dns:
           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_system_dns_module.html