Модуль check_point.mgmt.cp_mgmt_securemote_dns_server — управление объектами securemote-dns-server на Checkpoint через API веб-служб
Примечание
Этот модуль входит в коллекцию check_point.mgmt (версия 6.9.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install check_point.mgmt.
Чтобы использовать коллекцию в плейбуке, укажите: check_point.mgmt.cp_mgmt_securemote_dns_server.
Добавлено в check_point.mgmt 6.5.0
Краткое описание
- Управляет объектами securemote-dns-server на устройствах Checkpoint, включая создание, обновление и удаление объектов.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии управления R82 JHF.
Параметры
Параметр | Комментарии |
|---|---|
auto_publish_session boolean | Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Строка комментария. |
details_level string | Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения UID объекта до его полного подробного представления. Варианты:
|
domains list / elements=dictionary | Домены DNS, к которым могут получать доступ удалённые клиенты. |
|
domain_suffix string |
Суффикс домена DNS. |
|
maximum_prefix_label_count integer |
Максимальное количество совпадающих меток перед суффиксом. |
domains_to_process list / elements=string | Указывает, для каких доменов выполнять команды. Не может использоваться с уровнем детализации full; запускать можно только из системного домена и при значении ignore-warnings true. Допустимые значения: CURRENT_DOMAIN, ALL_DOMAINS_ON_THIS_SERVER. |
host string | DNS-сервер для удалённых клиентов в сообществе удалённого доступа. Идентифицируется по имени или UID. |
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не получится. Если флаг ignore-warnings не указан, предупреждения также будут проигнорированы. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
name string / обязательный | Имя объекта. |
state string | Состояние правила доступа (present или absent). Варианты:
|
tags list / elements=string | Набор идентификаторов тегов. |
version string | Версия Checkpoint. Если не указана, используется последняя версия. |
wait_for_task boolean | Дождаться завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: add-securemote-dns-server
cp_mgmt_securemote_dns_server:
domains:
- domain_suffix: .FirstDomain
maximum_prefix_label_count: 3
- domain_suffix: .SecondDomain
host: TestHost
name: TestSecuRemoteDNSSever
state: present
- name: set-securemote-dns-server
cp_mgmt_securemote_dns_server:
host: TestHost2
name: TestSecuRemoteDNSSever
state: present
- name: delete-securemote-dns-server
cp_mgmt_securemote_dns_server:
name: TestSecuRemoteDNSSever
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже приведены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_securemote_dns_server dictionary | Созданный или обновлённый объект Checkpoint. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/check_point/mgmt/cp_mgmt_securemote_dns_server_module.html