check_point.mgmt.cp_mgmt_network модуль — Управляет сетевыми объектами Check Point через API веб-служб
Примечание
Этот модуль входит в коллекцию check_point.mgmt (версия 5.2.3).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install check_point.mgmt.
Чтобы использовать её в плейбуке, укажите: check_point.mgmt.cp_mgmt_network.
Впервые в check_point.mgmt 1.0.0
Обзор
- Управляет сетевыми объектами на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
Параметры
Параметр | Комментарии |
|---|---|
auto_publish_session boolean | Опубликовать текущий сеанс, если изменения были выполнены после завершения задачи. Варианты:
|
broadcast string | Разрешить включение широковещательного адреса. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Строка комментариев. |
details_level string | Уровень детализации для некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта. Варианты:
|
groups list / elements=string | Набор идентификаторов групп. |
ignore_errors boolean | Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
mask_length integer | Длина маски сети IPv4 или IPv6. Если требуются обе маски, используйте поля mask-length4 и mask-length6 явно. Вместо длины маски IPv4 можно указать саму маску IPv4 в поле subnet-mask. |
mask_length4 integer | Длина маски сети IPv4. |
mask_length6 integer | Длина маски сети IPv6. |
name string / required | Имя объекта. |
nat_settings dictionary | Настройки NAT. |
|
auto_rule boolean |
Добавлять ли правила автоматического преобразования адресов. Варианты:
|
|
hide_behind string |
Метод скрытия. Этот параметр не обязателен, если параметр «method» равен «static». Варианты:
|
|
install_on string |
Какой шлюз должен применять преобразование NAT. |
|
ip_address string |
IPv4 или IPv6 адрес. Если требуются оба адреса, используйте поля ipv4-address и ipv6-address явно. Этот параметр не обязателен, если параметр «method» равен «hide», а параметр «hide-behind» равен «gateway». |
|
ipv4_address string |
IPv4 адрес. |
|
ipv6_address string |
IPv6 адрес. |
|
method string |
Метод трансляции NAT. Варианты:
|
state string | Состояние правила доступа (присутствует или отсутствует). Варианты:
|
subnet string | Адрес сети IPv4 или IPv6. Если требуются оба адреса, используйте поля subnet4 и subnet6 явно. |
subnet4 string | Адрес сети IPv4. |
subnet6 string | Адрес сети IPv6. |
subnet_mask string | Маска сети IPv4. |
tags list / elements=string | Коллекция идентификаторов тегов. |
version string | Версия Check Point. Если не указана, используется последняя версия. |
wait_for_task boolean | Дождаться завершения задачи. Например, задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до сброса ошибки таймаута. По умолчанию: |
Примеры
- name: add-network
cp_mgmt_network:
name: New Network 1
state: present
subnet: 192.0.2.0
subnet_mask: 255.255.255.0
- name: set-network
cp_mgmt_network:
color: green
mask_length: 16
name: New Network 1
new_name: New Network 2
state: present
subnet: 192.0.0.0
- name: delete-network
cp_mgmt_network:
name: New Network 2
state: absent
Значения возврата
Общие значения возврата описаны в здесь, следующие поля уникальны для данного модуля:
Ключ | Описание |
|---|---|
cp_mgmt_network словарь | Объект Check Point, созданный или обновленный. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на сборку
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/check_point/mgmt/cp_mgmt_network_module.html