.. Document meta :orphan: .. |antsibull-internal-nbsp| unicode:: 0xA0 :trim: .. role:: ansible-attribute-support-label .. role:: ansible-attribute-support-property .. role:: ansible-attribute-support-full .. role:: ansible-attribute-support-partial .. role:: ansible-attribute-support-none .. role:: ansible-attribute-support-na .. role:: ansible-option-type .. role:: ansible-option-elements .. role:: ansible-option-required .. role:: ansible-option-versionadded .. role:: ansible-option-aliases .. role:: ansible-option-choices .. role:: ansible-option-choices-default-mark .. role:: ansible-option-default-bold .. role:: ansible-option-configuration .. role:: ansible-option-returned-bold .. role:: ansible-option-sample-bold .. Anchors .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.catalystcenter.switches_configs_intended_layer2_create module -- Resource module for Switches Configs Intended Layer2 Create ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.catalystcenter collection `_ (version 2.12.0). To install it, use: :code:`ansible-galaxy collection install cisco.catalystcenter`. You need further requirements to be able to use this module, see :ref:`Requirements ` for details. To use it in a playbook, specify: :code:`cisco.catalystcenter.switches_configs_intended_layer2_create`. .. version_added .. rst-class:: ansible-version-added New in cisco.catalystcenter 2.11.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Manage operation create of the resource Switches Configs Intended Layer2 Create. - \> This API creates configurations for an intended feature on a switch. Once all the updates to intended features are complete, they can be deployed to a device using the API /api/v1/switches/{id}/configs/intended/deploy. When the intended features are deployed, they are applied on top of the existing configurations on the device. Any existing configurations on the device which are not included in the intended features, are retained on the device. The device config learning must have enabled for the switch using the API /dna/campus/api/v1/switches/configs/deployed/enable and Error code NCCO15475 can be observed if not enabled. .. note:: This module has a corresponding :ref:`action plugin `. .. Aliases .. Requirements .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - catalystcentersdk \>= 3.2.3.0.0 - python \>= 3.12 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_debug: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **catalystcenter_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_debug` .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco Catalyst Center SDK to enable debugging. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`false` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_host: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_host: .. rst-class:: ansible-option-title **catalystcenter_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_host` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center hostname. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_password: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_password: .. rst-class:: ansible-option-title **catalystcenter_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_password` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center password to authenticate. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_api_port: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_port: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_port: .. rst-class:: ansible-option-title **catalystcenter_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_port, catalystcenter_api_port` .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center port. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`443` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_username: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_username: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-user: .. rst-class:: ansible-option-title **catalystcenter_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_username, user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The Cisco Catalyst Center username to authenticate. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"admin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_verify: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **catalystcenter_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_verify` .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable or disable SSL certificate verification. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-catalystcenter_version: .. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-dnac_version: .. rst-class:: ansible-option-title **catalystcenter_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: dnac_version` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Informs the SDK which version of Cisco Catalyst Center to use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"3.1.6.0"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig: .. rst-class:: ansible-option-title **cdpConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring CDP. Cisco Discovery Protocol (CDP) is a device discovery protocol that runs over Layer 2 on all Cisco devices and allows network management applications to discover Cisco devices that are neighbors of already known devices. A CDP-enabled device sends periodic messages to a multicast address, advertising at least one address at which it can receive SNMP messages. The advertisements also contain time-to-live, or holdtime information, which is the length of time a receiving device holds CDP information before discarding it. Each device also listens to the messages sent by other devices to learn about neighboring devices. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Network discovery and details exchange between connected Cisco devices. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items/holdtime: .. rst-class:: ansible-option-title **holdtime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Time in seconds that CDP advertisements are retained by neighbors. This setting determines how long neighbor information is kept before it is considered stale. Unconfigure Value - use 180 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items/isadvertisev2enabled: .. rst-class:: ansible-option-title **isAdvertiseV2Enabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables or disables CDP version 2 advertisement. CDP v2 provides enhanced capabilities for device discovery and information sharing between Cisco devices. Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items/iscdpenabled: .. rst-class:: ansible-option-title **isCdpEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables or disables the Cisco Discovery Protocol (CDP) globally. CDP is used for discovering and sharing information about directly connected Cisco devices. Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-cdpconfig/items/timer: .. rst-class:: ansible-option-title **timer** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between CDP advertisements. Adjusting this value changes how frequently the device sends CDP packets to its neighbors. Unconfigure Value - use 60 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig: .. rst-class:: ansible-option-title **etherchannelConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring etherchannels global config on device. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type ETHERCHANNEL is for configuring global settings and parameters that apply to all etherchannels channels across the network device. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig/items/isautoenabled: .. rst-class:: ansible-option-title **isAutoEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables automatic configuration for port-channel. When enabled, the system automatically manages port-channel settings for simplified setup and maintenance. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig/items/lacpsystempriority: .. rst-class:: ansible-option-title **lacpSystemPriority** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
System priority value for LACP. This value influences which device is selected as the LACP system during link aggregation negotiations. Unconfigure Value - use 32768 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-etherchannelconfig/items/loadbalancingmethod: .. rst-class:: ansible-option-title **loadBalancingMethod** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Load balancing method for port-channel. Select how traffic is distributed across channel members, optimizing bandwidth and redundancy. Unconfigure Value - use SRC\_MAC (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-feature: .. rst-class:: ansible-option-title **feature** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Feature path parameter. Name of the feature to configure. The API /api/v1/switches/{id}/configs/su... can be used to get the list of features supported on a device. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-id: .. rst-class:: ansible-option-title **id** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Id path parameter. Network device id of the switch. The Network device id can be identified from the GET network device API /dna/intent/api/v1/network-device response. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig: .. rst-class:: ansible-option-title **igmpSnoopingConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring IGMP Snooping. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Configuring the parameters and behaviors related to snooping entries within a network, such as tracking and managing multicast or network traffic for optimization and security purposes. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry: .. rst-class:: ansible-option-title **igmpSnoopingQuerierEntry** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
IGMP snooping querier configuration container. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type IGMP\_SNOOPING\_QUERIER\_ENTRY\_CONFIG is for configuring the behavior and parameters of an IGMP Snooping Querier that manages multicast group memberships within a network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/items/querieraddress: .. rst-class:: ansible-option-title **querierAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
IP address of the IGMP querier. This address identifies the device responsible for sending IGMP queries to maintain multicast group memberships on the network. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/items/querierversion: .. rst-class:: ansible-option-title **querierVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
IGMP version used by the querier. Select the appropriate version (2 or 3) based on your network requirements and multicast application compatibility. Unconfigure Value - use 2 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingquerierentry/items/queryinterval: .. rst-class:: ansible-option-title **queryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between IGMP queries sent by the querier. This setting determines how often the querier checks for active multicast group members, impacting multicast traffic efficiency. Unconfigure Value - use 60 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans: .. rst-class:: ansible-option-title **igmpSnoopingVlans** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
IGMP snooping VLAN configuration container. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type IGMP\_SNOOPING\_VLANS\_CONFIG is for configuring the range of VLAN IDs in which IGMP snooping is enabled for optimizing multicast traffic delivery across specific VLANs. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/isimmediateleaveenabled: .. rst-class:: ansible-option-title **isImmediateLeaveEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables immediate leave processing for IGMP snooping on VLAN. When enabled, multicast traffic is stopped immediately after a leave message, reducing unnecessary traffic and improving network efficiency. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/isquerierenabled: .. rst-class:: ansible-option-title **isQuerierEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables IGMP querier on the specified VLAN. This allows the switch to send IGMP queries within the VLAN range, maintaining multicast group memberships even if no router is present. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/mrouterinterface: .. rst-class:: ansible-option-title **mrouterInterface** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Interface designated as multicast router for IGMP snooping. Specify the interface that connects to the multicast router, ensuring proper forwarding of multicast traffic within the VLAN. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/querieraddress: .. rst-class:: ansible-option-title **querierAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
IP address of the IGMP querier for the VLAN. This address is used to identify the querier responsible for managing multicast groups in the specified VLANs. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/querierversion: .. rst-class:: ansible-option-title **querierVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
IGMP version used by the querier on the VLAN. Choose the version that matches your multicast application requirements for optimal compatibility. Unconfigure Value - use 0 to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/queryinterval: .. rst-class:: ansible-option-title **queryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between IGMP queries on the VLAN. Adjust this value to control how frequently multicast group membership is verified within the VLANs. Unconfigure Value - use 0 to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/igmpsnoopingvlans/items/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VLAN ID for IGMP snooping configuration. Specify which VLANs should have IGMP snooping enabled to optimize multicast traffic delivery and control. Derived From - The available VLAN IDs include VLAN configurations from the current profile and the device, plus any VLANs referenced in existing IGMP snooping VLAN configurations. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/isigmpsnoopingenabled: .. rst-class:: ansible-option-title **isIgmpSnoopingEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables IGMP snooping globally to optimize multicast traffic delivery. IGMP snooping listens to IGMP messages between hosts and routers to intelligently forward multicast traffic only to interested receivers, reducing unnecessary network load. Unconfigure Value - use true to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/isquerierenabled: .. rst-class:: ansible-option-title **isQuerierEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables IGMP querier functionality for snooping. When enabled, the switch can act as an IGMP querier if no router is present, ensuring multicast group membership is maintained and multicast traffic is properly managed. Unconfigure Value - use false to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-igmpsnoopingconfig/items/lastmemberqueryinterval: .. rst-class:: ansible-option-title **lastMemberQueryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in milliseconds for IGMP last member queries. This value controls how quickly the switch checks for remaining multicast group members after a leave message, helping to minimize multicast traffic interruptions. Unconfigure Value - use 1000 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig: .. rst-class:: ansible-option-title **lldpConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring LLDP. Link Layer Discovery Protocol (LLDP) is a protocol used to advertise and discover information about neighboring network devices on a local area network (LAN). LLDP allows devices to exchange information such as device capabilities, system information, and network connectivity details. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Configuration settings related to the Link Layer Discovery Protocol (LLDP) in general. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items/holdtime: .. rst-class:: ansible-option-title **holdtime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Holdtime in seconds for LLDP advertisements. This setting determines how long LLDP information is retained by neighbors before it expires. Unconfigure Value - use 120 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items/islldpenabled: .. rst-class:: ansible-option-title **isLldpEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables LLDP globally. When enabled, the device participates in LLDP for neighbor discovery and network topology information. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items/reinitializationdelay: .. rst-class:: ansible-option-title **reinitializationDelay** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Reinitialization delay in seconds for LLDP. This value controls how quickly LLDP restarts after a configuration change or reset. Unconfigure Value - use 2 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-lldpconfig/items/timer: .. rst-class:: ansible-option-title **timer** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between LLDP advertisements. Adjust this value to change how frequently the device sends LLDP packets to its neighbors. Unconfigure Value - use 30 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig: .. rst-class:: ansible-option-title **macAddressTableConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring MAC address table settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/agingtime: .. rst-class:: ansible-option-title **agingTime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Time in seconds before a MAC address ages out of the table. This value controls how long learned MAC addresses remain in the table before being removed. Unconfigure Value - use 300 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type MAC\_ADDRESS\_TABLE\_CONFIG is for configuring how MAC addresses are learned and stored within a network switch's forwarding table. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/ischangenotificationenabled: .. rst-class:: ansible-option-title **isChangeNotificationEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables notifications for MAC address table changes. When enabled, the system will alert you whenever a MAC address is added, removed, or updated in the table, helping with network monitoring and troubleshooting. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/ismacmoveenabled: .. rst-class:: ansible-option-title **isMacMoveEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables notifications for MAC address moves between interfaces. When enabled, the system will notify you if a MAC address is detected on a different port, which can indicate device movement or network issues. Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/isnotificationthresholdenabled: .. rst-class:: ansible-option-title **isNotificationThresholdEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables threshold-based notifications for MAC address table. This feature sends alerts when the number of MAC addresses reaches a specified limit, helping prevent table overflow and maintain network stability. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic: .. rst-class:: ansible-option-title **macAddressTableStatic** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
MAC Address Table VLAN Static MAC Settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The static generation of MAC address tables for network devices. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items/destinationinterface: .. rst-class:: ansible-option-title **destinationInterface** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Interface associated with the static MAC address entry. Specify the port or interface where the static MAC address is assigned, ensuring correct traffic forwarding and security enforcement. Derived From - The available interface names include GigabitEthernet and Port-channel interfaces from the device, sorted alphabetically. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items/isdropenabled: .. rst-class:: ansible-option-title **isDropEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables dropping of static MAC addresses. When enabled, traffic from static MAC addresses will be discarded, which can be used for security or traffic management purposes. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items/macaddress: .. rst-class:: ansible-option-title **macAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Static MAC address entry for the MAC address table. Enter a specific MAC address to be permanently assigned to an interface, preventing it from being learned dynamically. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablestatic/items/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VLAN ID associated with the static MAC address entry. Assign the static MAC address to a particular VLAN for precise traffic segmentation and control. Derived From - The available VLAN IDs include VLAN configurations from the current profile and the device, plus any VLANs referenced in existing MAC address table entries. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime: .. rst-class:: ansible-option-title **macAddressTableVlanAgingTime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
VLAN-specific MAC address table aging time configuration. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime/items/agingtime: .. rst-class:: ansible-option-title **agingTime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Aging-time value for specified vlan. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Config type MAC\_ADDRESS\_TABLE\_VLAN\_AGING\_TIME\_CONFIG is for configuring aging-time value for dynamic MAC addresses learned on specified VLANs. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/macaddresstablevlanagingtime/items/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VLAN Identifier. Derived From - The available VLAN IDs include VLAN configurations from the current profile and the device, plus any VLANs referenced in existing MAC address table entries. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/notificationchangehistorysize: .. rst-class:: ansible-option-title **notificationChangeHistorySize** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of history entries to keep for MAC address table change notifications. This setting controls how many past change events are stored for review, aiding in tracking and auditing MAC address movements. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/notificationchangeinterval: .. rst-class:: ansible-option-title **notificationChangeInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between MAC address table change notifications. Adjust this value to control how frequently notifications are sent, balancing timely alerts with notification volume. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/notificationthresholdinterval: .. rst-class:: ansible-option-title **notificationThresholdInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds for threshold-based MAC address notifications. Set how often the system checks and notifies if the MAC address count exceeds the defined threshold. Unconfigure Value - use 120 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-macaddresstableconfig/items/notificationthresholdlimit: .. rst-class:: ansible-option-title **notificationThresholdLimit** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Percentage threshold for MAC address table notifications. When the table reaches this percentage of its capacity, a notification is triggered to warn of potential resource exhaustion. Unconfigure Value - use 50 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig: .. rst-class:: ansible-option-title **mldSnoopingConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring MLD Snooping. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Configuring Multicast Listener Discovery (MLD) snooping settings to optimize multicast traffic handling on a network switch. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/islistenermessagesuppressionenabled: .. rst-class:: ansible-option-title **isListenerMessageSuppressionEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables suppression of listener messages for MLD snooping. When enabled, unnecessary MLD messages are suppressed to reduce network traffic. Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/ismldsnoopingenabled: .. rst-class:: ansible-option-title **isMldSnoopingEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables MLD snooping globally to optimize multicast traffic delivery. MLD snooping listens to MLD messages to intelligently forward IPv6 multicast traffic only to interested receivers. Unconfigure Value - use false to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/isquerierenabled: .. rst-class:: ansible-option-title **isQuerierEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables MLD querier globally. The switch can act as an MLD querier for all VLANs if no router is present. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/lastlistenerqueryinterval: .. rst-class:: ansible-option-title **lastListenerQueryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in milliseconds for MLD last listener queries. This controls how quickly the switch checks for remaining multicast listeners after a leave message. Unconfigure Value - use 1000 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry: .. rst-class:: ansible-option-title **mldSnoopingQuerierEntry** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
MLD snooping querier configuration container. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type MLD\_SNOOPING\_QUERIER\_CONFIG is for configuring the behavior and parameters of the Multicast Listener Discovery (MLD) snooping querier in a network environment. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/items/querieraddress: .. rst-class:: ansible-option-title **querierAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
IPv6 address of the global MLD querier. This address identifies the device responsible for sending MLD queries across the network. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/items/querierversion: .. rst-class:: ansible-option-title **querierVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
MLD version used by the global querier. Select the appropriate version for your network's multicast requirements. Unconfigure Value - use 1 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingquerierentry/items/queryinterval: .. rst-class:: ansible-option-title **queryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between global MLD queries. Set how often the querier checks for active multicast listeners network-wide. Unconfigure Value - use 125 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans: .. rst-class:: ansible-option-title **mldSnoopingVlans** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
MLD snooping VLAN configuration container. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Configuring IP address settings essential for the operation of network-based features. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/isimmediateleaveenabled: .. rst-class:: ansible-option-title **isImmediateLeaveEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables immediate leave processing for MLD snooping on VLANs. Multicast traffic is stopped immediately after a leave message, improving efficiency. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/isquerierenabled: .. rst-class:: ansible-option-title **isQuerierEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables MLD querier on the specified VLAN. The switch can send MLD queries within the VLAN to maintain multicast group memberships. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/mrouterinterface: .. rst-class:: ansible-option-title **mrouterInterface** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Interface designated as multicast router for MLD snooping. Specify the interface that connects to the multicast router for proper multicast forwarding. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/querieraddress: .. rst-class:: ansible-option-title **querierAddress** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
IPv6 address of the MLD querier for the VLAN. This address identifies the device responsible for managing multicast groups in the VLAN. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/querierversion: .. rst-class:: ansible-option-title **querierVersion** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
MLD version used by the querier on the VLAN. Choose the version that matches your multicast application requirements for compatibility. Unconfigure Value - use 0 to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/queryinterval: .. rst-class:: ansible-option-title **queryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between MLD queries on the VLAN. Adjust this value to control how frequently multicast group membership is verified. Unconfigure Value - use 0 to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-mldsnoopingconfig/items/mldsnoopingvlans/items/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VLAN ID for MLD snooping configuration. Specify which VLAN should have MLD snooping enabled to optimize IPv6 multicast traffic. Derived From - The available VLAN IDs include VLAN configurations from the current profile and the device, plus any VLANs referenced in existing MLD snooping VLAN configurations. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig: .. rst-class:: ansible-option-title **stpConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring Spanning Tree Protocol (STP), which provides path redundancy while preventing loops in the network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config within a network environment to optimize path redundancy and ensure loop prevention. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isbackbonefastenabled: .. rst-class:: ansible-option-title **isBackboneFastEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables BackboneFast feature for spanning tree protocol. When enabled, the device can detect and recover from indirect link failures more quickly, improving network convergence times. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isbpdufilterenabled: .. rst-class:: ansible-option-title **isBpduFilterEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables BPDU filtering by default for PortFast ports. BPDU filtering blocks spanning tree BPDUs on PortFast-enabled ports, preventing topology changes and protecting edge ports. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isbpduguardenabled: .. rst-class:: ansible-option-title **isBpduGuardEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables BPDU guard by default for PortFast ports. BPDU guard disables a PortFast port if a BPDU is received, protecting the network from accidental topology changes caused by misconnected devices. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isetherchannelguardenabled: .. rst-class:: ansible-option-title **isEtherChannelGuardEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables guard against EtherChannel misconfiguration in spanning tree. When enabled, the switch detects and disables ports involved in EtherChannel misconfigurations to prevent network loops and instability. Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isextendedsystemidenabled: .. rst-class:: ansible-option-title **isExtendedSystemIdEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables extended system ID for spanning tree. This feature appends the VLAN ID to the bridge priority, allowing unique identification of spanning tree instances per VLAN and improving network scalability (PVST & Rapid PVST only). Unconfigure Value - use true (default value) to revert to default settings. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isloggingenabled: .. rst-class:: ansible-option-title **isLoggingEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables logging for spanning tree events. When enabled, spanning tree protocol changes and errors are recorded in system logs for troubleshooting and auditing. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isloopguardenabled: .. rst-class:: ansible-option-title **isLoopGuardEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables loop guard by default for spanning tree. Loop guard protects against accidental loss of BPDUs, helping prevent network loops by placing affected ports into an inconsistent state. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/isuplinkfastenabled: .. rst-class:: ansible-option-title **isUplinkFastEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables UplinkFast feature for rapid transition to forwarding state. UplinkFast accelerates the recovery of connectivity after a link failure, minimizing downtime for end devices. Corresponding CLI - spanning-tree uplinkfast. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/portfastmode: .. rst-class:: ansible-option-title **portFastMode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Enables PortFast by default on all eligible ports. PortFast allows ports to transition immediately to the forwarding state, reducing startup delays for end devices. Corresponding CLI - spanning-tree portfast network default | edge default | default. Unconfigure Value - use NONE to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/stpmode: .. rst-class:: ansible-option-title **stpMode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Specifies the spanning tree mode (e.g. Rapid-pvst, mst, pvst). This setting determines the type of spanning tree protocol used, affecting convergence speed and compatibility with other devices. Corresponding CLI - spanning-tree mode mst | pvst | rapid-pvst. Unconfigure Value - use RAPID\_PVST (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/transmitholdcount: .. rst-class:: ansible-option-title **transmitHoldCount** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Number of BPDUs transmitted per second. This setting controls the rate at which bridge protocol data units are sent, helping manage spanning tree traffic and prevent congestion. Unconfigure Value - use 6 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/uplinkfastmaxupdaterate: .. rst-class:: ansible-option-title **uplinkFastMaxUpdateRate** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Maximum update rate for UplinkFast in packets per second. This limits the number of updates sent during UplinkFast operations, helping control network load during topology changes. Unconfigure Value - use 150 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig: .. rst-class:: ansible-option-title **vlanConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Per VLAN STP configuration. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's configType. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type STP\_VLAN\_CONFIG is for configuring VLAN-specific spanning tree parameters. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/forwarddelay: .. rst-class:: ansible-option-title **forwardDelay** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Set the forward delay for spanning tree on the VLAN. This value determines the time a port spends in the listening and learning states before transitioning to forwarding, affecting convergence speed. Unconfigure Value - use 15 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/hellointerval: .. rst-class:: ansible-option-title **helloInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Set the hello interval for spanning tree on the VLAN. This interval determines how often BPDUs are sent, impacting detection of topology changes and network stability. Unconfigure Value - use 2 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/maxage: .. rst-class:: ansible-option-title **maxAge** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Set the max age interval for spanning tree on the VLAN. This value determines how long BPDU information is retained before being discarded, affecting network convergence and stability. Unconfigure Value - use 20 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/priority: .. rst-class:: ansible-option-title **priority** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Set the bridge priority for spanning tree on the VLAN. Lower values increase the likelihood of a switch becoming the root bridge for the VLAN, influencing spanning tree topology. Unconfigure Value - use 32768 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-stpconfig/items/vlanconfig/items/vlan: .. rst-class:: ansible-option-title **vlan** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VLAN identifier for spanning tree configuration. Specify the VLAN to apply spanning tree settings, enabling per-VLAN control of spanning tree behavior. Derived From - The available VLAN IDs include VLAN configurations from the current profile and the device, plus any VLANs referenced in existing spanning tree VLAN configurations. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig: .. rst-class:: ansible-option-title **udldConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring UDLD. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Monitoring and managing the Unidirectional Link Detection (UDLD) protocol at a global level across network devices. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/isaggressiveenabled: .. rst-class:: ansible-option-title **isAggressiveEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables aggressive mode for UDLD. Aggressive mode rapidly disables ports with unidirectional links, improving network stability and preventing communication failures. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/isrecoveryenabled: .. rst-class:: ansible-option-title **isRecoveryEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables recovery for UDLD. When enabled, the system can automatically recover disabled ports after a UDLD error is resolved, restoring connectivity. Unconfigure Value - use false to unconfigure. Restore previously disabled ports. Supported IOS-XE versions - This property is viewable only (read-only) on Cisco switches running IOS version earlier than 17.15.1. Since IOS version 17.15.1 or later, configuration for this property is supported. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/isudldenabled: .. rst-class:: ansible-option-title **isUdldEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables UDLD globally. UDLD (Unidirectional Link Detection) monitors and disables ports with unidirectional connectivity to prevent network issues. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/messagetime: .. rst-class:: ansible-option-title **messageTime** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds between UDLD messages. This setting controls how frequently UDLD packets are sent to detect link failures. Unconfigure Value - use 15 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-udldconfig/items/recoveryinterval: .. rst-class:: ansible-option-title **recoveryInterval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Interval in seconds for UDLD recovery. This value sets how often the system attempts to recover ports disabled by UDLD errors. Supported IOS-XE versions - This property is viewable only (read-only) on Cisco switches running IOS version earlier than 17.15.1. Since IOS version 17.15.1 or later, configuration for this property is supported. Unconfigure Value - use 3000 (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-validate_response_schema: .. rst-class:: ansible-option-title **validate_response_schema** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag for Cisco Catalyst Center SDK to enable the validation of request bodies against a JSON schema. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig: .. rst-class:: ansible-option-title **vlanConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring VLANs. VLANs are switched networks that are logically segmented by function or application. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Type of network functionality under a feature. Config type VLAN\_CONFIG is for configuring VLAN lists used for segmenting network traffic within the feature scope. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items/isremotespanenabled: .. rst-class:: ansible-option-title **isRemoteSpanEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Configure as Remote SPAN VLAN. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items/name: .. rst-class:: ansible-option-title **name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the VLAN in the VLAN list. Assign a unique name for identification and management of VLANs in the list. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items/state: .. rst-class:: ansible-option-title **state** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
State of the VLAN in the VLAN list (active or suspend). Set the VLAN state to control whether it is operational or temporarily disabled. Unconfigure Value - use ACTIVE (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vlanconfig/items/vlanid: .. rst-class:: ansible-option-title **vlanId** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Unique identifier for the VLAN used to segment network traffic. VLANs allow logical separation of devices on the same physical network, improving security and traffic management. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig: .. rst-class:: ansible-option-title **vtpConfig** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
This feature is for configuring VTP. VLAN Trunking Protocol (VTP) is a Layer 2 messaging protocol that maintains VLAN configuration consistency by managing the addition, deletion, and renaming of VLANs on a network-wide basis. It can be used to make vlan configuration changes centrally on one or more devices and have those changes automatically communicated to all the other devices in the network. VTP does not work well in a situation where multiple updates to the VLANs occur simultaneously on devices in the same domain, which would result in an inconsistency in the VLAN database. With VTP, trunk ports must be configured on the device so that the device can send and receive VTP advertisements to and from other devices in the domain. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items: .. rst-class:: ansible-option-title **items** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Switches Configs Intended Layer2 Create's items. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/configtype: .. rst-class:: ansible-option-title **configType** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Switch-wide VLAN parameters and properties. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/configurationfilename: .. rst-class:: ansible-option-title **configurationFileName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Filename for VTP configuration storage. Specify the file where VTP configuration is saved for backup and recovery. Corresponding CLI - vtp filename \. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/domainname: .. rst-class:: ansible-option-title **domainName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the VLAN Trunking Protocol (VTP) domain. Assign a domain name to group switches for VLAN management and propagation. Restrictions - domain name can not be removed. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/interfacename: .. rst-class:: ansible-option-title **interfaceName** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Interface name for VTP configuration. Enter the interface to be used for VTP operations, such as trunking or VLAN propagation. Derived From - The available interface names include Loopback, VLAN, GigabitEthernet, and Port-channel interfaces from the device. Unconfigure Value - use "" to unconfigure. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/ispruningenabled: .. rst-class:: ansible-option-title **isPruningEnabled** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Enables VTP pruning to limit VLAN propagation. Pruning restricts VLAN traffic to only those switches that require it, optimizing bandwidth usage. Corresponding CLI - vtp pruning. Supported IOS-XE versions - This property is viewable only (read-only) on Cisco switches running IOS version earlier than 17.15.1. Since IOS version 17.15.1 or later, configuration for this property is supported. Restrictions - VLAN 1 and VLANs 1002 to 1005 are always pruning-ineligible; traffic from these VLANs cannot be pruned. Extended-range VLANs (VLAN IDs higher than 1005) are also pruning-ineligible. VTP pruning can be configured only on a VTP server. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/isserverprimary: .. rst-class:: ansible-option-title **isServerPrimary** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Sets the device as the primary VTP server. The primary server has authority to make VLAN changes in the VTP domain. Unconfigure Value - use false to unconfigure. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry:`false` - :ansible-option-choices-entry:`true` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/mode: .. rst-class:: ansible-option-title **mode** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Configures the device for VTP mode. Corresponding CLI - vtp mode \. Unconfigure Value - use SERVER (default value) to revert to default settings. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__parameter-vtpconfig/items/version: .. rst-class:: ansible-option-title **version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
VTP protocol version. Select the version (1, 2, or 3) to match your network requirements and compatibility. Unconfigure Value - use 1 (default value) to revert to default settings. .. raw:: html
.. Attributes .. Notes Notes ----- .. note:: - SDK Method used are wired.Wired.add\_intended\_layer2\_configurations, - Paths used are post /dna/campus/api/v1/switches/{id}/configs/intended/layer2/{feature}, - Does not support \ :literal:`check\_mode`\ - The plugin runs on the control node and does not use any ansible connection plugins, - but instead uses the embedded connection manager from Cisco CATALYST SDK - Requires Python \>= 3.10, matching the controller Python versions supported by the collection's minimum ansible-core version (see the collection README for the current ansible-core / Python compatibility range) .. Seealso See Also -------- .. seealso:: `Cisco Catalyst Center documentation for Wired AddIntendedLayer2Configurations `_ Complete reference of the AddIntendedLayer2Configurations API. .. Examples Examples -------- .. code-block:: yaml+jinja --- - name: Create cisco.catalystcenter.switches_configs_intended_layer2_create: catalystcenter_host: "{{catalystcenter_host}}" catalystcenter_username: "{{catalystcenter_username}}" catalystcenter_password: "{{catalystcenter_password}}" catalystcenter_verify: "{{catalystcenter_verify}}" catalystcenter_port: "{{catalystcenter_port}}" catalystcenter_version: "{{catalystcenter_version}}" catalystcenter_debug: "{{catalystcenter_debug}}" cdpConfig: items: - configType: string holdtime: 0 isAdvertiseV2Enabled: true isCdpEnabled: true timer: 0 etherchannelConfig: items: - configType: string isAutoEnabled: true lacpSystemPriority: 0 loadBalancingMethod: string feature: string id: string igmpSnoopingConfig: items: - configType: string igmpSnoopingQuerierEntry: configType: string items: - configType: string querierAddress: string querierVersion: 0 queryInterval: 0 igmpSnoopingVlans: configType: string items: - configType: string isImmediateLeaveEnabled: true isQuerierEnabled: true mrouterInterface: string querierAddress: string querierVersion: 0 queryInterval: 0 vlanId: 0 isIgmpSnoopingEnabled: true isQuerierEnabled: true lastMemberQueryInterval: 0 lldpConfig: items: - configType: string holdtime: 0 isLldpEnabled: true reinitializationDelay: 0 timer: 0 macAddressTableConfig: items: - agingTime: 0 configType: string isChangeNotificationEnabled: true isMacMoveEnabled: true isNotificationThresholdEnabled: true macAddressTableStatic: configType: string items: - configType: string destinationInterface: string isDropEnabled: true macAddress: string vlanId: 0 macAddressTableVlanAgingTime: configType: string items: - agingTime: 0 configType: string vlanId: 0 notificationChangeHistorySize: 0 notificationChangeInterval: 0 notificationThresholdInterval: 0 notificationThresholdLimit: 0 mldSnoopingConfig: items: - configType: string isListenerMessageSuppressionEnabled: true isMldSnoopingEnabled: true isQuerierEnabled: true lastListenerQueryInterval: 0 mldSnoopingQuerierEntry: configType: string items: - configType: string querierAddress: string querierVersion: 0 queryInterval: 0 mldSnoopingVlans: configType: string items: - configType: string isImmediateLeaveEnabled: true isQuerierEnabled: true mrouterInterface: string querierAddress: string querierVersion: 0 queryInterval: 0 vlanId: 0 stpConfig: items: - configType: string isBackboneFastEnabled: true isBpduFilterEnabled: true isBpduGuardEnabled: true isEtherChannelGuardEnabled: true isExtendedSystemIdEnabled: true isLoggingEnabled: true isLoopGuardEnabled: true isUplinkFastEnabled: true portFastMode: string stpMode: string transmitHoldCount: 0 uplinkFastMaxUpdateRate: 0 vlanConfig: configType: string items: - configType: string forwardDelay: 0 helloInterval: 0 maxAge: 0 priority: 0 vlan: 0 udldConfig: items: - configType: string isAggressiveEnabled: true isRecoveryEnabled: true isUdldEnabled: true messageTime: 0 recoveryInterval: 0 vlanConfig: items: - configType: string isRemoteSpanEnabled: true name: string state: string vlanId: 0 vtpConfig: items: - configType: string configurationFileName: string domainName: string interfaceName: string isPruningEnabled: true isServerPrimary: true mode: string version: 0 .. Facts .. Return values Return Values ------------- Common return values are documented :ref:`here `, the following are the fields unique to this module: .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Key - Description * - .. raw:: html
.. _ansible_collections.cisco.catalystcenter.switches_configs_intended_layer2_create_module__return-catalystcenter_response: .. rst-class:: ansible-option-title **catalystcenter_response** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary or list with the response returned by the Cisco Catalyst Center Python SDK .. rst-class:: ansible-option-line :ansible-option-returned-bold:`Returned:` always .. rst-class:: ansible-option-line .. rst-class:: ansible-option-sample :ansible-option-sample-bold:`Sample:` :ansible-rv-sample-value:`{"response": {"taskId": "string", "url": "string"}, "version": "string"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Bryan Vargas (@bvargasre) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors