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

Новое в версии 2.9.

Описание
Параметры
Примеры
Значения возврата
Статус

Описание

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_publish_session boolean		Варианты: no yes	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
color string		Варианты: аквамарин чёрный синий голубой крет коричневато-золотистый голубой циан тёмно-зелёный хаки фиолетово-розовый тёмно-оранжевый тёмно-морской зелёный розовый бирюзовый тёмно-синий огненно-красный кирпич коричневый тёмно-зелёный лес золотой тёмно-золотой серый тёмно-серый светло-зелёный лимонно-сиреневый коралл морской зелёный небесно-голубой пурпурный фиолетовый голубой сланца фиолетово-красный сине-чёрный оливковый оранжевый красный сиена жёлтый	Цвет объекта. Должен быть одним из существующих цветов.
comments string			Строка комментариев.
details_level string		Варианты: uid стандартный полный	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения 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			Коллекция идентификаторов групп.
hours_ranges list			Повторение по часам. Обратите внимание, что каждый шлюз может интерпретировать это время по-разному в зависимости от своей часовой зоны.
	enabled boolean	Варианты: no yes	Включено ли повторение по часам.
	from string		Время в формате ЧЧ:ММ.
	index integer		Индекс диапазона часов.
	to string		Время в формате ЧЧ:ММ.
ignore_errors boolean		Варианты: no yes	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, предупреждения также будут проигнорированы.
ignore_warnings boolean		Варианты: no yes	Применять изменения, игнорируя предупреждения.
name string / обязательно			Имя объекта.
recurrence dictionary			Повторение по дням.
	days list		Действительно в определённые дни. Несколько вариантов, поддерживает диапазон дней в месяцах. Пример, ["1","3","9-20"].
	month string		Действительно в определённый месяц. Пример, "1", "2","12","Любой".
	pattern string		Действительно для "Ежедневно", "Еженедельно", "Ежемесячно".
	weekdays list		Действительно в определённые дни недели. Пример, "Вс", "Пн"..."Сб".
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		Варианты: текущий ← отсутствует	Состояние правила доступа (текущий или отсутствует). По умолчанию — текущий.
tags list			Коллекция идентификаторов тегов.
version string			Версия Check Point. Если не указана, используется последняя версия.
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 словарь	всегда, за исключением удаления объекта.	Созданный или обновлённый объект контрольной точки.

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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