fortinet.fortimanager.fmgr_system_dhcp_server_reservedaddress – Параметры DHCP-сервера для назначения IP-настроек конкретным MAC-адресам.

Примечание

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

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

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

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

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
adom строка / обязательно			параметр (adom) в запрошенном URL
bypass_validation булево		Варианты: нет ← да	Устанавливается в True только в случае расхождений между схемой модуля и структурой API FortiManager. Модуль продолжает выполнение без проверки параметров.
rc_failed список / элементы=строка			список кодов rc, при которых условие неудачи будет переопределено.
rc_succeeded список / элементы=строка			список кодов rc, при которых условие успеха будет переопределено.
server строка / обязательно			параметр (server) в запрошенном URL
state строка / обязательно		Варианты: present absent	Направление для создания, обновления или удаления объекта.
system_dhcp_server_reservedaddress словарь			Установленные параметры верхнего уровня.
	action строка	Варианты: назначение блокирование зарезервированный	Параметры для DHCP-сервера по конфигурации клиента с зарезервированным MAC-адресом.
	description строка		Описание.
	id целое число		Идентификатор.
	ip строка		IP-адрес, который будет зарезервирован для MAC-адреса.
	mac строка		MAC-адрес клиента, которому будет назначен зарезервированный IP-адрес.
workspace_locking_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: Options for the DHCP server to assign IP settings to specific MAC addresses.
     fmgr_system_dhcp_server_reservedaddress:
        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>
        server: <your own value>
        state: <value in [present, absent]>
        system_dhcp_server_reservedaddress:
           action: <value in [assign, block, reserved]>
           description: <value of string>
           id: <value of integer>
           ip: <value of string>
           mac: <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_dhcp_server_reservedaddress_module.html