Модуль cisco.ise.transport_gateway_settings – Модуль ресурсов для настроек шлюза транспортного уровня

Примечание

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

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

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

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

Добавлен в cisco.ise 2.1.0

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

Обзор

Управление обновлением операции ресурса «Настройки шлюза транспортного уровня».
Шлюз транспортного уровня выступает в качестве прокси для связи между серверами ISE в вашей сети и серверами телеметрии в случае сети с воздушной изоляцией.

Примечание

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

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
enableTransportGateway boolean	Указывает, включен ли шлюз транспортного уровня. Варианты: `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 ERS ISE. Если он равен 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	Флаг для Identity Services Engine SDK, чтобы включить автоматическую обработку лимитов запросов. Варианты: `false` `true` ← (по умолчанию)
url string	URL шлюза транспортного уровня.

Примечания

Примечание

Используемый метод SDK — telemetry.Telemetry.update_transport_gateway,
Используемые пути — put /api/v1/system-settings/telemetry/transport-gateway,
Не поддерживает check_mode
Плагин выполняется на контрольном узле и не использует плагины подключения ansible, а вместо этого встроенный диспетчер подключения из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Python SDK Cisco ISE для установления подключения

См. также

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

Примеры

- name: Update all
  cisco.ise.transport_gateway_settings:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    enableTransportGateway: true
    url: string

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

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

Ключ	Описание
ise_response словарь	Словарь или список со значением, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: `{"enableTransportGateway": true, "url": "string"}`
ise_update_response словарь	Словарь или список со значением, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: `{"response": {"enableTransportGateway": true, "url": "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/transport_gateway_settings_module.html