cp_mgmt_host – Управляет объектами хостов на Check Point через веб-сервисы API
Новая версия с 2.9.
Описание
- Управляет объектами хостов на устройствах Check Point, включая создание, обновление и удаление объектов.
- Все операции выполняются через веб-сервисы API.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | ||
|---|---|---|---|---|
| auto_publish_session boolean |
| Опубликовать текущую сессию, если после завершения задачи были внесены изменения. | ||
| color string |
| Цвет объекта. Должен быть одним из существующих цветов. | ||
| comments string | Строка комментариев. | |||
| details_level string |
| Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного детализированного представления объекта. | ||
| groups list | Коллекция идентификаторов групп. | |||
| host_servers dictionary | Настройка серверов. | |||
| dns_server boolean |
| Получает True, если этот сервер является DNS-сервером. | ||
| mail_server boolean |
| Получает True, если этот сервер является почтовым сервером. | ||
| web_server boolean |
| Получает True, если этот сервер является веб-сервером. | ||
| web_server_config dictionary | Настройка веб-сервера. | |||
| additional_ports list | Дополнительные порты сервера. | |||
| application_engines list | Прикладные движки этого веб-сервера. | |||
| listen_standard_port boolean |
| Слушает ли сервер стандартный порт. | ||
| operating_system string |
| Операционная система. | ||
| protected_by string | Объект сети, который защищает этот сервер, идентифицированный по имени или UID. | |||
| ignore_errors boolean |
| Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, то предупреждения также будут проигнорированы. | ||
| ignore_warnings boolean |
| Применить изменения, игнорируя предупреждения. | ||
| interfaces list | Интерфейсы хоста. | |||
| color string |
| Цвет объекта. Должен быть одним из существующих цветов. | ||
| comments string | Строка комментариев. | |||
| details_level string |
| Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного детализированного представления объекта. | ||
| 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 | Имя интерфейса. | |||
| subnet string | Адрес сети IPv4 или IPv6. Если оба адреса необходимы, используйте поля subnet4 и subnet6 явно. | |||
| subnet4 string | Адрес сети IPv4. | |||
| subnet6 string | Адрес сети IPv6. | |||
| subnet_mask string | Маска сети IPv4. | |||
| ip_address string | Адрес IPv4 или IPv6. Если оба адреса необходимы, используйте поля ipv4-address и ipv6-address явно. | |||
| ipv4_address string | Адрес IPv4. | |||
| ipv6_address string | Адрес IPv6. | |||
| name string / обязательно | Имя объекта. | |||
| 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 |
| Состояние правила доступа (present или absent). По умолчанию present. | ||
| tags list | Коллекция идентификаторов тегов. | |||
| version string | Версия контрольной точки. Если не указана, используется последняя версия. | |||
| wait_for_task boolean |
| Дождаться завершения задачи. Например, задачи публикации. | ||
Примеры
- name: add-host
cp_mgmt_host:
ip_address: 192.0.2.1
name: New Host 1
state: present
- name: set-host
cp_mgmt_host:
color: green
ipv4_address: 192.0.2.2
name: New Host 1
state: present
- name: delete-host
cp_mgmt_host:
name: New Host 1
state: absent
Значения возврата
Общие значения возврата документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| cp_mgmt_host dictionary | всегда, кроме случая удаления объекта. | Созданный или обновленный объект контрольной точки. |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Or Soffer (@chkp-orso)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/cp_mgmt_host_module.html
