Модуль cisco.ise.trustsec_vn_vlan_mapping – Модуль ресурсов для сопоставления VLAN Trustsec VN

Примечание

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

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

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

Для использования в книге задач укажите: cisco.ise.trustsec_vn_vlan_mapping.

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

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

Описание

Управление операциями создания, обновления и удаления ресурса Trustsec VN VLAN Mapping.
Создание сопоставления VN-VLAN.
Обновление сопоставления VN-VLAN.

Примечание

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

Требования

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

ciscoisesdk >= 2.2.3
python >= 3.5

Параметры

Параметр	Комментарии
id строка	Идентификатор сопоставления VN-VLAN.
isData булево	Флаг, указывающий, является ли VLAN типом данных или голоса. Варианты: `false` `true`
isDefaultVLAN булево	Флаг, указывающий, является ли VLAN стандартным. Варианты: `false` `true`
ise_debug булево	Флаг для Identity Services Engine SDK для включения отладки. Варианты: `false` ← (по умолчанию) `true`
ise_hostname строка / обязательно	Имя хоста Identity Services Engine.
ise_password строка / обязательно	Пароль Identity Services Engine для аутентификации.
ise_single_request_timeout целое число добавлен в cisco.ise 3.0.0	Таймаут (в секундах) для RESTful HTTP-запросов. По умолчанию: `60`
ise_username строка / обязательно	Имя пользователя Identity Services Engine для аутентификации.
ise_uses_api_gateway булево добавлен в 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 булево добавлен в cisco.ise 3.0.0	Флаг, информирующий SDK, отправлять ли токен CSRF в API ERS ISE. Если он имеет значение True, SDK предполагает, что проверка CSRF ISE включена. Если он имеет значение True, предполагается, что вам нужно, чтобы SDK автоматически управлял токеном CSRF. Варианты: `false` ← (по умолчанию) `true`
ise_verify булево	Флаг для включения или отключения проверки сертификата SSL. Варианты: `false` `true` ← (по умолчанию)
ise_version строка	Информирует SDK о том, какую версию Identity Services Engine использовать. По умолчанию: `"3.1_Patch_1"`
ise_wait_on_rate_limit булево	Флаг для Identity Services Engine SDK для включения автоматической обработки лимитов скорости. Варианты: `false` `true` ← (по умолчанию)
lastUpdate строка	Отметка времени последнего обновления сопоставления VN-VLAN.
maxValue целое число	Максимальное значение.
name строка	Имя VLAN.
vnId строка	Идентификатор связанной виртуальной сети, который требуется, если не указано её имя.
vnName строка	Имя связанной виртуальной сети, используемой для идентификации, если не указан идентификатор.

Примечания

Примечание

Используемые методы SDK: vn_vlan_mapping.VnVlanMapping.create_vn_vlan_mapping, vn_vlan_mapping.VnVlanMapping.delete_vn_vlan_mapping, vn_vlan_mapping.VnVlanMapping.update_vn_vlan_mapping,
Используемые пути: post /api/v1/trustsec/vnvlanmapping, delete /api/v1/trustsec/vnvlanmapping/{id}, put /api/v1/trustsec/vnvlanmapping/{id},
Не поддерживает check_mode
Плагин работает на контрольном узле и не использует какие-либо плагины подключения ansible, а вместо этого встроенный менеджер подключений из Cisco ISE SDK
Параметры, начинающиеся с ise_, используются SDK Cisco ISE Python для установления подключения

См. также

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

Примеры

- name: Create
  cisco.ise.trustsec_vn_vlan_mapping:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    id: string
    isData: true
    isDefaultVlan: true
    lastUpdate: string
    maxValue: 0
    name: string
    vnId: string
    vnName: string

- name: Update by id
  cisco.ise.trustsec_vn_vlan_mapping:
    ise_hostname: "{{ise_hostname}}"
    ise_username: "{{ise_username}}"
    ise_password: "{{ise_password}}"
    ise_verify: "{{ise_verify}}"
    state: present
    id: string
    isData: true
    isDefaultVlan: true
    lastUpdate: string
    maxValue: 0
    name: string
    vnId: string
    vnName: string

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

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

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

Ключ	Описание
ise_response список / элементы=словарь	Словарь или список со значением, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: `"[\n {\n \"id\": \"string\",\n \"isData\": true,\n \"isDefaultVlan\": true,\n \"lastUpdate\": \"string\",\n \"maxValue\": 0,\n \"name\": \"string\",\n \"vnId\": \"string\",\n \"vnName\": \"string\"\n }\n]\n"`
ise_update_response словарь	Словарь или список со значением, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: `{"message": "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/trustsec_vn_vlan_mapping_module.html