Модуль check_point.mgmt.cp_mgmt_interface_facts — получение сведений об объектах интерфейсов Checkpoint через API веб-служб

Примечание

Этот модуль входит в коллекцию check_point.mgmt (версия 6.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать коллекцию в плейбуке, укажите: check_point.mgmt.cp_mgmt_interface_facts.

Новая возможность в check_point.mgmt 6.2.0

Краткое описание
Параметры
Примеры

Краткое описание

Получение сведений об объектах интерфейсов на устройствах Checkpoint.
Все операции выполняются через API веб-служб.
Модуль поддерживает обе операции: получение сведений об одном объекте и о нескольких объектах. Чтобы получить сведения об определённом объекте, используйте параметр ‘name’.
Доступно начиная с версии системы управления R82.

Параметры

Параметр	Комментарии
details_level string	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта. Варианты: `"uid"` `"standard"` `"full"`
domains_to_process list / elements=string	Указывает домены, в которых будут выполняться команды. Параметр нельзя использовать с уровнем детализации full. Команду необходимо запускать только из системного домена и с параметром ignore-warnings true. Допустимые значения: CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER.
filter string	Фильтрация интерфейсов по имени или IP-адресу.
gateway_uid string	UID объекта шлюза или кластера, которому принадлежат интерфейсы.
limit integer	Максимальное количество возвращаемых результатов. Этот параметр имеет значение только при получении нескольких объектов.
name string	Имя сетевого интерфейса.
offset integer	Количество результатов, которые следует пропустить в начале. Этот параметр имеет значение только при получении нескольких объектов.
order list / elements=dictionary	Сортирует результаты по критериям поиска. По умолчанию результаты автоматически сортируются по имени в порядке возрастания. Этот параметр имеет значение только при получении нескольких объектов.
ASC string	Сортирует результаты по указанному полю в порядке возрастания. Варианты: `"name"`
DESC string	Сортирует результаты по указанному полю в порядке убывания. Варианты: `"name"`
show_membership boolean	Указывает, следует ли вычислять и отображать поле “groups” для каждого объекта в ответе. Варианты: `false` `true`
version string	Версия Checkpoint. Если она не указана, используется последняя версия.

Примеры

- name: show-interface
  cp_mgmt_interface_facts:
    name: eth0
    gateway_uid: ff918e85-98c4-4b17-bcac-417aab863d87

- name: show-interfaces
  cp_mgmt_interface_facts:
    details_level: full
    gateway_uid: ff918e85-98c4-4b17-bcac-417aab863d87
    limit: 50
    offset: 0

Авторы

Eden Brillant (@chkp-edenbr)

Ссылки на коллекцию

© 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/check_point/mgmt/cp_mgmt_interface_facts_module.html