fortinet.fortimanager.fmgr_system_geoipoverride – Настройка сопоставления географического местоположения для IP-адреса(ов) для переопределения сопоставлений из FortiGuard.

Примечание

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

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

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

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

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

Обзор

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

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно				параметр (adom) в запрошенном URL
bypass_validation логическое значение			Варианты: нет ← да	устанавливается в значение True только в том случае, когда схема модуля отличается от структуры API FortiManager, модуль продолжает выполнение без проверки параметров
rc_failed список / элементы=строка				список кодов rc, при которых условия будут игнорироваться
rc_succeeded список / элементы=строка				список кодов rc, при которых условия будут переопределяться
state строка / обязательно			Варианты: present absent	директива для создания, обновления или удаления объекта
system_geoipoverride словарь				установленные параметры верхнего уровня
	description строка			Описание.
	ip-range список / элементы=строка			нет описания
		end-ip строка		Конечный IP-адрес диапазона адресов (формат: xxx.xxx.xxx.xxx).
		id целое число		Идентификационный номер отдельной записи в таблице диапазонов IP.
		start-ip строка		Начальный IP-адрес диапазона адресов (формат: xxx.xxx.xxx.xxx).
	name строка			Имя местоположения.
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: Configure geographical location mapping for IP address(es) to override mappings from FortiGuard.
     fmgr_system_geoipoverride:
        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>
        state: <value in [present, absent]>
        system_geoipoverride:
           description: <value of string>
           ip-range:
             -
                 end-ip: <value of string>
                 id: <value of integer>
                 start-ip: <value of string>
           name: <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_geoipoverride_module.html