fortinet.fortios.fortios_firewall_internet_service module – Отображение приложения Internet Service в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_firewall_internet_service.
Новое в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры брандмауэра и категорию internet_service. В примерах приведены все параметры и значения, которые перед использованием необходимо адаптировать к источникам данных. Проверено на FOS v6.0.0
Требования
На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.
- ansible>=2.16
Параметры
Параметр | Комментарии |
|---|---|
access_token строка | Аутентификация на основе токена. Создается в графическом интерфейсе Fortigate. |
enable_log логическое значение | Включить или отключить ведение журнала для задачи. Варианты:
|
firewall_internet_service словарь | Отображение приложения Internet Service. |
|
database строка |
Имя базы данных, к которой относится эта служба Internet Service. Варианты:
|
|
direction строка |
Способ использования этой службы в политике брандмауэра (источник, назначение или оба варианта). Варианты:
|
|
entry список / элементы=словарь |
Записи в базе данных Internet Service. |
|
id целое число / обязательный |
Идентификатор записи. см. <a href=’#notes’>Примечания</a>. |
|
ip_number целое число |
Общее количество IP-адресов. |
|
ip_range_number целое число |
Общее количество диапазонов IP-адресов. |
|
port целое число |
Целочисленное значение номера порта TCP/IP (0–65535). |
|
protocol целое число |
Целочисленное значение типа протокола согласно определению IANA (0–255). |
|
extra_ip_range_number целое число |
Дополнительное количество диапазонов IP-адресов. |
|
icon_id целое число |
Идентификатор значка Internet Service. |
|
id целое число / обязательный |
Идентификатор Internet Service. см. <a href=’#notes’>Примечания</a>. |
|
ip_number целое число |
Общее количество IP-адресов. |
|
ip_range_number целое число |
Количество диапазонов IP-адресов. |
|
name строка |
Имя Internet Service. |
|
obsolete целое число |
Указывает, можно ли использовать Internet Service. |
|
offset целое число |
Смещение идентификатора Internet Service. |
|
reputation целое число |
Уровень репутации Internet Service. |
|
singularity целое число |
Уровень уникальности Internet Service. |
|
sld_id целое число |
Домен второго уровня. |
member_path строка | Путь к атрибуту элемента, над которым выполняется операция. Если атрибутов несколько, они разделяются символом косой черты. Параметр с пометкой member_path можно использовать для выполнения операции с элементом. |
member_state строка | Добавить или удалить элемент по указанному пути к атрибуту. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
state строка / обязательный | Указывает, следует ли создать или удалить объект. Варианты:
|
vdom строка | Виртуальный домен из ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
Примечания
Примечание
- Настоятельно рекомендуем указывать собственное значение id вместо 0. Значение ‘0’ — это специальный заполнитель, позволяющий серверной части назначить объекту последний доступный номер, однако у него есть ограничения. Дополнительные сведения см. в разделе «Вопросы и ответы».
- Устаревший fortiosapi объявлен устаревшим; для запуска плейбуков рекомендуется использовать httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Show Internet Service application.
fortinet.fortios.fortios_firewall_internet_service:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
firewall_internet_service:
database: "isdb"
direction: "src"
entry:
-
id: "6"
ip_number: "32767"
ip_range_number: "2147483647"
port: "32767"
protocol: "127"
extra_ip_range_number: "0"
icon_id: "0"
id: "13"
ip_number: "0"
ip_range_number: "0"
name: "default_name_16"
obsolete: "0"
offset: "2147483647"
reputation: "2147483647"
singularity: "0"
sld_id: "2147483647"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build строка | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method строка | Последний метод, использованный для передачи содержимого на FortiGate Возвращается: всегда Пример: |
http_status строка | Последний результат, возвращенный FortiGate после последней выполненной операции Возвращается: всегда Пример: |
mkey строка | Главный ключ (id), использованный при последнем вызове FortiGate Возвращается: при успешном выполнении Пример: |
name строка | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path строка | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision строка | Внутренний номер редакции Возвращается: всегда Пример: |
serial строка | Серийный номер устройства Возвращается: всегда Пример: |
status строка | Результат операции Возвращается: всегда Пример: |
vdom строка | Используемый виртуальный домен Возвращается: всегда Пример: |
version строка | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_firewall_internet_service_module.html
