cisco.dnac.swim_workflow_manager 模块 – 用于管理 Cisco Catalyst Center 中的 SWIM (软件映像管理) 操作的模块

注意

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

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

要安装它，请使用：ansible-galaxy collection install cisco.dnac。您需要更多要求才能使用此模块，请参阅 要求 了解详细信息。

要在 playbook 中使用它，请指定：cisco.dnac.swim_workflow_manager。

cisco.dnac 6.6.0 中的新增功能

概要

• 管理映像导入、分发、激活以及将映像标记为黄金的操作。

• 提供一个 API，用于通过 HTTP/FTP 从远程文件系统获取软件映像并将其上传到 Catalyst Center。 支持的文件扩展名 - bin、img、tar、smu、pie、aes、iso、ova、tar.gz、qcow2。

• 提供一个 API，用于从本地文件系统获取软件映像并将其上传到 Catalyst Center。 支持的文件扩展名 - bin、img、tar、smu、pie、aes、iso、ova、tar.gz、qcow2。

• 提供一个 API，用于从 Cisco Connection Online (CCO) 获取软件映像并将其上传到 Catalyst Center。 有关 Cisco Catalyst Center 中建议的映像，请参阅 https://software.cisco.com/download/home。 从 Cisco Catalyst 版本 2.3.7.6 开始提供 CCO 功能。

• 提供一个 API，用于将给定设备系列的映像标记或取消标记为黄金。

• 提供一个 API，用于将软件映像分发到设备。 软件映像必须先导入到 Catalyst Center，然后才能分发。

要求

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

• dnacentersdk == 2.7.3

• python >= 3.9

参数

参数	注释
config 列表 / 元素=字典 / 必需	正在管理的 SWIM 映像的详细信息列表
image_activation_details 字典	用于指定 SWIM 映像激活的目标设备的参数。 可以使用以下选项之一来标识设备： - device_serial_number - device_ip_address - device_hostname - device_mac_address - site_name（如果指定，则映像将在站点内的所有设备上激活） 必须提供这些参数中的至少一个。 如果提供“site_name”，则可以使用其他过滤器（如“device_role”、“device_family_name”和“device_series_name”）来进一步缩小站点内的设备范围。
activate_lower_image_version 布尔值	ActivateLowerImageVersion 标志。 选择 false true
device_family_name 字符串	指定设备系列的名称，如交换机和集线器等。
device_hostname 字符串	需要在其上激活映像的设备主机名
device_ip_address 字符串	需要在其上激活映像的设备 IP 地址
device_mac_address 字符串	需要在其上激活映像的设备 MAC 地址
device_role 字符串	定义设备角色，允许的值包括 ALL、UNKNOWN、ACCESS、BORDER ROUTER、DISTRIBUTION 和 CORE。
device_serial_number 字符串	需要在其上激活映像的设备序列号
device_series_name 字符串 在 cisco.dnac 6.12.0 中添加	此参数指定设备系列的名称。 它用于标识 Cisco Catalyst Center 中的特定设备系列，例如 Cisco Catalyst 9300 系列交换机。
device_upgrade_mode 字符串	它指定了应用于具有以下值的设备的升级模式 - ‘install’、‘bundle’ 和 ‘currentlyExists’。install - 此模式指示 Cisco Catalyst Center 对目标设备执行新映像的全新安装。选择此模式时，设备上的现有映像将在升级过程中被新映像完全替换。这确保了设备在升级完成后仅运行新映像版本。bundle - 此模式指示 Cisco Catalyst Center 在启动升级过程之前，将新映像与设备上的现有映像捆绑在一起。此模式通过在设备上保留现有映像，同时将新映像添加为额外的捆绑包，从而实现更高效的升级过程。升级后，设备可以运行现有映像或新的捆绑映像，具体取决于配置。currentlyExists - 此模式指示 Cisco Catalyst Center 检查目标设备是否已安装所需的映像版本。如果设备上已存在映像，则不采取任何操作，并跳过这些设备的升级过程。此模式有助于避免对已安装正确映像版本的设备进行不必要的升级，从而节省时间。
distribute_if_needed 布尔值	激活 SWIM 映像时启用 distribute_if_needed 选项。 选择 false true
image_name 字符串	SWIM 映像的名称
schedule_validate 布尔值	ScheduleValidate 查询参数。ScheduleValidate 在计划之前验证数据（可选）。 选择 false true
site_name 字符串	用于获取与此站点关联的设备详细信息。
image_distribution_details 字典	用于指定 SWIM 映像分发的目标设备的参数。可以使用以下选项之一来标识设备：- device_serial_number - device_ip_address - device_hostname - device_mac_address - site_name (如果指定，则映像将分发到站点内的所有设备) 必须提供至少一个参数。如果提供了 ‘site_name’，则可以使用其他过滤器（如 ‘device_role’、‘device_family_name’ 和 ‘device_series_name’）来进一步缩小站点内的设备范围。
device_family_name 字符串	指定设备系列的名称，如交换机和集线器等。
device_hostname 字符串	需要分发映像的设备主机名
device_ip_address 字符串	需要分发映像的设备 IP 地址
device_mac_address 字符串	需要分发映像的设备 MAC 地址
device_role 字符串	设备角色，允许的值为 ALL、UNKNOWN、ACCESS、BORDER ROUTER、DISTRIBUTION 和 CORE。ALL - 此角色通常表示网络中的所有设备，无论其具体角色或功能如何。UNKNOWN - 此角色分配给在 Cisco Catalyst Center 内尚未识别或分类其角色或功能的设备。如果平台无法根据可用信息确定设备的角色，则可能会发生这种情况。ACCESS - 此角色通常表示用作最终用户设备连接到网络的接入点的交换机或接入点。这些设备通常位于网络边缘，并为最终用户设备提供连接。BORDER ROUTER - 这些是将不同的网络域或网段连接在一起的设备。它们通常充当不同网络之间的网关，例如将企业网络连接到互联网或连接多个分支机构。DISTRIBUTION - 此角色表示在分层网络设计中充当分配交换机或路由器的功能。它们聚合来自接入交换机的流量，并将其路由到网络核心或路由到其他分配交换机。CORE - 此角色通常表示构成网络主干的高容量交换机或路由器。它们处理大量的流量，并在网络的不同部分之间提供连接，例如连接分配交换机或提供不同网段之间的互连。
device_serial_number 字符串	需要分发映像的设备序列号
device_series_name 字符串 在 cisco.dnac 6.12.0 中添加	此参数指定设备系列的名称。 它用于标识 Cisco Catalyst Center 中的特定设备系列，例如 Cisco Catalyst 9300 系列交换机。
image_name 字符串	SWIM 映像的名称
site_name 字符串	用于获取与此站点关联的设备详细信息。
import_image_details 字典	正在导入的映像的详细信息
cco_image_details 字典	与从 Cisco Connection Online (CCO) 将软件映像导入到 Catalyst Center 相关的参数。 此 API 从 CCO 获取指定的映像并将其上传到 Catalyst Center。 从 Cisco Catalyst Center 2.3.7.6 及更高版本开始支持。 有关推荐的映像，请参阅 Cisco 软件下载门户 (https://software.cisco.com/download/home)。
image_name 字典	要从 Cisco.com 导入的软件映像的名称。 这是一个强制性参数，必须提供该参数才能启动从 CCO 的下载。
local_image_details 字典	要导入的映像的本地路径的详细信息。
file_path 字符串	提供从本地系统导入映像所需的绝对文件路径 (例如“/path/to/your/file”)。接受的文件格式为 - .gz、.bin、.img、.tar、.smu、.pie、.aes、.iso、.ova、.tar_gz、.qcow2、.nfvispkg、.zip、.spa、.rpm。
is_third_party 布尔值	查询参数，用于确定映像是否来自第三方（可选）。 选择 false true
third_party_application_type 字符串	指定 ThirdPartyApplicationType 查询参数以指示第三方应用程序的类型。允许的值包括 WLC、LINUX、FIREWALL、WINDOWS、LOADBALANCER、THIRDPARTY 等（可选）。WLC (无线局域网控制器) - 它是一种网络设备，以集中方式管理和控制多个无线接入点 (AP)。LINUX - 它是一个开源操作系统，提供一整套软件包和实用程序。FIREWALL - 它是一种网络安全设备，可根据预定的安全规则监视和控制传入和传出的网络流量。它充当受信任的内部网络和不受信任的外部网络（例如互联网）之间的屏障，防止未经授权的访问。WINDOWS - 它是一个操作系统，以其图形用户界面 (GUI) 支持、与硬件和软件的广泛兼容性以及在各种应用中的广泛使用而闻名。LOADBALANCER - 它是一种网络设备或软件应用程序，用于在多个服务器或资源之间分配传入的网络流量。THIRDPARTY - 它指的是不属于核心系统的第三方映像或应用程序。NAM (网络访问管理器) - 它是一种网络管理工具或软件应用程序，可集中控制和监视网络访问策略、用户身份验证和设备合规性。WAN 优化 - 它指的是用于提高 WAN 性能和效率的技术。它包括各种优化技术，例如数据压缩、缓存、协议优化和流量优先级排序，以减少延迟、提高吞吐量并改善 WAN 连接上的用户体验。Unknown - 它指的是未指定或无法识别的应用程序类型。Router - 它是一种网络设备，可在计算机网络之间转发数据包。它们对于将多个网络连接在一起并在它们之间定向流量至关重要。
third_party_image_family 字符串	提供 ThirdPartyImageFamily 查询参数，以标识第三方映像的系列。映像系列名称，如 PALOALTO、RIVERBED、FORTINET、CHECKPOINT、SILVERPEAK 等（可选）。
third_party_vendor 字符串	包括 ThirdPartyVendor 查询参数以指定第三方的供应商。
type 字符串	指定映像导入的来源。支持的值为 ‘local’（用于本地文件导入）、‘remote’（用于远程 URL 导入）或 ‘CCO’（用于从 Cisco Connection Online 导入）。
url_details 字典	SWIM 导入的 URL 详细信息
payload list / elements=dictionary	通过 URL 进行 SWIM 导入的有效负载。
application_type 字符串	一个可选参数，用于指定应用程序的类型。允许的值包括 WLC、LINUX、FIREWALL、WINDOWS、LOADBALANCER、THIRDPARTY 等。这仅适用于第三方映像类型（可选）。WLC (无线局域网控制器) - 它是一种网络设备，以集中方式管理和控制多个无线接入点 (AP)。LINUX - 它是一个开源系统，提供完整的操作系统以及各种软件包和实用程序。FIREWALL - 它是一种网络安全设备，可根据预定的安全规则监视和控制传入和传出的网络流量。它充当受信任的内部网络和不受信任的外部网络（例如互联网）之间的屏障，防止未经授权的访问。WINDOWS - 它是一个操作系统，为各种应用程序提供 GUI 支持，并与硬件和软件具有广泛的兼容性。LOADBALANCER - 它是一种网络设备或软件应用程序，用于在多个服务器或资源之间分配传入的网络流量。THIRDPARTY - 它指的是不属于核心系统的第三方映像或应用程序。NAM (网络访问管理器) - 它是一种网络管理工具或软件应用程序，可集中控制和监视网络访问策略、用户身份验证和设备合规性。WAN 优化 - 它指的是用于提高 WAN 性能和效率的技术。它包括各种优化技术，例如数据压缩、缓存、协议优化和流量优先级排序，以减少延迟、提高吞吐量并改善 WAN 连接上的用户体验。Unknown - 它指的是未指定或无法识别的应用程序类型。Router - 它是一种网络设备，可在计算机网络之间转发数据包。它们对于将多个网络连接在一起并在它们之间定向流量至关重要。
image_family 字符串	表示映像系列的名称，仅在上传第三方映像时适用。映像系列名称，如 PALOALTO、RIVERBED、FORTINET、CHECKPOINT、SILVERPEAK 等（可选）。
is_third_party 布尔值	标志指示映像是否从第三方上传（可选）。 选择 false true
source_url list / elements=string	通过远程 URL 导入 SWIM 映像的强制参数。当使用 URL 导入映像时，此参数是必需的。(例如，http://{host}/swim/cat9k_isoxe.16.12.10s.SPA.bin, ftp://user:password@{host}/swim/cat9k_isoxe.16.12.10s.SPA.iso)
vendor 字符串	供应商的名称，仅在通过 URL 导入时适用于第三方映像类型（可选）。
schedule_at 字符串	ScheduleAt 查询参数。应该计划分发的 Epoch 时间（自 1970 年 1 月 1 日 UTC 以来的毫秒数）（可选）。
schedule_desc 字符串	ScheduleDesc 查询参数。自定义描述（可选）。
schedule_origin 字符串	ScheduleOrigin 查询参数。此调用的发起者（可选）。
tagging_details 字典	用于将映像标记或取消标记为金牌映像的详细信息
device_image_family_name 字符串	设备映像系列名称（例如 Cisco Catalyst 9300 Switch）
device_role 字符串	指定将映像标记或取消标记为金牌映像的设备角色。允许的值：- ‘ALL’：将金牌标记应用于所有设备，无论其角色如何。- ‘UNKNOWN’：标记没有指定分类的设备。- ‘ACCESS’：标记连接最终用户设备的设备（例如，接入交换机）。- ‘BORDER ROUTER’：标记链接不同网络段或域的设备。- ‘DISTRIBUTION’：标记聚合到核心流量的设备。- ‘CORE’：标记处理高容量网络流量的主干设备。行为：- 如果 ‘device_role’ 是单个字符串（例如，`”ACCESS”`），则仅将该角色标记为金牌。- 如果 ‘device_role’ 包含多个角色（例如，`”ACCESS,CORE”`），则将所有指定的角色标记为金牌。示例：- device_role: “ACCESS” 仅将 `ACCESS` 角色标记为金牌。- device_role: “ACCESS,CORE” 将 `ACCESS` 和 `CORE` 角色都标记为金牌。
image_name 字符串	要标记或取消标记为黄金版本的 SWIM 镜像的名称。
site_name 字符串	要将 SWIM 镜像标记/取消标记为黄金版本的站点名称。如果未提供，则 SWIM 镜像将映射到全局站点。
标记 布尔值	一个布尔值，用于将 SWIM 镜像标记/取消标记为黄金版本。如果为 True，则给定的镜像将被标记为黄金版本。如果为 False，则给定的镜像将被取消标记为黄金版本。 选择 false true
config_verify 布尔值	设置为 True 以在应用 playbook 配置后验证 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 布尔值	启用/禁用 playbook 执行日志记录的标志。 当为 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 整数	指定连续调用 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 字符串	模块完成后 Catalyst Center 的状态。 选择 "merged" ← (默认)
validate_response_schema 布尔值	Cisco Catalyst Center SDK 的标志，用于启用针对 JSON 架构验证请求主体。 选择 false true ← (默认)

备注

注意

• 使用的 SDK 方法有 software_image_management_swim.SoftwareImageManagementSwim.import_software_image_via_url、software_image_management_swim.SoftwareImageManagementSwim.tag_as_golden_image、software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_distribution、software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_activation。

• 使用的路径有 post /dna/intent/api/v1/image/importation/source/url、post /dna/intent/api/v1/image/importation/golden、post /dna/intent/api/v1/image/distribution、post /dna/intent/api/v1/image/activation/device。

• 在 v6.13.2 中添加了参数 ‘dnac_api_task_timeout’ 和 ‘dnac_task_poll_interval’ 选项。

• 不支持 check_mode

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

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

示例

- name: Import an image from a URL, tag it as golden and load it on device
  cisco.dnac.swim_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: True
    config:
    - import_image_details:
        type: remote
        url_details:
          payload:
          - source_url:
            - "http://10.10.10.10/stda/cat9k_iosxe.17.12.01.SPA.bin"
            is_third_party: False
      tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True
      image_distribution_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_serial_number: FJC2327U0S2
      image_activation_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        schedule_validate: False
        activate_lower_image_version: False
        distribute_if_needed: True
        device_serial_number: FJC2327U0S2

- name: Import an image from local, tag it as golden.
  cisco.dnac.swim_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: True
    config:
    - import_image_details:
        type: local
        local_image_details:
            file_path: /Users/Downloads/cat9k_iosxe.17.12.01.SPA.bin
            is_third_party: False
      tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True

- name: Import bulk images from URL
  cisco.dnac.swim_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: True
    config:
    - import_image_details:
        type: remote
        url_details:
            payload:
            - source_url:
                - "http://10.10.10.10/stda/cat9k_iosxe.17.12.01.SPA.bin"
                - "http://10.10.10.10/stda/cat9k_iosxe.17.12.02.SPA.bin"
            third_party: False

- name: Import images from CCO (cisco.com)
  cisco.dnac.swim_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: True
    config:
    - import_image_details:
        type: CCO
        cco_image_details:
            image_name: cat9k_iosxe.17.06.06a.SPA.bin

- name: Tag the given image as golden and load it on device
  cisco.dnac.swim_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: True
    config:
    - tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True

- name: Tag the specified image as golden for multiple device roles and load it into the device
  cisco.dnac.swim_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: True
    config:
    - tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS,CORE
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: True

- name: Un-tagged the given image as golden and load it on device
  cisco.dnac.swim_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: True
    config:
    - tagging_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        device_role: ACCESS
        device_image_family_name: Cisco Catalyst 9300 Switch
        site_name: Global/USA/San Francisco/BGL_18
        tagging: False

- name: Distribute the given image on devices associated to that site with specified role.
  cisco.dnac.swim_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: True
    config:
    - image_distribution_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        site_name: Global/USA/San Francisco/BGL_18
        device_role: ALL
        device_family_name: Switches and Hubs
        device_series_name: Cisco Catalyst 9300 Series Switches

- name: Activate the given image on devices associated to that site with specified role.
  cisco.dnac.swim_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: True
    config:
    - image_activation_details:
        image_name: cat9k_iosxe.17.12.01.SPA.bin
        site_name: Global/USA/San Francisco/BGL_18
        device_role: ALL
        device_family_name: Switches and Hubs
        device_series_name: Cisco Catalyst 9300 Series Switches
        scehdule_validate: False
        activate_lower_image_version: True
        distribute_if_needed: True

返回值

通用返回值在此处记录 此处，以下是此模块特有的字段

键

描述

response 字典

一个字典，其中包含 Catalyst Center Python SDK 返回的激活详细信息。 已返回: 总是 示例: "{\n  \"response\": {\n                    \"additionalStatusURL\": String,\n                    \"data\": String,\n                    \"endTime\": 0,\n                    \"id\": String,\n                    \"instanceTenantId\": String,\n                    \"isError\": bool,\n                    \"lastUpdate\": 0,\n                    \"progress\": String,\n                    \"rootId\": String,\n                    \"serviceType\": String,\n                    \"startTime\": 0,\n                    \"version\": 0\n              },\n  \"msg\": String\n}\n"

作者

• Madhan Sankaranarayanan (@madhansansel) Rishita Chowdhary (@rishitachowdhary) Abhishek Maheshwari (@abmahesh) Syed Khadeer Ahmed (@syed-khadeerahmed) Ajith Andrew J (@ajithandrewj)

集合链接

• 问题跟踪器
• 存储库（来源）