Spec-Zone.ru › Ansible 2.10

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

Примечание

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

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

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

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

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

Обзор

  • Этот модуль может настроить устройство FortiManager, позволяя пользователю [ получить, установить, обновить ] следующие API:
  • /pm/config/adom/{adom}/devprof/{devprof}/system/dns
  • Примеры включают все параметры и значения, которые необходимо скорректировать перед использованием из источников данных.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
loose_validation
boolean
    Варианты:
  • no
  • yes
Ослабленная валидация параметров
method
string / обязательный
    Варианты:
  • get
  • set
  • update
Метод запроса
params
list / элементы=string
Параметры для каждого метода
Полный список параметров см. в https://ansible-galaxy-fortimanager-docs.readthedocs.io/en/latest
url_params
словарь
Параметры для URL каждого запроса API
Также см. полный список параметров URL в https://ansible-galaxy-fortimanager-docs.readthedocs.io/en/latest
workspace_locking_adom
строка
Имя adom для блокировки в случае работы FortiManager в режиме рабочего пространства
может быть глобальным или любым другим настраиваемым именем adom
workspace_locking_timeout
целое число
Значение по умолчанию:
300
Максимальное время ожидания в секундах, пока другой пользователь не разблокирует рабочее пространство

Примечания

Примечание

  • Существует только три параметра верхнего уровня, где «method» всегда обязателен, а остальные два «params» и «url_params» могут быть необязательными
  • Из-за сложности схемы API fortimanager валидация выполняется вне процедуры валидации параметров Ansible.
  • Синтаксис OPTIONS не соответствует стандартной спецификации аргументов Ansible, но в соответствии со структурой схемы API fortimanager нам нужна тривиальная трансформация при заполнении книги задач Ansible.

Примеры

- 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: REQUESTING /PM/CONFIG/DEVPROF/{DEVPROF}/SYSTEM/DNS
     fmgr_devprof_system_dns:
        loose_validation: False
        workspace_locking_adom: <value in [global, custom adom]>
        workspace_locking_timeout: 300
        method: <value in [get]>
        url_params:
           adom: <value in [none, global, custom dom]>
           devprof: <value of string>
        params:
           -
              option: <value in [object member, chksum, datasrc]>

   - name: REQUESTING /PM/CONFIG/DEVPROF/{DEVPROF}/SYSTEM/DNS
     fmgr_devprof_system_dns:
        loose_validation: False
        workspace_locking_adom: <value in [global, custom adom]>
        workspace_locking_timeout: 300
        method: <value in [set, update]>
        url_params:
           adom: <value in [none, global, custom dom]>
           devprof: <value of string>
        params:
           -
              data:
                 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>

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

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

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

status
словарь
всегда
Статус запроса к API

url
строка
всегда
Полный URL запроса

Пример:
/sys/login/user


Авторы

  • Frank Shen (@fshen01)
  • Link Zheng (@zhengl)

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

Spec-Zone.ru

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