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

Примечание

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

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

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

Добавлена в версии 2.9: модуля check_point.mgmt

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

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_publish_session boolean		Варианты: no yes	Опубликовать текущую сессию, если изменения были внесены после завершения задачи.
color string		Варианты: aquamarine black blue crete blue burlywood cyan dark green khaki orchid dark orange dark sea green pink turquoise dark blue firebrick brown forest green gold dark gold gray dark gray light green lemon chiffon coral sea green sky blue magenta purple slate blue violet red navy blue olive orange red sienna yellow	Цвет объекта. Должен быть одним из существующих цветов.
comments string			Строка комментариев.
details_level string		Варианты: uid standard full	Уровень детализации некоторых полей в ответе может варьироваться от показа только значения UID объекта до полностью подробного представления объекта.
end dictionary			Конечное время. Обратите внимание, что каждое шлюзовое устройство может интерпретировать это время по-своему в соответствии со своей часовой зоной.
	date string		Дата в формате дд-MMM-гггг.
	iso_8601 string		Дата и время в международном формате ISO 8601. Информация о часовой зоне игнорируется.
	posix integer		Количество миллисекунд, прошедших с 00:00:00 1 января 1970 года.
	time string		Время в формате ЧЧ,мм.
end_never boolean		Варианты: no yes	Конец никогда.
groups list / elements=string			Коллекция идентификаторов групп.
hours_ranges list / elements=string			Повтор по часам. Обратите внимание, что каждое шлюзовое устройство может интерпретировать это время по-своему в соответствии со своей часовой зоной.
	enabled boolean	Варианты: no yes	Включен ли диапазон часов.
	from string		Время в формате ЧЧ,ММ.
	index integer		Индекс диапазона часов.
	to string		Время в формате ЧЧ,ММ.
ignore_errors boolean		Варианты: no yes	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, предупреждения также будут проигнорированы.
ignore_warnings boolean		Варианты: no yes	Применять изменения, игнорируя предупреждения.
name string / required			Имя объекта.
recurrence dictionary			Повтор по дням.
	days list / elements=string		Действительно по определенным дням. Несколько вариантов, поддерживается диапазон дней в месяцах. Пример: ["1", "3", "9-20"].
	month string		Действительно в определенном месяце. Пример: "1", "2", "12", "Any".
	pattern string		Действительно по основанию "Daily", "Weekly", "Monthly".
	weekdays list / elements=string		Действительно по дням недели. Пример: "Sun", "Mon"..."Sat".
start dictionary			Начальное время. Обратите внимание, что каждое шлюзовое устройство может интерпретировать это время по-своему в соответствии со своей часовой зоной.
	date string		Дата в формате дд-MMM-гггг.
	iso_8601 string		Дата и время в международном формате ISO 8601. Информация о часовой зоне игнорируется.
	posix integer		Количество миллисекунд, прошедших с 00:00:00 1 января 1970 года.
	time string		Время в формате ЧЧ,мм.
start_now boolean		Варианты: no yes	Начать немедленно.
state string		Варианты: present ← absent	Состояние правила доступа (present или absent). По умолчанию present.
tags list / elements=string			Коллекция идентификаторов тегов.
version string			Версия checkpoint. Если не указана, берется последняя версия.
wait_for_task boolean		Варианты: no yes ←	Дождаться завершения задачи. Например, задачи публикации.

Примеры

- name: add-time
  cp_mgmt_time:
    end:
      date: 24-Nov-2014
      time: '21:22'
    end_never: 'false'
    hours_ranges:
    - enabled: true
      from: 00:00
      index: 1
      to: 00:00
    - enabled: false
      from: 00:00
      index: 2
      to: 00:00
    name: timeObject1
    recurrence:
      days:
      - '1'
      month: Any
      pattern: Daily
      weekdays:
      - Sun
      - Mon
    start_now: 'true'
    state: present

- name: set-time
  cp_mgmt_time:
    hours_ranges:
    - from: 00:22
      to: 00:33
    name: timeObject1
    recurrence:
      month: Any
      pattern: Weekly
      weekdays:
      - Fri
    state: present

- name: delete-time
  cp_mgmt_time:
    name: timeObject1
    state: absent

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

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

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

Авторы

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.10/collections/check_point/mgmt/cp_mgmt_time_module.html