Модуль cisco.ise.sg_acl – Модуль ресурсов для SGACL
Примечание
Этот модуль входит в состав коллекции cisco.ise (версия 2.9.3).
У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.ise. Для использования этого модуля требуются дополнительные зависимости, см. Требования для подробностей.
Чтобы использовать его в книге задач, укажите: cisco.ise.sg_acl.
Новое в cisco.ise 1.0.0
Описание
- Управление операциями создания, обновления и удаления ресурса SGACL.
- Этот API создает ACL для группы безопасности.
- Этот API удаляет ACL для группы безопасности.
- Этот API позволяет клиенту обновить ACL для группы безопасности.
Примечание
Данный модуль имеет соответствующий плагин действий.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, выполняющем этот модуль.
- ciscoisesdk >= 2.2.3
- python >= 3.5
Параметры
Параметр | Комментарии |
|---|---|
aclcontent строка | aclcontent SGACL. |
description строка | Описание SGACL. |
generationId строка | generationId SGACL. |
id строка | id SGACL. |
ipVersion строка | Допустимые значения - IPV4, - IPV6, - IP_AGNOSTIC. |
ise_debug логическое | Флаг для Identity Services Engine SDK для включения отладки. Выбираемые значения:
|
ise_hostname строка / обязательно | Имя хоста Identity Services Engine. |
ise_password строка / обязательно | Пароль Identity Services Engine для аутентификации. |
ise_single_request_timeout целое число добавлен в cisco.ise 3.0.0 | Таймаут (в секундах) для RESTful HTTP-запросов. По умолчанию: |
ise_username строка / обязательно | Имя пользователя Identity Services Engine для аутентификации. |
ise_uses_api_gateway логическое добавлен в cisco.ise 1.1.0 | Флаг, информирующий SDK о том, использовать ли API-шлюз Identity Services Engine для отправки запросов. Если значение истинно, используется API-шлюз ISE и запросы отправляются по адресу https://{{ise_hostname}}. Если значение ложно, запросы отправляются по адресу https://{{ise_hostname}}:{{port}}, где значение порта зависит от используемой службы (ERS, Mnt, UI, PxGrid). Выбираемые значения:
|
ise_uses_csrf_token логическое добавлен в cisco.ise 3.0.0 | Флаг, информирующий SDK, отправлять ли токен CSRF в API ERS ISE. Если значение истинно, SDK предполагает, что проверка CSRF ISE включена. Если значение истинно, предполагается, что SDK должен автоматически управлять токеном CSRF. Выбираемые значения:
|
ise_verify логическое | Флаг для включения или отключения проверки SSL-сертификатов. Выбираемые значения:
|
ise_version строка | Информирует SDK о том, какую версию Identity Services Engine использовать. По умолчанию: |
ise_wait_on_rate_limit логическое | Флаг для Identity Services Engine SDK для включения автоматической обработки ограничений скорости. Выбираемые значения:
|
isReadOnly логическое | Флаг isReadOnly. Выбираемые значения:
|
modelledContent словарь | Моделируемое содержимое контракта. |
name строка | Название SGACL. |
Примечания
Примечание
- Используемые методы SDK: security_groups_acls.SecurityGroupsAcls.create_security_groups_acl, security_groups_acls.SecurityGroupsAcls.delete_security_groups_acl_by_id, security_groups_acls.SecurityGroupsAcls.update_security_groups_acl_by_id,
- Используемые пути: post /ers/config/sgacl, delete /ers/config/sgacl/{id}, put /ers/config/sgacl/{id},
- Не поддерживает
check_mode - Плагин выполняется на узле управления и не использует плагины подключения Ansible, а вместо этого использует встроенный диспетчер подключений из Cisco ISE SDK
- Параметры, начинающиеся с ise_, используются Cisco ISE Python SDK для установления подключения
См. также
См. также
- Документация Cisco ISE для SecurityGroupsACLs
-
Полная справка по API SecurityGroupsACLs.
Примеры
- name: Update by id
cisco.ise.sg_acl:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: present
aclcontent: string
description: string
generationId: string
id: string
ipVersion: string
isReadOnly: true
modelledContent: {}
name: string
- name: Delete by id
cisco.ise.sg_acl:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: absent
id: string
- name: Create
cisco.ise.sg_acl:
ise_hostname: "{{ise_hostname}}"
ise_username: "{{ise_username}}"
ise_password: "{{ise_password}}"
ise_verify: "{{ise_verify}}"
state: present
aclcontent: string
description: string
generationId: string
ipVersion: string
isReadOnly: true
modelledContent: {}
name: string
Значения возврата
Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:
Ключ | Описание |
|---|---|
ise_response словарь | Словарь или список с ответом, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: |
ise_update_response словарь добавлено в cisco.ise 1.1.0 | Словарь или список с ответом, возвращённым Cisco ISE Python SDK Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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/sg_acl_module.html
