Модуль cisco.ise.patch_install — Модуль ресурсов для установки патчей

Примечание

Этот модуль входит в состав коллекции cisco.ise (версия 2.9.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install cisco.ise. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробностей.

Чтобы использовать его в книге задач, укажите: cisco.ise.patch_install.

Новая функция в cisco.ise 2.1.0

Описание
Требования
Параметры
Примечания
См. также
Примеры
Возвращаемые значения

Описание

Управление операцией создания ресурса «Установка патча».
Инициирует установку патча на узел Cisco ISE. Возвращается идентификатор задачи, который можно использовать для мониторинга процесса установки патча. Поскольку установка патча инициирует перезапуск Cisco ISE, API задачи становится недоступным на определённый период времени. Для установки патча на вторичных узлах запрос необходимо отправлять на каждый узел индивидуально, а не на первичный узел администрирования.

Примечание

Для этого модуля существует соответствующий плагин действий.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
isDirectoryListed boolean	Флаг isDirectoryListed. Варианты: `false` `true`
ise_debug boolean	Флаг для включения отладки в SDK Identity Services Engine. Варианты: `false` ← (по умолчанию) `true`
ise_hostname string / обязательно	Имя хоста Identity Services Engine.
ise_password string / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout integer Добавлен в cisco.ise 3.0.0	Таймаут (в секундах) для RESTful HTTP запросов. По умолчанию: `60`
ise_username string / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway boolean Добавлен в cisco.ise 1.1.0	Флаг, информирующий SDK о том, использовать ли API шлюз Identity Services Engine для отправки запросов. Если значение true, используется API шлюз ISE и запросы отправляются по адресу https://{{ise_hostname}}. Если значение false, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Варианты: `false` `true` ← (по умолчанию)
ise_uses_csrf_token boolean Добавлен в cisco.ise 3.0.0	Флаг, информирующий SDK о том, отправлять ли токен CSRF в API ISE ERS. Если значение True, SDK предполагает, что проверка CSRF ISE включена. Если значение True, предполагается, что SDK должен автоматически управлять токеном CSRF. Варианты: `false` ← (по умолчанию) `true`
ise_verify boolean	Флаг для включения или отключения проверки сертификатов SSL. Варианты: `false` `true` ← (по умолчанию)
ise_version string	Информирует SDK о версии Identity Services Engine. По умолчанию: `"3.1_Patch_1"`
ise_wait_on_rate_limit boolean	Флаг для включения автоматической обработки лимита запросов в SDK Identity Services Engine. Варианты: `false` `true` ← (по умолчанию)
patchName string	Название патча для установки.
repositoryName string	Название репозитория патча.

Примечания

Примечание

Используемые методы SDK: patching.Patching.install_patch
Используемые пути: post /api/v1/patch/install
Не поддерживает check_mode
Плагин работает на контрольном узле и не использует плагины подключения ansible, а вместо этого использует встроенный менеджер подключений из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения

См. также

Документация Cisco ISE по патчам: Полное описание API для патчей.

END_OF_DOCUMENT_MARKER

Примеры

- name: Create
  cisco.ise.patch_install:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    isDirectoryListed: true
    patchName: string
    repositoryName: string

Значения возврата

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

Ключ	Описание
ise_response словарь	Словарь или список с ответом, возвращённым Python SDK Cisco ISE Возвращается: всегда Пример: `{"response": {"id": "string", "message": "string"}, "version": "string"}`

Авторы

Rafael Campos (@racampos)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/cisco/ise/patch_install_module.html