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

注意

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

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

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

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

cisco.dnac 6.21.0 中的新增功能

概要

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

  • 管理 Fabric 设备的 L2 交接,包括添加和删除配置。

  • 管理具有 IP 传输的 Fabric 设备的 L3 交接,包括添加、更新和删除配置。

  • 管理具有 SDA 传输的 Fabric 设备的 L3 交接,包括添加、更新和删除配置。

要求

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

  • dnacentersdk >= 2.9.2

  • python >= 3.9

参数

参数

注释

config

列表 / 元素=字典 / 必需

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

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

fabric_devices

字典

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

device_config

列表 / 元素=字典 / 必需

包含其各自边界设置、L2 交接、具有 SDA 传输的 L3 交接和具有 IP 传输的 L3 交接的设备列表。

borders_settings

字典

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

将设备添加到具有 `BORDER_NODE` 角色的 Fabric 站点时,此参数是必需的。

初始配置后允许更新 `borders_settings`。

边界类型可以是第 2 层或第 3 层。

边界类型可以是第 2 层或第 3 层,根据 L2 交接或具有 IP 或 SDA 传输的 L3 交接的存在来识别。

layer2_handoff

列表 / 元素=字典

在 Fabric 设备中添加第 2 层交接。

此参数无法更新。

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

如果设置了“layer2_handoff”,则边界类型将被视为第 2 层。

external_vlan_id

整数

表示用于将流量从 Fabric 传输到外部网络的 VLAN 标识符。

在整个 Fabric 站点设置中应唯一。

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

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

interface_name

字符串

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

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

“interface_name”无法更新。

internal_vlan_id

整数

表示在 Fabric 中用于设备之间流量分割的 VLAN 标识符。

在整个 Fabric 站点设置中应唯一。

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

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

layer3_handoff_ip_transit

列表 / 元素=字典

在 Fabric 设备中添加具有 IP 传输的第 3 层交接。

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

如果设置了“layer3_handoff_ip_transit”,则边界类型将被视为第 3 层。

external_connectivity_ip_pool_name

字符串

表示分配给 SDA Fabric 和外部网络之间通信的 IP 地址范围。

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

必须在 Fabric 站点中预留 IP 池。

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

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

如果两者都设置,则 `external_connectivity_ip_pool_name` 优先。

不允许更新 IP 地址。

interface_name

字符串

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

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

设置后,此参数无法更新。

local_ip_address

字符串

分配给 Fabric 内设备接口的 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

字符串

分配给 Fabric 内设备接口的 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

字符串

位于 Fabric 网络外部的设备的 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

字符串

位于 Fabric 网络外部的设备的 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 Fabric 或网络的网络。

对于具有 IP 传输的 L3 交接中的所有操作都是必需的。

初始配置后无法更新`transit_network_name`。

virtual_network_name

字符串

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

使用IP转发的三层切换功能,所有操作都需要`virtual_network_name`或`vlan_id`。

vlan_id

整数

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

在整个 Fabric 站点设置中应唯一。

`vlan_id`的范围是1到4094,但不包括1、1002-1005、2046和4094。

使用IP转发的三层切换功能,所有操作都需要`virtual_network_name`或`vlan_id`。

设置后,此参数无法更新。

layer3_handoff_sda_transit

字典

在Fabric设备中添加使用SDA转发的三层切换功能。

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

如果设置了`layer3_handoff_sda_transit`,则边界类型将被视为三层。

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`的值越低,优先级越高。

具有相同亲和性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 Fabric 或网络的网络。

使用SDA转发的三层切换功能,所有操作都需要此参数。

`transit_network_name`无法更新。

layer3_settings

列表 / 元素=字典

配置具有三层边界类型的设备。

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无线局域网控制器和Fabric无线接入点。

config_verify

布尔值

应用playbook配置后,设置为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

布尔值

启用/禁用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

字符串

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

选项

  • "merged" ← (默认)

  • 已删除

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)