cisco.dnac.sda_fabric_devices_workflow_manager 模块 – 在 Cisco Catalyst Center 中管理 SDA 结构设备。

注意

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

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

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

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

cisco.dnac 6.21.0 中的新增功能

概要

  • 对 SDA 结构设备执行操作,包括添加、更新和删除结构设备。

  • 管理结构设备的 L2 切换,包括添加和删除配置。

  • 管理具有 IP 传输的结构设备的 L3 切换,包括添加、更新和删除配置。

  • 管理具有 SDA 传输的结构设备的 L3 切换,包括添加、更新和删除配置。

要求

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

  • dnacentersdk >= 2.9.2

  • python >= 3.9

参数

参数

注释

config

列表 / 元素=字典 / 必需

与结构站点关联的 SDA 结构设备配置列表。

列表中的每个条目都表示结构站点内设备的配置。

fabric_devices

字典

与结构站点关联的 SDA 结构设备的配置详细信息。

device_config

列表 / 元素=字典 / 必需

具有各自边界设置、L2 切换、带有 SDA 传输的 L3 切换和带有 IP 传输的 L3 切换的设备列表。

borders_settings

字典

仅当“device_roles”包含 BORDER_NODE 时有效。

当将设备添加到具有“BORDER_NODE”角色的结构站点时,此参数是必需的。

允许在初始配置后更新“borders_settings”。

边界类型可以是 Layer2 或 Layer3。

边界类型可以是 Layer2 或 Layer3,根据是否存在带有 IP 或 SDA 传输的 L2 切换或 L3 切换来识别。

layer2_handoff

列表 / 元素=字典

在结构设备中添加 2 层切换。

此参数无法更新。

在第 2 层(数据链路层)传输设备的数据流量时配置。

如果设置了“layer2_handoff”,则边界类型将视为 Layer2。

external_vlan_id

整数

表示用于将流量从结构出口到外部网络的 VLAN 标识符。

在整个结构站点设置中应该是唯一的。

此参数对于“layer2_handoff”中的所有操作都是必需的。

“external_vlan_id”的范围可以是 1 到 4094,不包括 1、1002-1005、2046 和 4094。

interface_name

字符串

指的是边界设备中的特定网络接口。

此参数对于 L2 切换中的所有操作都是必需的。

“interface_name”无法更新。

internal_vlan_id

整数

表示结构内用于设备之间流量分段的 VLAN 标识符。

在整个结构站点设置中应该是唯一的。

此参数对于 layer2_handoff 中的所有操作都是必需的。

“internal_vlan_id”的范围可以是 1 到 4094,不包括 1、1002-1005、2046 和 4094。

layer3_handoff_ip_transit

列表 / 元素=字典

在结构设备中添加具有 IP 传输的 3 层切换。

当 IP 流量从 SDA 结构路由到外部网络时配置。

如果设置了“layer3_handoff_ip_transit”,则边界类型将视为 Layer3。

external_connectivity_ip_pool_name

字符串

表示分配用于 SDA 结构和外部网络之间通信的 IP 地址范围。

此参数对于添加具有 IP 传输的 L3 切换是必需的。

IP 池必须在结构站点中保留。

如果指定了“external_connectivity_ip_pool_name”,则无需设置本地地址和远程地址。

指定“external_connectivity_ip_pool_name”将自动配置本地地址和远程地址。

如果两者都设置了,则“external_connectivity_ip_pool_name”优先。

不允许更新 IP 地址。

interface_name

字符串

指的是边界设备中的特定网络接口。

此参数对于具有 IP 传输的 L3 切换中的所有操作都是必需的。

设置后无法更新此参数。

local_ip_address

字符串

分配给结构内设备接口的 IP 地址。

“local_ip_address”用于 IPv4。

“local_ip_address”和“remote_ip_address”都必须在同一子网内。

本地地址和远程地址或“external_connectivity_ip_pool_name”是必需的。

如果提供了带有“external_connectivity_ip_pool_name”的本地地址和远程地址,则“external_connectivity_ip_pool_name”优先。

local_ipv6_address

字符串

分配给结构内设备接口的 IP 地址。

local_ipv6_address 用于 IPv6。

“local_ipv6_address”和“remote_ipv6_address”都必须在同一子网内。

如果提供了“remote_ipv6_address”,则需要“local_ipv6_address”。

如果提供了带有“external_connectivity_ip_pool_name”的本地地址和远程地址,则“external_connectivity_ip_pool_name”优先。

remote_ip_address

字符串

位于结构网络外部的设备的 IP 地址,通常用于 BGP 对等。

“remote_ip_address”用于 IPv4。

“local_ip_address”和“remote_ip_address”都必须在同一子网内。

本地地址和远程地址或“external_connectivity_ip_pool_name”是必需的。

如果提供了带有“external_connectivity_ip_pool_name”的本地地址和远程地址,则“external_connectivity_ip_pool_name”优先。

remote_ipv6_address

字符串

位于结构网络外部的设备的 IP 地址,通常用于 BGP 对等。

“remote_ipv6_address”用于 IPv6。

“local_ipv6_address”和“remote_ipv6_address”都必须在同一子网内。

如果提供了“local_ipv6_address”,则需要“remote_ipv6_address”。

如果提供了带有“external_connectivity_ip_pool_name”的本地地址和远程地址,则“external_connectivity_ip_pool_name”优先。

tcp_mss_adjustment

整数

允许修改 TCP 数据包中的最大段大小。

“tcp_mss_adjustment”可以设置为 500 到 1440。

此参数可以在初始设置后更新。

transit_network_name

字符串

连接多个 SDA 结构或网络的网络。

对于具有 IP 传输的 L3 切换中的所有操作,这是必需的。

初始配置后无法更新“transit_network_name”。

virtual_network_name

字符串

指的是网络的逻辑分段,将设备分组到隔离的虚拟网络中。

对于具有 IP 传输的 L3 切换中的所有操作,需要“virtual_network_name”或“vlan_id”。

vlan_id

整数

分配给虚拟局域网 (VLAN) 的唯一标识符。

在整个结构站点设置中应该是唯一的。

“vlan_id”的范围可以是 1 到 4094,不包括 1、1002-1005、2046 和 4094。

对于具有 IP 传输的 L3 切换中的所有操作,需要“virtual_network_name”或“vlan_id”。

设置后无法更新此参数。

layer3_handoff_sda_transit

字典

在结构设备中添加具有 SDA 传输的 3 层切换。

当路由流量从 SDA 结构路由到外部网络时配置。

如果设置了“layer3_handoff_sda_transit”,则边界类型将视为 Layer3。

affinity_id_decider

整数

如果“affinity_id_prime”值相同,则使用“affinity_id_decider”值作为决胜器。

‘affinity_id_decider’ 的相对值越低,优先级越高。

‘affinity_id_decider’ 的取值范围为 0 到 2147483647。

‘affinity_id_decider’ 可以更新。

affinity_id_prime

整数

它取代边界优先级来确定边界节点的偏好。

‘affinity_id_prime’ 的相对值越低,优先级越高。

具有相同 affinity ID 的资源将被类似对待,而 affinity_id_decider 决定优先级。

‘affinity_id_prime’ 的取值范围为 0 到 2147483647。

‘affinity_id_prime’ 可以更新。

connected_to_internet

布尔值

设置为 true 以允许关联站点通过 SDA 向其他站点提供互联网访问。

默认值为 false。

此参数可以更新。

选项

  • false ← (默认)

  • true

is_multicast_over_transit_enabled

布尔值

设置为 true 以配置通过连接到 SDA 中转的多个站点的本机组播。

默认值为 false。

此参数可以更新。

选项

  • false ← (默认)

  • true

transit_network_name

字符串

连接多个 SDA 结构或网络的网络。

此参数对于使用 SDA 中转的 L3 切换的所有操作都是必需的。

transit_network_name 不可更新。

layer3_settings

列表 / 元素=字典

使用 Layer3 边界类型配置设备。

border_priority

整数

当存在多个边界节点时,设置此边界节点的偏好级别。

优先级较高的节点优先用于将流量路由到外部网络。

可接受的范围为 1 到 9。如果未设置,则默认值为 10。

此参数可以更新。

默认值: 10

import_external_routes

布尔值

确定是否将来自外部网络的路由导入到 Fabric 中。

通过限制路由使用为内部路由来增强安全性。

‘import_external_routes’ 不可更新。

选项

  • false

  • true ← (默认)

is_default_exit

布尔值

指示此边界节点是否充当流出虚拟网络的流量的默认网关。

`is_default_exit` 不可更新。

选项

  • false

  • true ← (默认)

local_autonomous_system_number

字符串

标识 BGP 路由中的本地自治系统。

当添加具有 `BORDER_NODE` 角色的设备时,此参数是必需的。

一旦设置,`local_autonomous_system_number` 就不可更新。

可接受的范围为 1 到 4,294,967,295。

也允许使用点分表示法(1.0 到 65535.65535)。例如,65534.65535。

prepend_autonomous_system_count

整数

通过 BGP 通告路由时,人为地增加 AS 路径长度。

它使路由对外部对等设备不那么有吸引力。

可接受的范围为 1 到 10。如果未设置,则默认值为 0。

此参数可以更新。

默认值: 0

delete_fabric_device

布尔值

仅当状态为 deleted 时有效。

设置为 true 以从 Fabric 站点删除设备,或设置为 false 以保留设备。

选项

  • false

  • true

device_ip

字符串 / 必需

要添加到 Fabric 站点的设备的 IP 地址。

对于 fabric_devices 下的所有操作,此参数是强制性的。

必须先将设备配置到站点,然后才能进行配置。

device_roles

列表 / 元素=字符串

指定设备在 Fabric 站点中的角色。

将设备添加到 Fabric 站点时,此参数是必需的。

设备角色一旦分配就无法更新。

至少一个设备必须是 CONTROL_PLANE_NODE 才能将角色分配给其他设备。

可用角色,- CONTROL_PLANE_NODE - 使用 LISP 管理端点 IP 地址到其在网络中的位置的映射,从而实现移动性。- EDGE_NODE - 将端点连接到 SDA 网络,处理策略实施、分段以及与控制平面的通信。- BORDER_NODE - 充当 Fabric 和外部网络之间的网关,管理进入或退出 SDA 环境的流量。- WIRELESS_CONTROLLER_NODE - 管理和控制网络中的无线接入点和设备。

对于 ‘WIRELESS_CONTROLLER_NODE’,将在 2.3.7.6 SDK 中添加对配置状态的检查。

选项

  • "CONTROL_PLANE_NODE"

  • "EDGE_NODE"

  • "BORDER_NODE"

  • "WIRELESS_CONTROLLER_NODE"

route_distribution_protocol

列表 / 元素=字符串

指定控制平面设备的路由分发协议。

路由分发协议管理网络段之间的路由信息。

可用协议,- LISP_BGP - 位置/ID 分离协议,具有用于分发路由信息的发布-订阅机制。- LISP_PUB_SUB - 具有 BGP 的位置/ID 分离协议,其中 BGP 用作控制平面以在 LISP 网络中通告和管理路由信息。

选项

  • "LISP_BGP" ← (默认)

  • "LISP_PUB_SUB"

默认值: ["LISP_BGP"]

fabric_name

字符串 / 必需

SDA Fabric 站点的名称。

对于 fabric_devices 下的所有操作,此参数是强制性的。

必须先创建 Fabric 站点,然后才能配置设备。

Fabric 站点由以 SD-Access Fabric 角色运行的网络设备组成。

Fabric 站点由 SD-Access Fabric 角色中的网络设备组成,包括边界节点、控制平面节点和边缘节点。

Fabric 站点还可能包括 Fabric 无线 LAN 控制器和 Fabric 无线接入点。

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) 模式打开。- 在共享文件场景中,如果没有追加模式,则每次模块执行后都会覆盖内容。- 对于共享日志文件,请将追加设置为 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

字符串

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

选项

  • "merged" ← (默认)

  • "deleted"

validate_response_schema

布尔值

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

选项

  • false

  • true ← (默认)

注释

注意

  • 使用的 SDK 方法有 site_design.SiteDesign.get_sites、network_settings.NetworkSettings.get_reserve_ip_subpool、devices.Devices.get_device_list、sda.Sda.get_transit_networks、sda.Sda.get_layer3_virtual_networks、sda.Sda.get_fabric_sites、sda.Sda.get_fabric_zones、sda.Sda.get_provisioned_devices、sda.Sda.get_fabric_devices_layer2_handoffs、sda.Sda.get_fabric_devices_layer3_handoffs_with_sda_transit、sda.Sda.get_fabric_devices_layer3_handoffs_with_ip_transit、sda.Sda.get_fabric_devices、sda.Sda.add_fabric_devices、sda.Sda.add_control_plane_device、sda.Sda.add_fabric_devices_layer2_handoffs、sda.Sda.add_fabric_devices_layer3_handoffs_with_sda_transit、sda.Sda.add_fabric_devices_layer3_handoffs_with_ip_transit、sda.Sda.update_fabric_devices、sda.Sda.update_fabric_devices_layer3_handoffs_with_sda_transit、sda.Sda.update_fabric_devices_layer3_handoffs_with_ip_transit、sda.Sda.delete_fabric_device_layer2_handoff_by_id、sda.Sda.delete_fabric_device_by_id、sda.Sda.delete_fabric_device_layer3_handoffs_with_sda_transit、sda.Sda.delete_fabric_device_layer3_handoff_with_ip_transit_by_id、task.Task.get_tasks_by_id、task.Task.get_task_details_by_id,

  • 使用的路径有 get /dna/intent/api/v1/sites get /dna/intent/api/v1/reserve-ip-subpool get /dna/intent/api/v1/network-device get /dna/intent/api/v1/sda/transitNetworks get /dna/intent/api/v1/sda/layer3VirtualNetworks get /dna/intent/api/v1/sda/fabricSites get /dna/intent/api/v1/sda/fabricZones get /dna/intent/api/v1/sda/provisionDevices get /dna/intent/api/v1/sda/fabricDevices/layer2Handoffs get /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits get /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits get /dna/intent/api/v1/sda/fabricDevices post /dna/intent/api/v1/sda/fabricDevices post /dna/intent/api/v1/business/sda/control-plane-device post /dna/intent/api/v1/sda/fabricDevices/layer2Handoffs post /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits post /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits put /dna/intent/api/v1/sda/fabricDevices put /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits put /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits delete /dna/intent/api/v1/sda/fabricDevices/${id} delete /dna/intent/api/v1/sda/fabricDevices/layer2Handoffs/${id} delete /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/sdaTransits delete /dna/intent/api/v1/sda/fabricDevices/layer3Handoffs/ipTransits/${id} get /dna/intent/api/v1/tasks/${id} get /dna/intent/api/v1/tasks/${id}/detail

  • 不支持 check_mode

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

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

示例

- name: Create SDA fabric device with device role as CONTROL_PLANE_NODE
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE]
          route_distribution_protocol: LISP_PUB_SUB

- name: Create SDA fabric device with device role as CONTROL_PLANE_NODE, EDGE_NODE
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, EDGE_NODE]

- name: Create SDA fabric device with device role as CONTROL_PLANE_NODE, EDGE_NODE, BORDER_NODE
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, EDGE_NODE, BORDER_NODE]
          borders_settings:
            layer3_settings:
              local_autonomous_system_number: 1234
              is_default_exit: true
              import_external_routes: true
              border_priority: 1
              prepend_autonomous_system_count: 1

- name: Update the SDA fabric device with the device roles with BORDER_NODE and add L2 Handoff
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_settings:
              local_autonomous_system_number: 1234
              is_default_exit: true
              import_external_routes: true
              border_priority: 2
              prepend_autonomous_system_count: 2
            layer2_handoff:
            - interface_name: FortyGigabitEthernet1/1/1
              internal_vlan_id: 550
              external_vlan_id: 551


- name: Add the L3 Handoff with SDA Transit to the SDA fabric device
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_handoff_sda_transit:
              transit_network_name: SDA_PUB_SUB_TRANSIT
              affinity_id_prime: 1
              affinity_id_decider: 1
              connected_to_internet: true
              is_multicast_over_transit_enabled: false

- name: Add L3 Handoff with IP Transit to the SDA fabric device with external_connectivity_ip_pool_name
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_handoff_ip_transit:
            - transit_network_name: IP_TRANSIT_1
              interface_name: FortyGigabitEthernet1/1/1
              external_connectivity_ip_pool_name: Reserved_sda_test_1
              virtual_network_name: L3VN1
              vlan_id: 440
              tcp_mss_adjustment: 2

- name: Add L3 Handoff with IP Transit to the SDA fabric device with local and remote network
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_handoff_ip_transit:
            - transit_network_name: IP_TRANSIT_1
              interface_name: FortyGigabitEthernet1/1/1
              virtual_network_name: L3VN1
              vlan_id: 440
              tcp_mss_adjustment: 510
              local_ip_address: 10.0.0.1/24
              remote_ip_address: 10.0.0.2/24
              local_ipv6_address: 2009:db8::1/64
              remote_ipv6_address: 2009:db8::2/64

- name: Update the border settings of the SDA Devices
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_settings:
              local_autonomous_system_number: 1234
              is_default_exit: false
              import_external_routes: false
              border_priority: 1
              prepend_autonomous_system_count: 3

- name: Update the L3 Handoffs with SDA Transit and IP Transit.
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: merged
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          device_roles: [CONTROL_PLANE_NODE, BORDER_NODE]
          borders_settings:
            layer3_handoff_sda_transit:
              transit_network_name: SDA_PUB_SUB_TRANSIT
              affinity_id_prime: 2
              affinity_id_decider: 2
              connected_to_internet: false
              is_multicast_over_transit_enabled: true

            layer3_handoff_ip_transit:
            - transit_network_name: IP_TRANSIT_1
              interface_name: FortyGigabitEthernet1/1/1
              virtual_network_name: L3VN1
              vlan_id: 440
              tcp_mss_adjustment: 511
              local_ip_address: 10.0.0.1/24
              remote_ip_address: 10.0.0.2/24
              local_ipv6_address: 2009:db8::1/64
              remote_ipv6_address: 2009:db8::2/64

- name: Delete the L2 Handoff
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: deleted
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          borders_settings:
            layer2_handoff:
            - interface_name: FortyGigabitEthernet1/1/1
              internal_vlan_id: 550

- name: Delete the L3 Handoff with SDA Transit
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: deleted
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          borders_settings:
            layer3_handoff_sda_transit:
              transit_network_name: SDA_PUB_SUB_TRANSIT

- name: Delete the L3 Handoff with IP Transit
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: deleted
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          borders_settings:
            layer3_handoff_ip_transit:
            - transit_network_name: IP_TRANSIT_1
              interface_name: FortyGigabitEthernet1/1/1
              virtual_network_name: L3VN1

- name: Delete the device along with L2 Handoff and L3 Handoff
  cisco.dnac.sda_fabric_devices_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: True
    dnac_log_level: "{{ dnac_log_level }}"
    state: deleted
    config_verify: True
    config:
    - fabric_devices:
        fabric_name: Global/USA/SAN-JOSE
        device_config:
        - device_ip: 10.0.0.1
          delete_fabric_device: true
          borders_settings:
            layer3_handoff_ip_transit:
            - transit_network_name: IP_TRANSIT_1
              interface_name: FortyGigabitEthernet1/1/1
              virtual_network_name: L3VN1

            layer3_handoff_sda_transit:
              transit_network_name: SDA_PUB_SUB_TRANSIT

            layer2_handoff:
            - interface_name: FortyGigabitEthernet1/1/1
              internal_vlan_id: 550

返回值

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

描述

response_1

字典

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

返回: 始终

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

response_10

字典

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

返回: 始终

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

response_11

字典

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

返回: 始终

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

response_12

字典

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

返回: 始终

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

response_13

字典

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

返回: 始终

示例: {"response": {"endTime": "integer", "id": "string", "lastUpdate": "integer", "resultLocation": "string", "startTime": "integer", "status": "string", "version": "integer"}, "version": "string"}

response_2

字典

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

返回: 始终

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

response_3

字典

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

返回: 始终

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

response_4

字典

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

返回: 始终

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

response_5

字典

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

返回: 始终

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

response_6

字典

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

返回: 始终

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

response_7

字典

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

返回: 始终

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

response_8

字典

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

返回: 始终

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

response_9

字典

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

返回: 始终

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

作者

  • Muthu Rakesh (@MUTHU-RAKESH-27) Madhan Sankaranarayanan (@madhansansel)