check_point.mgmt.cp_mgmt_service_sctp – Управляет объектами service-sctp на Check Point через API веб-служб

Примечание

Этот плагин является частью коллекции check_point.mgmt (версия 2.0.0).

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

Для использования в книге задач укажите: check_point.mgmt.cp_mgmt_service_sctp.

Новое в версии 2.9: модуля check_point.mgmt

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

Обзор

Управляет объектами service-sctp на устройствах Check Point, включая создание, обновление и удаление объектов.
Все операции выполняются через API веб-служб.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
aggressive_aging словарь			Устанавливает короткие (агрессивные) таймауты для неактивных подключений.
	default_timeout целое число		Таймаут по умолчанию для агрессивного старения в секундах.
	enable булево	Варианты: no yes	Н/Д
	timeout целое число		Таймаут агрессивного старения в секундах.
	use_default_timeout булево	Варианты: no yes	Н/Д
auto_publish_session булево		Варианты: no yes	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
color строка		Варианты: (список цветов, как в оригинале)	Цвет объекта. Должен быть одним из существующих цветов.
comments строка			Строка комментариев.
details_level строка		Варианты: uid standard full	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного детального представления объекта.
groups список / элементы=строка			Коллекция идентификаторов групп.
ignore_errors булево		Варианты: no yes	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings опущен, предупреждения также будут проигнорированы.
ignore_warnings булево		Варианты: no yes	Применять изменения, игнорируя предупреждения.
keep_connections_open_after_policy_installation булево		Варианты: no yes	Сохранять подключения открытыми после установки политики, даже если они не разрешены в новой политике. Это переопределяет настройки на странице Поддержание подключений. Если вы измените этот параметр, изменения не будут влиять на открытые подключения, а только на будущие подключения.
match_for_any булево		Варианты: no yes	Указывает, используется ли эта служба, когда в правиле установлено «Любой» в качестве службы, и существует несколько объектов службы с одинаковым исходным портом и протоколом.
name строка / обязательно			Имя объекта.
port строка			Номер порта. Чтобы указать диапазон портов, добавьте дефис между минимальным и максимальным номерами портов, например, 44-45.
session_timeout целое число			Время (в секундах) до истечения срока действия сессии.
source_port строка			Номер исходного порта. Чтобы указать диапазон портов, добавьте дефис между минимальным и максимальным номерами портов, например, 44-45.
state строка		Варианты: present ← absent	Состояние правила доступа (present или absent). По умолчанию present.
sync_connections_on_cluster булево		Варианты: no yes	Включает синхронизированное состояние высокодоступности или балансировки нагрузки в кластере ClusterXL или OPSEC-сертифицированном кластере.
tags список / элементы=строка			Коллекция идентификаторов тегов.
use_default_session_timeout булево		Варианты: no yes	Использовать значение таймаута сессии по умолчанию.
version строка			Версия checkpoint. Если не указана, используется последняя версия.
wait_for_task булево		Варианты: no yes ←	Ожидать завершения задачи. Например, задачи публикации.
wait_for_task_timeout целое число		По умолчанию: 30	Сколько минут ожидать до вывода ошибки таймаута.

Примеры

- name: add-service-sctp
  cp_mgmt_service_sctp:
    aggressive_aging:
      enable: true
      timeout: 360
      use_default_timeout: false
    keep_connections_open_after_policy_installation: false
    match_for_any: true
    name: New_SCTP_Service_1
    port: 5669
    session_timeout: 0
    state: present
    sync_connections_on_cluster: true

- name: set-service-sctp
  cp_mgmt_service_sctp:
    aggressive_aging:
      default_timeout: 3600
    color: green
    name: New_SCTP_Service_1
    port: 5656
    state: present

- name: delete-service-sctp
  cp_mgmt_service_sctp:
    name: New_SCTP_Service_2
    state: absent

Возвращаемые значения

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

Ключ	Возвращаемое значение	Описание
cp_mgmt_service_sctp словарь	всегда, кроме случая удаления объекта.	Созданный или обновленный объект checkpoint.

Авторы

Or Soffer (@chkp-orso)

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