fortinet.fortimanager.fmgr_firewall_internetservicecustom_entry – Записи, добавленные в базу данных «Услуги Интернета» и пользовательскую базу данных.

Примечание

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

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

Для использования в плейбуке укажите: fortinet.fortimanager.fmgr_firewall_internetservicecustom_entry.

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

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

Обзор

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

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
adom строка / обязательный				параметр (adom) в запрошенном URL
bypass_validation булево			Варианты: нет ← да	устанавливается в True только при расхождениях схемы модуля со структурой API FortiManager; модуль продолжает выполнение без проверки параметров
firewall_internetservicecustom_entry словарь				устанавливаемые параметры верхнего уровня
	dst строка			Адрес назначения или имя группы адресов.
	id целое число			Идентификатор записи (1-255).
	port-range список / элементы=строка			нет описания
		end-port целое число		Целое значение конечного порта TCP/UDP/SCTP назначения в диапазоне (1 до 65535).
		id целое число		Идентификатор диапазона портов пользовательской записи.
		start-port целое число		Целое значение начального порта TCP/UDP/SCTP назначения в диапазоне (1 до 65535).
	protocol целое число			Целое значение типа протокола, определенного IANA (0 - 255).
internet-service-custom строка / обязательный				параметр (internet-service-custom) в запрошенном URL
rc_failed список / элементы=строка				список кодов rc, по которым будут переопределены условия завершения с ошибкой
rc_succeeded список / элементы=строка				список кодов rc, по которым будут переопределены условия успешного завершения
state строка / обязательный			Варианты: present absent	директива для создания, обновления или удаления объекта
workspace_locking_adom строка				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: Entries added to the Internet Service database and custom database.
     fmgr_firewall_internetservicecustom_entry:
        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>
        internet-service-custom: <your own value>
        state: <value in [present, absent]>
        firewall_internetservicecustom_entry:
           dst: <value of string>
           id: <value of integer>
           port-range:
             -
                 end-port: <value of integer>
                 id: <value of integer>
                 start-port: <value of integer>
           protocol: <value of integer>

Значения возврата

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

Ключ	Возвращаемое значение	Описание
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_firewall_internetservicecustom_entry_module.html