cisco.dnac.events_and_notifications_workflow_manager 模块 – 配置各种类型的目标,以便从 Cisco Catalyst Center 平台传递事件通知。

注意

此模块是 cisco.dnac 集合(版本 6.25.0)的一部分。

如果您使用的是 ansible 包,则可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用:ansible-galaxy collection install cisco.dnac。您需要进一步的要求才能使用此模块,请参阅 要求了解详细信息。

要在 playbook 中使用它,请指定:cisco.dnac.events_and_notifications_workflow_manager

cisco.dnac 6.14.0 中的新增功能

概要

  • 配置各种类型的目标,以便从 Cisco Catalyst Center 平台传递事件通知。

  • 在 Cisco Catalyst Center 中配置/更新 Webhook 目标详细信息。

  • 在 Cisco Catalyst Center 中配置/更新电子邮件目标详细信息。

  • 在 Cisco Catalyst Center 中配置/更新 Syslog 目标详细信息。

  • 在 Cisco Catalyst Center 中配置/更新 SNMP 目标详细信息。

  • 在 Cisco Catalyst Center 中配置/更新 ITSM 集成设置。

  • 从 Cisco Catalyst Center 中删除 ITSM 集成设置。

  • 在 Cisco Catalyst Center 中使用上述目标创建/更新通知。

要求

在执行此模块的主机上需要以下要求。

  • dnacentersdk >= 2.7.2

  • python >= 3.5

参数

参数

注释

config

列表 / 元素=字典 / 必需

包含通过一个或多个通道在站点上进行事件、通知的订阅配置的列表。

email_destination

字典

配置从 Cisco Catalyst Center 发送电子邮件的设置。此外,我们可以在 Cisco Catalyst Center 中仅创建或配置一次电子邮件目标,然后在稍后对其进行修改。此项仅用于配置电子邮件目标时的主 SMTP 服务器和辅助 SMTP 服务器。它与电子邮件事件订阅通知无关。

primary_smtp_config

字典

在创建/更新电子邮件目标时,添加 smtp 的主配置。

password

字符串

用于验证主 SMTP 服务器的密码。

port

字符串

用于配置主 SMTP 服务器的端口号。此外,如果 snmp_type 为 DEFAULT,则端口为 25,而对于 smtp_type TLS 或 SSL,我们可以选择 465 或 587 作为端口号,则 snmp_type 和端口之间存在映射。

server_address

字符串 / 必需

主 SMTP 服务器的主机名或 IP 地址。支持 IPv4 和 IPv6。

smtp_type

字符串 / 必需

用于 SMTP 服务器的连接类型,选项为 DEFAULT、TLS 或 SSL。默认情况下,它设置为 DEFAULT。DEFAULT - 选择不加密的标准 SMTP 连接。如果选择了此项,则端口将仅为 25。TLS - 启动未加密的 SMTP 连接并在可用时升级到 TLS 加密。如果选择了此项,则端口将为 465 或 587。SSL - 从一开始就使用 SSL 启动加密的 SMTP 连接。如果选择了此项,则端口将为 465 或 587。

username

字符串

用于验证主 SMTP 服务器的用户名。

recipient_email

字符串 / 必需

当创建或更新电子邮件目标时将接收电子邮件的收件人电子邮件地址。

secondary_smtp_config

字典

在创建或更新电子邮件目标时包含可选的辅助 SMTP 配置。

password

字符串

用于验证辅助 SMTP 服务器的密码。

port

字符串

用于配置辅助 SMTP 服务器的端口号。此外,如果 snmp_type 为 DEFAULT,则端口为 25,而对于 smtp_type TLS 或 SSL,我们可以选择 465 或 587 作为端口号,则 snmp_type 和端口之间存在映射。

server_address

字符串

辅助 SMTP 服务器的主机名或 IP 地址。支持 IPv4 和 IPv6。

smtp_type

字符串

用于 SMTP 服务器的连接类型,选项为 DEFAULT、TLS 或 SSL。默认情况下,它设置为 DEFAULT。DEFAULT - 选择不加密的标准 SMTP 连接。如果选择了此项,则端口将仅为 25。TLS - 启动未加密的 SMTP 连接并在可用时升级到 TLS 加密。如果选择了此项,则端口将为 465 或 587。SSL - 从一开始就使用 SSL 启动加密的 SMTP 连接。如果选择了此项,则端口将为 465 或 587。

username

字符串

用于验证辅助 SMTP 服务器的用户名。

sender_email

字符串 / 必需

设置或修改电子邮件目标时使用的发件人电子邮件地址。

subject

字符串 / 必需

从指定的电子邮件目标发送电子邮件时要使用的电子邮件的主题行。

email_event_notification

字典

用于在 Cisco Catalyst Center 中设置或修改电子邮件事件订阅的配置。这包括电子邮件通知本身的参数以及相关电子邮件实例的详细信息。

description

字符串 / 必需

详细说明电子邮件事件订阅通知目的的简要说明。

domain

字符串

事件所属的主要类别或域(例如,“了解您的网络”、“连接”等)。

event_categories

列表 / 元素=字符串

要包含在通知订阅中的事件类别列表(例如,WARN、INFO、ERROR、ALERT、TASK_COMPLETE、TASK_FAILURE)。

event_severities

列表 / 元素=字符串

要包含在通知订阅中的事件严重性列表(例如,[“1”, “2”, “3”])。

event_sources

列表 / 元素=字符串

要包含在通知订阅中的事件源列表。

event_types

列表 / 元素=字符串

触发通知的事件类型,定义事件的性质(例如,[“APP”、“NETWORK”])。

events

列表 / 元素=字符串 / 必需

要订阅的用于通知配置的事件名称列表(例如,[“AP 翻动”、“AP 重启崩溃”])。

实例

字符串 / 必需

分配给用于发送通知的特定电子邮件实例的名称。

实例描述

字符串 / 必需

详细解释电子邮件实例的用途以及它与通知的关系。

名称

字符串 / 必需

电子邮件事件订阅通知的名称。

收件人电子邮件

列表 / 元素=字符串 / 必需

将接收通知的收件人电子邮件地址。

sender_email

字符串 / 必需

用于发送通知的原始电子邮件地址。

站点

列表 / 元素=字符串

通知订阅中包含事件的站点名称列表(例如,[“全球/印度”,“全球/美国”])。

子域

列表 / 元素=字符串

主域内更具体的类别,用于进一步分类事件(例如,[“无线”,“应用程序”])。

subject

字符串 / 必需

电子邮件通知的主题行,简要指示通知内容。

版本

字符串

事件订阅的版本标签,有助于跟踪更新或更改。

itsm_设置

字典

包含配置详细信息的字典,用于配置 ServiceNow/BMCRemedy 设置,以便从 Cisco Catalyst Center 自动创建事件/问题/RFC。

连接设置

字典

与 ITSM 系统建立连接所需的设置字典。

password

字符串 / 必需

与 API 身份验证的用户名关联的密码。建议安全地处理此数据。

URL

字符串 / 必需

ITSM 系统 API 端点的 URL。这是用于 ITSM 服务请求的基本 URL。

username

字符串 / 必需

用于与 ITSM 系统进行身份验证的用户名。这是访问 API 所必需的。

description

字符串

ITSM 设置的简短描述,概述其在组织内的用途或用法。

实例名称

字符串 / 必需

ITSM 配置的名称。这有助于在系统中识别集成。此外,在从 Cisco Catalyst Center 删除 ITSM 集成设置时也需要此名称。

snmp_目标

字典

包含用于配置/更新 SNMP 陷阱服务器以接收来自 Cisco Catalyst Center 的审计日志和事件的详细信息的字典。

auth_密码

字符串

用于 SNMP 身份验证的密码。

auth_类型

字符串

要使用的 SNMP 身份验证协议类型,例如 MD5 或 SHA。SHA - 代表安全散列算法,是美国国家安全局 (NSA) 开发的一套加密散列函数,提供增强的安全性。MD5 - 指消息摘要算法 5,是一种成熟的加密散列函数,生成 128 位散列值,在 SNMPv3 中用于消息的真实性和完整性验证。

团体

字符串

用于身份验证的 SNMP 团体字符串,仅当 snmp_version 设置为 V2C 时才需要。

description

字符串 / 必需

SNMP 目标的描述。

模式

字符串

SNMP 通信的安全模式(选项 - AUTH_PRIVACY、AUTH_NO_PRIVACY、NO_AUTH_NO_PRIVACY)。对于 snmp_version V3 是强制性的,并且不能设置为 NONE。AUTH_PRIVACY - 最安全的模式,通过身份验证验证消息来源,并通过加密保护消息内容。如果选择此选项,则必须在 playbook 中提供 auth_type、auth_password、privacy_type、privacy_password 参数。AUTH_NO_PRIVACY - 此模式通过用于验证的团体字符串确保 SNMP 消息的真实性,但不加密数据,使其容易受到拦截。如果选择此选项,则必须在 playbook 中提供 auth_type、auth_password 参数。NO_AUTH_NO_PRIVACY - 在此模式下,SNMP 消息既不进行身份验证也不进行加密,因此安全性最低,因为它不需要凭据或数据保护。如果选择此选项,则不需要在 playbook 中提供 auth_type、auth_password、privacy_type、privacy_password 参数。

名称

字符串 / 必需

SNMP 目标的名称。

port

字符串 / 必需

SNMP 服务器正在侦听的端口号。

privacy_密码

字符串

用于 SNMP 隐私中加密的密码。

privacy_类型

字符串

用于 SNMP 隐私的加密算法,例如 AES128。

server_address

字符串 / 必需

SNMP 服务器的 IP 地址。

snmp_版本

字符串

用于网络管理和监控的 SNMP 协议版本,可在 SNMPv2c 和 SNMPv3 之间选择。V2C - 利用团体字符串在 SNMP 管理器(如 Cisco Catalyst)和受管理的网络设备(路由器、交换机、接入点)之间进行身份验证,不进行加密,因为字符串以纯文本发送。V3 - 提供比 V2C 更强的安全功能,包括身份验证、完整性和加密,使用用户名、密码和加密密钥进行安全通信。

username

字符串

SNMP 身份验证所需的用户名,仅当 snmp_version 配置为 V3 时适用。

syslog_目标

字典

包含用于配置/更新 Syslog 服务器以从 Cisco Catalyst Center 收集审计日志和事件的详细信息的字典。

description

字符串 / 必需

详细说明 syslog 目标用途的简要说明。

名称

字符串 / 必需

syslog 目标的名称。

port

integer / 必需

syslog 服务器正在侦听的端口号。它必须在 1-65535 的范围内。如果没有给出任何端口,则我们将使用 514 作为默认端口。

协议

字符串 / 必需

用于发送 syslog 消息的协议(例如,UDP、TCP)。传输控制协议 (TCP) - 它是一种面向连接的协议,用于设备之间在网络上进行可靠和有序的通信。它提供错误检查、丢失数据包的重传,并确保数据按正确的顺序传递。用户数据报协议 (UDP) - 它是一种无连接协议,用于在网络上的设备之间发送数据报。它提供了一种轻量级的、尽力而为的交付机制,不保证数据包的交付或顺序。UDP 通常用于实时应用程序,如流媒体、在线游戏和 VoIP。

server_address

字符串 / 必需

Syslog 服务器的主机名或 IP 地址。

syslog_事件_通知

字典

用于在 Cisco Catalyst Center 中建立或修改 Syslog 事件订阅的配置。这允许指定 Syslog 事件通知参数和目标设置。

description

字符串 / 必需

详细说明 syslog 事件订阅通知用途的简要说明。

目标

字符串 / 必需

通过 syslog 发送事件通知的目标名称。

domain

字符串

事件所属的主要类别或域(例如,“了解您的网络”、“连接”等)。

event_categories

列表 / 元素=字符串

要包含在通知订阅中的事件类别列表(例如,WARN、INFO、ERROR、ALERT、TASK_COMPLETE、TASK_FAILURE)。

event_severities

列表 / 元素=字符串

要包含在通知订阅中的事件严重性列表(例如,[“1”, “2”, “3”])。

event_sources

列表 / 元素=字符串

要包含在通知订阅中的事件源列表。

event_types

列表 / 元素=字符串

触发通知的事件类型,定义事件的性质(例如,[“APP”、“NETWORK”])。

events

列表 / 元素=字符串 / 必需

要订阅的用于通知配置的事件名称列表(例如,[“AP 翻动”、“AP 重启崩溃”])。

名称

字符串 / 必需

Syslog 事件订阅通知的名称。

站点

列表 / 元素=字符串

通知订阅中包含事件的站点名称列表(例如,[“全球/印度”,“全球/美国”])。

子域

列表 / 元素=字符串

主域内更具体的类别,用于进一步分类事件(例如,[“无线”,“应用程序”])。

版本

字符串

事件订阅的版本标签,有助于跟踪更新或更改。

webhook_目标

字典

包含用于配置/更新 REST 端点以接收来自 Cisco Catalyst Center 平台的审计日志和事件的详细信息的字典。

description

字符串

简要说明 webhook 目标用途的简短说明。

标头

list / elements=dictionary

要包含在 webhook 请求中的 HTTP 标头列表。每个标头都表示为一个字典。在提供标头详细信息时,我们可以将其分为 - “基本、令牌和无身份验证”。基本身份验证 - 用于确保接收服务器可以通过检查凭据是否与存储匹配来验证请求服务器的身份。此方法很简单,但与其他方法相比安全性较低,因为凭据以编码形式发送,但未加密。令牌身份验证 - 涉及通常由服务器生成的安全令牌。客户端必须在 HTTP 标头中发送此令牌才能访问资源。它比基本身份验证更安全,因为它允许服务器颁发具有有限生命周期、可撤销且携带特定权限的令牌,而不会暴露用户凭据。无身份验证 - 表示不需要身份验证方法即可访问 webhook 目标。此设置可用于安全由其他方式(如网络隔离)处理或传输的数据不敏感的环境中。

默认值

字符串

如果未提供特定值,则可以使用的 HTTP 标头的默认值。

加密

布尔值

指示是否应加密标头的值。对敏感数据很有用。

选择

  • false

  • true

名称

字符串

HTTP 标头的名称。

字符串

分配给 HTTP 标头的值。

is_proxy_路由

布尔值

指示请求是否应使用代理服务器的布尔值。它将为代理路由设置为 true,为直接连接设置为 false。默认情况下,它设置为 True。

选择

  • false

  • true

方法

字符串

webhook 发送请求时使用的 HTTP 方法(例如,POST、PUT)。POST - 通常用于创建新的 webhook 目标。当您在 Cisco Catalyst Center 中设置新的 webhook 时,您将使用 POST 方法将必要的配置详细信息(如 URL、标头、有效负载格式等)发送到服务器。PUT - 用于更新现有的 webhook 目标。如果已配置 webhook 目标,并且您需要更改其任何设置,例如修改 URL、调整标头或更改有效负载格式。

名称

字符串 / 必需

webhook 目标的名称。系统中 webhook 目标的唯一标识符。

trust_证书

布尔值

一个布尔值,指示是否验证 URL 的 SSL/TLS 证书,将其设置为 true 将绕过证书验证。默认情况下,它设置为 false。

选择

  • false

  • true

URL

字符串 / 必需

webhook 将向其发送请求的完全限定 URL(例如,“https://ciscocatalyst.com”)。

webhook_事件_通知

字典

包含用于在 Cisco Catalyst Center 中创建/更新 Webhook 事件订阅通知的详细信息的字典。

description

字符串 / 必需

详细说明电子邮件事件订阅通知用途的简要说明。

目标

字符串 / 必需

通过 webhook 发送事件通知的目标名称。

domain

字符串

事件所属的主要类别或域(例如,“了解您的网络”、“连接”等)。

event_categories

列表 / 元素=字符串

要包含在通知订阅中的事件类别列表(例如,WARN、INFO、ERROR、ALERT、TASK_COMPLETE、TASK_FAILURE)。

event_severities

列表 / 元素=字符串

要包含在通知订阅中的事件严重性列表(例如,[“1”, “2”, “3”])。

event_sources

列表 / 元素=字符串

要包含在通知订阅中的事件源列表。

event_types

列表 / 元素=字符串

触发通知的事件类型,定义事件的性质(例如,[“APP”、“NETWORK”])。

events

列表 / 元素=字符串 / 必需

要订阅的用于通知配置的事件名称列表(例如,[“AP 翻动”、“AP 重启崩溃”])。

名称

字符串 / 必需

Webhook 事件订阅通知的名称。

站点

列表 / 元素=字符串

通知订阅中包含事件的站点名称列表(例如,[“全球/印度”,“全球/美国”])。

子域

列表 / 元素=字符串

主域内更具体的类别,用于进一步分类事件(例如,[“无线”,“应用程序”])。

版本

字符串

事件订阅的版本标签,有助于跟踪更新或更改。

config_验证

布尔值

设置为 True 可在应用 playbook 配置后验证 Cisco Catalyst Center 配置。

选择

  • false ←(默认)

  • true

dnac_api_任务_超时

integer

定义用于检索任务详细信息的 API 调用的超时时间(以秒为单位)。如果在此期间未收到任务详细信息,则该过程将结束,并记录超时通知。

默认值: 1200

dnac_调试

布尔值

指示是否在 Cisco Catalyst Center SDK 中启用了调试。

选择

  • false ←(默认)

  • true

dnac_主机

字符串 / 必需

Cisco Catalyst Center 的主机名。

dnac_log

布尔值

启用/禁用剧本执行日志记录的标志。

当为 true 且提供了 dnac_log_file_path 时,- 在执行位置创建具有指定名称的日志文件。

当为 true 且未提供 dnac_log_file_path 时,- 在执行位置创建名为“dnac.log”的日志文件。

当为 false 时,- 禁用日志记录。

如果日志文件不存在,- 它将根据“dnac_log_append”标志以追加或写入模式创建。

如果日志文件存在,- 它将根据“dnac_log_append”标志被覆盖或追加。

选择

  • false ←(默认)

  • true

dnac_log_append

布尔值

确定文件的模式。设置为 True 表示“追加”模式。设置为 False 表示“写入”模式。

选择

  • false

  • true ← (默认)

dnac_log_file_path

字符串

控制日志记录。如果 dnac_log 为 True,则会记录日志。

如果未指定路径,- 当“dnac_log_append”为 True 时,将在当前 Ansible 目录中生成“dnac.log”;日志会被追加。- 当“dnac_log_append”为 False 时,将生成“dnac.log”;日志会被覆盖。

如果指定了路径,- 当“dnac_log_append”为 True 时,文件以追加模式打开。- 当“dnac_log_append”为 False 时,文件以写入 (w) 模式打开。- 在共享文件场景中,如果没有追加模式,内容会在每次模块执行后被覆盖。- 对于共享日志文件,第一个模块将追加设置为 False(以覆盖);对于后续模块,将追加设置为 True。

默认值: "dnac.log"

dnac_log_level

字符串

设置日志级别的阈值。级别等于或高于此级别的消息将被记录。级别按严重性顺序列出 [CRITICAL, ERROR, WARNING, INFO, DEBUG]。

CRITICAL 表示导致程序停止的严重错误。仅显示 CRITICAL 消息。

ERROR 表示阻止函数运行的问题。显示 ERROR 和 CRITICAL 消息。

WARNING 表示潜在的未来问题。显示 WARNING、ERROR 和 CRITICAL 消息。

INFO 跟踪正常操作。显示 INFO、WARNING、ERROR 和 CRITICAL 消息。

DEBUG 提供详细的诊断信息。显示所有日志消息。

默认值: "WARNING"

dnac_password

字符串

用于在 Cisco Catalyst Center 上进行身份验证的密码。

dnac_port

字符串

指定与 Cisco Catalyst Center 关联的端口号。

默认值: "443"

dnac_task_poll_interval

integer

指定连续调用 API 以检索任务详细信息的时间间隔(以秒为单位)。

默认值: 2

dnac_username

别名: user

字符串

用于在 Cisco Catalyst Center 上进行身份验证的用户名。

默认值: "admin"

dnac_verify

布尔值

启用或禁用 SSL 证书验证的标志。

选择

  • false

  • true ← (默认)

dnac_version

字符串

指定 SDK 应使用的 Cisco Catalyst Center 版本。

默认值: "2.2.3.3"

state

字符串

模块完成后 Cisco Catalyst Center 的状态。

选择

  • "merged" ← (默认)

  • "deleted"

validate_response_schema

布尔值

Cisco Catalyst Center SDK 用于启用针对 JSON 模式验证请求主体的标志。

选择

  • false

  • true ← (默认)

注意

注意

  • 为了确保模块在扩展集(例如创建或更新多个目标以及处理事件订阅通知)中正常运行,请确保在剧本中提供有效的输入。如果发生任何故障,模块将停止执行,并且不会继续执行后续操作。

  • 从 dnacentersdk 2.9.1 版本开始,配置带有标头的 Webhook 目标现在受支持。此增强功能与 Catalyst Center 2.3.7.5 版本保持一致。

  • 从 dnacentersdk 2.9.1 版本开始,配置 SNMP 目标现在受支持。此增强功能与 Catalyst Center 2.3.7.5 版本保持一致。

  • 使用的 SDK 方法是 events.Events.get_syslog_destination、events.Events.create_syslog_destination、events.Events.update_syslog_destination、events.Events.get_snmp_destination、events.Events.create_snmp_destination、events.Events.update_snmp_destination、events.Events.get_webhook_destination、events.Events.create_webhook_destination、events.Events.update_webhook_destination、events.Events.get_email_destination、events.Events.create_email_destination、events.Events.get_status_api_for_events、events.Events.get_all_itsm_integration_settings、events.Events.get_itsm_integration_setting_by_id、events.Events.create_itsm_integration_setting、events.Events.update_itsm_integration_setting、events.Events.delete_itsm_integration_setting、events.Events.get_eventartifacts、events.Events.get_site、events.Events.get_syslog_event_subscriptions、events.Events.get_syslog_subscription_details、events.Events.create_syslog_event_subscription、events.Events.update_syslog_event_subscription、events.Events.get_rest_webhook_event_subscriptions、events.Events.get_rest_webhook_subscription_details、events.Events.create_rest_webhook_event_subscription、events.Events.update_rest_webhook_event_subscription、events.Events.get_email_event_subscriptions、events.Events.get_email_subscription_details、events.Events.create_email_event_subscription、events.Events.update_email_event_subscription、events.Events.delete_event_subscriptions

  • 不支持 check_mode

  • 该插件在控制节点上运行,并且不使用任何 ansible 连接插件,而是使用 Cisco Catalyst Center SDK 中的嵌入式连接管理器。

  • 以 dnac_ 开头的参数由 Cisco Catalyst Center Python SDK 用于建立连接

示例

- name: Create Rest Webhook destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - webhook_destination:
          name: "webhook test"
          description: "creating webhook for testing"
          url: "https://10.195.227.14/dna"
          method: "POST"
          trust_cert: False

- name: Updating Rest Webhook destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - webhook_destination:
          name: "webhook test"
          description: "updating webhook for testing"


- name: Configuring the email destination in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - email_destination:
          sender_email: "[email protected]"
          recipient_email: "[email protected]"
          subject: "Ansible testing"
          primary_smtp_config:
            server_address: "outbound.cisco.com"
            port: "25"
            smtp_type: "DEFAULT"

- name: Updating the email destination in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - email_destination:
          sender_email: "[email protected]"
          recipient_email: "[email protected]"
          subject: "Ansible updated email config testing"

- name: Create Syslog destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - syslog_destination:
          name: Syslog test
          description: "Adding syslog destination"
          server_address: "10.30.0.90"
          protocol: "TCP"
          port: 6553

- name: Update Syslog destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - syslog_destination:
          name: Syslog test
          description: "Updating syslog destination."

- name: Create SNMP destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - snmp_destination:
          name: Snmp test
          description: "Adding snmp destination for testing."
          server_address: "10.30.0.90"
          port: "25"
          snmp_version: "V3"
          username: cisco
          mode: AUTH_PRIVACY
          auth_type: SHA
          auth_password: authpass123
          privacy_type: AES128
          privacy_password: privacy123

- name: Update SNMP destination with given name.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - snmp_destination:
          name: Snmp test
          description: "Updating snmp destination with snmp version v2."
          server_address: "10.30.0.23"
          port: "25"
          snmp_version: "V2C"
          community: "public123"

- name: Create ITSM Integration Setting with given name in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - itsm_setting:
          instance_name: "ITSM test"
          description: "ITSM description for testing"
          connection_settings:
            url: "http/catalystcenter.com"
            username: "catalyst"
            password: "catalyst@123"

- name: Updating ITSM Integration Setting with given name in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - itsm_setting:
          instance_name: "ITSM test"
          connection_settings:
            url: "http/catalystcenterupdate.com"
            password: "catalyst@123"

- name: Creating Webhook Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - webhook_event_notification:
          name: "Webhook Notification."
          description: "Notification for webhook events subscription"
          sites: ["Global/India", "Global/USA"]
          events: ["AP Flap", "AP Reboot Crash", "Device Updation"]
          destination: "Webhook Demo"

- name: Updating Webhook Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - webhook_event_notification:
          name: "Webhook Notification."
          description: "Updated notification for webhook events subscription"
          sites: ["Global/India", "Global/USA", "Global/China"]
          destination: "Webhook Demo"

- name: Creating Email Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - email_event_notification:
          name: "Email Notification"
          description: "Notification description for email subscription creation"
          sites: ["Global/India", "Global/USA"]
          events: ["AP Flap", "AP Reboot Crash"]
          sender_email: "[email protected]"
          recipient_emails: ["[email protected]", "[email protected]"]
          subject: "Mail test"
          instance: Email Instance test

- name: Updating Email Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - email_event_notification:
          name: "Email Notification"
          description: "Notification description for email subscription updation"
          sites: ["Global/India", "Global/USA"]
          events: ["AP Flap", "AP Reboot Crash"]
          sender_email: "[email protected]"
          recipient_emails: ["[email protected]", "[email protected]", "[email protected]"]
          subject: "Mail test for updation"
          instance: Email Instance test

- name: Creating Syslog Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - syslog_event_notification:
          name: "Syslog Notification."
          description: "Notification for syslog events subscription"
          sites: ["Global/India", "Global/USA"]
          events: ["AP Flap", "AP Reboot Crash"]
          destination: "Syslog Demo"

- name: Updating Syslog Notification with the list of names of subscribed events in the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: merged
    config:
      - syslog_event_notification:
          name: "Syslog Notification."
          description: "Updated notification for syslog events subscription"
          sites: ["Global/India", "Global/USA", "Global/China"]
          events: ["AP Flap", "AP Reboot Crash"]

- name: Deleting ITSM Integration Setting with given name from the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: deleted
    config:
      - itsm_setting:
          instance_name: "ITSM test"

- name: Deleting Webhook Events Subscription Notification with given name from the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: deleted
    config:
      - webhook_event_notification:
          name: "Webhook Notification"

- name: Deleting Email Events Subscription Notification with given name from the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: deleted
    config:
      - email_event_notification:
          name: "Email Notification"

- name: Deleting Syslog Events Subscription Notification with given name from the system.
  cisco.dnac.events_and_notifications_workflow_manager:
    dnac_host: "{{dnac_host}}"
    dnac_username: "{{dnac_username}}"
    dnac_password: "{{dnac_password}}"
    dnac_verify: "{{dnac_verify}}"
    dnac_port: "{{dnac_port}}"
    dnac_version: "{{dnac_version}}"
    dnac_debug: "{{dnac_debug}}"
    dnac_log_level: "{{dnac_log_level}}"
    dnac_log: False
    state: deleted
    config:
      - syslog_event_notification:
          name: "Syslog Notification"

返回值

常见返回值记录在此处,以下是此模块特有的字段

描述

dnac_response

字典

包含 Cisco Catalyst Center Python SDK 返回的响应的字典或列表

返回: 始终

示例: {"response": {"taskId": "string", "url": "string"}, "version": "string"}

作者

  • Abhishek Maheshwari (@abmahesh) Madhan Sankaranarayanan (@madhansansel)