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

Примечание

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

Для его установки используйте: 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 ←	Дождаться завершения задачи. Например, задачи публикации.
wait_for_task_timeout integer		Значение по умолчанию: 30	Сколько минут ждать, прежде чем сгенерировать ошибку тайм-аута.

Примеры

- 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–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_time_module.html