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 服务器的端口号。如果 smtp_type 为 DEFAULT，则端口为 25；如果 smtp_type 为 TLS 或 SSL，则端口可以为 465 或 587。
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 服务器的端口号。如果 smtp_type 为 DEFAULT，则端口为 25；如果 smtp_type 为 TLS 或 SSL，则端口可以为 465 或 587。
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 Flap”, “AP Reboot Crash”]）。
instance 字符串 / 必需	分配给用于发送通知的特定电子邮件实例的名称。
instance_description 字符串 / 必需	对电子邮件实例的目的及其与通知相关性的详细说明。
name 字符串 / 必需	电子邮件事件订阅通知的名称。
recipient_emails 列表 / 元素=字符串 / 必需	将接收通知的收件人的电子邮件地址。
sender_email 字符串 / 必需	用于发送通知的原始电子邮件地址。
sites 列表 / 元素=字符串	通知订阅中包含事件的站点名称列表（例如，[“Global/India”, “Global/USA”]）。
subdomains 列表 / 元素=字符串	主域中更具体的类别，用于进一步分类事件（例如，[“Wireless”, “Applications”]）。
subject 字符串 / 必需	电子邮件通知的主题行，简要说明通知内容。
version 字符串	事件订阅的版本标签，有助于跟踪更新或更改。
itsm_setting 字典	包含配置详细信息的字典，用于配置 ServiceNow/BMC Remedy 设置，以便从 Cisco Catalyst Center 自动创建事件/问题/RFC。
connection_settings 字典	用于建立与ITSM系统连接所需的设置字典。
password 字符串 / 必需	与用户名关联的API身份验证密码。建议安全处理此数据。
url 字符串 / 必需	ITSM系统API端点的URL。这是用于ITSM服务请求的基本URL。
username 字符串 / 必需	用于与ITSM系统进行身份验证的用户名。这是访问API所必需的。
description 字符串	ITSM设置的简要描述，概述其在组织内的用途或用法。
instance_name 字符串 / 必需	ITSM配置的名称。这有助于识别系统内的集成。 同时在从Cisco Catalyst Center删除ITSM集成设置时也用到。
snmp_destination 字典	包含用于配置/更新SNMP Trap服务器以接收来自Cisco Catalyst Center的审计日志和事件的详细信息的字典。
auth_password 字符串	用于SNMP身份验证的密码。
auth_type 字符串	要使用的SNMP身份验证协议类型，例如MD5或SHA。SHA - 代表安全哈希算法，是由国家安全局(NSA)开发的一套密码哈希函数，提供增强的安全性。MD5 - 指的是消息摘要算法5，这是一种完善的密码哈希函数，生成一个128位的哈希值，在SNMPv3中用于消息真实性和完整性验证。
community 字符串	用于身份验证的SNMP社区字符串，仅当snmp_version设置为V2C时才需要。
description 字符串 / 必需	SNMP目的地的描述。
mode 字符串	SNMP通信的安全模式（选项 - AUTH_PRIVACY、AUTH_NO_PRIVACY、NO_AUTH_NO_PRIVACY）。SNMP_version V3必须设置此项，且不能设置为NONE。AUTH_PRIVACY - 最安全的模式，通过身份验证验证消息来源并通过加密保护消息内容。如果选择此选项，则必须在剧本中提供auth_type、auth_password、privacy_type、privacy_password参数。AUTH_NO_PRIVACY - 此模式通过社区字符串确保SNMP消息的真实性以进行验证，但不加密数据，使其容易被拦截。如果选择此选项，则必须在剧本中提供auth_type、auth_password参数。NO_AUTH_NO_PRIVACY - 在此模式下，SNMP消息既未经身份验证也未加密，因此它是安全性最低的，因为它不需要凭据或数据保护。如果选择此选项，则不需要提供auth_type、auth_password、privacy_type、privacy_password参数。
name 字符串 / 必需	SNMP目的地的名称。
port 字符串 / 必需	SNMP服务器正在侦听的端口号。
privacy_password 字符串	用于SNMP隐私加密的密码。
privacy_type 字符串	用于SNMP隐私的加密算法，例如AES128。
server_address 字符串 / 必需	SNMP服务器的IP地址。
snmp_version 字符串	用于网络管理和监控的SNMP协议版本，可在SNMPv2c和SNMPv3之间选择。V2C - 使用社区字符串进行SNMP管理器（如Cisco Catalyst）和被管理网络设备（路由器、交换机、接入点）之间的身份验证，不加密，因为字符串以明文发送。V3 - 提供比V2C更强大的安全功能，包括身份验证、完整性和加密，使用用户名、密码和加密密钥进行安全通信。
username 字符串	SNMP身份验证所需的用户名，仅当snmp_version配置为V3时才适用。
syslog_destination 字典	包含用于配置/更新Syslog服务器以收集来自Cisco Catalyst Center的审计日志和事件的详细信息的字典。
description 字符串 / 必需	简要说明syslog目的地的用途。
name 字符串 / 必需	syslog目的地的名称。
port 整数 / 必需	syslog服务器正在侦听的端口号。它必须在1-65535范围内。如果没有提供任何端口，我们将使用514作为默认端口。
protocol 字符串 / 必需	用于发送syslog消息的协议（例如，UDP、TCP）。传输控制协议 (TCP) - 它是用于网络上设备之间可靠且有序通信的面向连接的协议。它提供错误检查、丢失数据包的重传，并确保数据按正确的顺序传送。用户数据报协议 (UDP) - 它是用于网络上设备之间发送数据报的面向无连接的协议。它提供轻量级的尽力而为的交付机制，不保证交付或排序数据包。UDP通常用于实时应用程序，例如流媒体、在线游戏和VoIP。
server_address 字符串 / 必需	Syslog服务器的主机名或IP地址。
syslog_event_notification 字典	用于在Cisco Catalyst Center中建立或修改Syslog事件订阅的配置。这允许指定Syslog事件通知参数和目标设置。
description 字符串 / 必需	简要说明syslog事件订阅通知的用途。
destination 字符串 / 必需	通过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 Flap”, “AP Reboot Crash”]）。
name 字符串 / 必需	Syslog事件订阅通知的名称。
sites 列表 / 元素=字符串	通知订阅中包含事件的站点名称列表（例如，[“Global/India”, “Global/USA”]）。
subdomains 列表 / 元素=字符串	主域中更具体的类别，用于进一步分类事件（例如，[“Wireless”, “Applications”]）。
version 字符串	事件订阅的版本标签，有助于跟踪更新或更改。
webhook_destination 字典	包含用于配置/更新REST端点以接收来自Cisco Catalyst Center平台的审计日志和事件的详细信息的字典。
description 字符串	简要说明webhook目的地的用途。
headers 列表 / 元素=字典	要包含在webhook请求中的HTTP标头列表。每个标头都表示为一个字典。在提供标头详细信息时，我们可以将其分为 - “基本、令牌和无身份验证”。基本身份验证 - 它用于确保接收服务器可以通过根据其存储检查凭据来验证请求服务器的身份。此方法很简单，但与其他方法相比安全性较低，因为凭据是编码发送的，但未加密。令牌身份验证 - 它涉及安全令牌，这些令牌通常由服务器生成。客户端必须在HTTP标头中发送此令牌才能访问资源。它比基本身份验证更安全，因为它允许服务器发出具有有限生命周期、可撤销和携带特定权限的令牌，而无需公开用户凭据。无身份验证 - 这意味着访问webhook目标不需要任何身份验证方法。此设置可用于安全由其他方式（例如网络隔离）处理或传输的数据不敏感的环境。
default_value 字符串	如果没有提供特定值，则可以使用HTTP标头的默认值。
encrypt 布尔值	指示标头的值是否应加密。对敏感数据很有用。 选项 false true
name 字符串	HTTP标头的名称。
value 字符串	分配给HTTP标头的值。
is_proxy_route 布尔值	布尔值，指示请求是否应使用代理服务器。对于代理路由，它将设置为true，对于直接连接，将设置为false。默认情况下，设置为True。 选项 false true
method 字符串	webhook发送请求时使用的HTTP方法（例如，POST、PUT）。POST - 它通常用于创建新的webhook目的地。当您在Cisco Catalyst Center中设置新的webhook时，您可以使用POST方法将必要的配置详细信息（如URL、标头、有效负载格式等）发送到服务器。PUT - 它用于更新现有的webhook目的地。如果webhook目的地已配置，并且您需要更改其任何设置（例如修改URL、调整标头或更改有效负载格式）。
name 字符串 / 必需	webhook目的地的名称。系统中webhook目的地的唯一标识符。
trust_cert 布尔值	布尔值，指示是否验证URL的SSL/TLS证书，将其设置为true将绕过证书验证。默认情况下，设置为false。 选项 false true
url 字符串 / 必需	webhook将向其发送请求的完全限定URL（例如，“https://ciscocatalyst.com”）。
webhook_event_notification 字典	包含用于在Cisco Catalyst Center中创建/更新Webhook事件订阅通知的详细信息的字典。
description 字符串 / 必需	简要说明电子邮件事件订阅通知的用途。
destination 字符串 / 必需	通过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 Flap”, “AP Reboot Crash”]）。
name 字符串 / 必需	Webhook事件订阅通知的名称。
sites 列表 / 元素=字符串	通知订阅中包含事件的站点名称列表（例如，[“Global/India”, “Global/USA”]）。
subdomains 列表 / 元素=字符串	主域中更具体的类别，用于进一步分类事件（例如，[“Wireless”, “Applications”]）。
version 字符串	事件订阅的版本标签，有助于跟踪更新或更改。
config_verify 布尔值	应用剧本配置后，设置为True以验证Cisco Catalyst Center配置。 选项 false ← (默认) true
dnac_api_task_timeout 整数	定义以秒为单位的API调用超时时间，用于检索任务详细信息。如果在此期间未收到任务详细信息，则进程将结束，并将记录超时通知。 默认值： 1200
dnac_debug 布尔值	指示是否在Cisco Catalyst Center SDK中启用调试。 选项 false ← (默认) true
dnac_host 字符串 / 必需	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)模式打开。- 在共享文件场景中，如果没有追加模式，则在每次模块执行后内容会被覆盖。- 对于共享日志文件，将append设置为False用于第一个模块（以覆盖）；对于后续模块，将append设置为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 整数	指定连续调用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: "test@cisco.com"
          recipient_email: "demo@cisco.com"
          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: "test@cisco.com"
          recipient_email: "demo123@cisco.com"
          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: "catalyst@cisco.com"
          recipient_emails: ["test@cisco.com", "demo@cisco.com"]
          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: "catalyst@cisco.com"
          recipient_emails: ["test@cisco.com", "demo@cisco.com", "update@cisco.com"]
          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)

集合链接

• 问题跟踪器
• 仓库（源代码）