Модуль cisco.ise.reservation – Ресурсный модуль для резервирования

Примечание

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

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

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

Для использования в playbook, укажите: cisco.ise.reservation.

Новое в cisco.ise 1.0.0

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

Краткое описание

Управление операциями создания, обновления и удаления ресурса Reservation.
Резервирование заданного количества SGT в непрерывном диапазоне для заданного клиента.
Удаление зарезервированного диапазона SGT для заданного клиента.
Обновление зарезервированных диапазонов определенного клиента, указав пользовательский начальный и конечный индекс.

Примечание

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

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
clientID string	Параметр пути ClientID. Уникальное имя для клиента.
clientName string	Имя заданного клиента.
endIndex integer	Конечный индекс зарезервированного диапазона.
ise_debug boolean	Флаг для Identity Services Engine SDK для включения отладки. Варианты: `false` ← (по умолчанию) `true`
ise_hostname string / обязательно	Имя хоста Identity Services Engine.
ise_password string / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout integer добавлено в cisco.ise 3.0.0	Время ожидания (в секундах) для HTTP-запросов RESTful. По умолчанию: `60`
ise_username string / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway boolean добавлено в cisco.ise 1.1.0	Флаг, который сообщает SDK, следует ли использовать шлюз API Identity Services Engine для отправки запросов. Если он истинный, используется шлюз API ISE и запросы отправляются на https://{{ise_hostname}}. Если он ложный, запросы отправляются на 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. Если он истинный, SDK предполагает, что проверка CSRF вашего ISE включена. Если он истинный, предполагается, что вам нужно, чтобы 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` ← (по умолчанию)
numberOfTags integer	Количество тегов, которые необходимо зарезервировать в ISE.
startIndex integer	Начальный индекс зарезервированного диапазона.

Примечания

Примечание

Используемые методы SDK: sgt_range_reservation.SgtRangeReservation.delete_sgt_reserve_range, sgt_range_reservation.SgtRangeReservation.reserve_sgt_range, sgt_range_reservation.SgtRangeReservation.update_reserved_range,
Используемые пути: post /api/v1/sgt/reservation/reserveRange, delete /api/v1/sgt/reservation/{clientID}, put /api/v1/sgt/reservation/{clientID},
Не поддерживает check_mode
Плагин работает на узле управления и не использует плагины подключения ansible, а вместо этого встроенный менеджер подключений из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения

Примеры

- name: Create
  cisco.ise.reservation:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    clientName: string
    numberOfTags: 0

- name: Update by id
  cisco.ise.reservation:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    clientID: string
    endIndex: 0
    startIndex: 0

- name: Delete by id
  cisco.ise.reservation:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: absent
    clientID: string

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

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

Ключ	Описание
ise_response словарь	Словарь или список со значением возврата от Cisco ISE Python SDK Возвращается: всегда Пример: `{"clientID": "string", "clientName": "string", "endIndex": 0, "startIndex": 0}`
ise_update_response словарь добавлен в cisco.ise 1.1.0	Словарь или список со значением возврата от Cisco ISE Python SDK Возвращается: всегда Пример: `{"success": {"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/reservation_module.html