.. 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.dnac.application_policy_workflow_manager_module: .. Anchors: short name for ansible.builtin .. Anchors: aliases .. Title cisco.dnac.application_policy_workflow_manager module -- Resource module for managing queuing profiles, applications, application sets and application policies for wired and wireless in Cisco Catalyst Center. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ .. Collection note .. note:: This module is part of the `cisco.dnac collection `_ (version 6.46.0). To install it, use: :code:`ansible-galaxy collection install cisco.dnac`. 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.dnac.application_policy_workflow_manager`. .. version_added .. rst-class:: ansible-version-added New in cisco.dnac 6.31.0 .. contents:: :local: :depth: 1 .. Deprecated Synopsis -------- .. Description - Provides functionality to create, update, and delete applications in Cisco Catalyst Center. - Provides functionality to create, update, and delete application policies in Cisco Catalyst Center. - Provides functionality to create, update, and delete application queuing profiles in Cisco Catalyst Center. - Supports managing queuing profiles and application policies for traffic classification and prioritization. .. Aliases .. Requirements .. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module_requirements: Requirements ------------ The below requirements are needed on the host that executes this module. - dnacentersdk \>= 2.9.3 - python \>= 3.9.19 .. Options Parameters ---------- .. rst-class:: ansible-option-table .. list-table:: :width: 100% :widths: auto :header-rows: 1 * - Parameter - Comments * - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config: .. rst-class:: ansible-option-title **config** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
A list of dictionaries containing application queuing profile details. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy: .. rst-class:: ansible-option-title **application_policy** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Defines how an application's traffic is managed and prioritized within a network. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/application_queuing_profile_name: .. rst-class:: ansible-option-title **application_queuing_profile_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Defines rules for traffic management by prioritizing network traffic within the application policy. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/clause: .. rst-class:: ansible-option-title **clause** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Defines specific rules or conditions under which an application set is added to the application policy. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/clause/clause_type: .. rst-class:: ansible-option-title **clause_type** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
- Specifies the type of clause for the application policy. - Permissible values: - "BUSINESS\_RELEVANCE": Defines the importance of the application to business operations, affecting its priority and handling in the network policy. - "APPLICATION\_POLICY\_KNOBS": Configurable settings that manage the application's network behavior, such as traffic prioritization and resource allocation. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/clause/relevance_details: .. rst-class:: ansible-option-title **relevance_details** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Details about how relevant the application is to business operations. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/clause/relevance_details/application_set_name: .. rst-class:: ansible-option-title **application_set_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
Include all the application sets for which the application policy has to be created .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/clause/relevance_details/relevance: .. rst-class:: ansible-option-title **relevance** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
- Specifies whether the application set is relevant to the application policy. - Permissible values: - "BUSINESS\_RELEVANT": The application is critical for business functions. - "BUSINESS\_IRRELEVANT": The application is not essential for business operations. - "DEFAULT": A default setting when no specific relevance is assigned. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/device_type: .. rst-class:: ansible-option-title **device_type** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Indicates whether the device is wired or wireless. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/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 application policy .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/policy_status: .. rst-class:: ansible-option-title **policy_status** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
- Represents the current status of the application policy. - Helps track whether the policy is active, deleted, or restored. - Permissible values: - "NONE": The policy is active and in its original, operational state. - "DELETED": The policy has been removed and is no longer active. - "RESTORED": The policy has been reactivated after being deleted. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/site_names: .. rst-class:: ansible-option-title **site_names** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=string` .. raw:: html
- .. raw:: html
The site or area within the network where the policy should be enforced. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/application_policy/ssid_name: .. rst-class:: ansible-option-title **ssid_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Specifies the SSID name for wireless devices. Required if device\_type is set to 'wireless'. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile: .. rst-class:: ansible-option-title **queuing_profile** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Defines queuing profile settings for application traffic shaping and bandwidth allocation. Each profile specifies whether bandwidth allocation is uniform across all interface speeds or customized per speed. Changing the value of 'is\_common\_between\_all\_interface\_speeds' (from 'true' to 'false' or vice versa) is not supported during updates. To switch between common and per-speed bandwidth settings, create a new queuing profile instead of updating the existing one. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings: .. rst-class:: ansible-option-title **bandwidth_settings** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
Specifies bandwidth allocation details. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings: .. rst-class:: ansible-option-title **interface_speed_settings** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary` .. raw:: html
- .. raw:: html
Defines bandwidth allocation for different types of network traffic based on interface speed. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages: .. rst-class:: ansible-option-title **bandwidth_percentages** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
- Defines the percentage of bandwidth assigned to various traffic categories. - The sum of all category allocations must not exceed 100%. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/best_effort: .. rst-class:: ansible-option-title **best_effort** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for non-priority, general-purpose traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/broadcast_video: .. rst-class:: ansible-option-title **broadcast_video** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for one-to-many video distribution. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/bulk_data: .. rst-class:: ansible-option-title **bulk_data** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for large-volume, non-time-sensitive data transfers. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/multimedia_conferencing: .. rst-class:: ansible-option-title **multimedia_conferencing** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for combined audio-video conferencing traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/multimedia_streaming: .. rst-class:: ansible-option-title **multimedia_streaming** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for real-time audio and video streaming. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/network_control: .. rst-class:: ansible-option-title **network_control** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for traffic related to network management and operation. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/ops_admin_mgmt: .. rst-class:: ansible-option-title **ops_admin_mgmt** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for operations and administration management traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/real_time_interactive: .. rst-class:: ansible-option-title **real_time_interactive** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for low-latency applications requiring immediate response. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/scavenger: .. rst-class:: ansible-option-title **scavenger** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for low-priority traffic that can be delayed or dropped. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/signaling: .. rst-class:: ansible-option-title **signaling** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for network control messages managing communication sessions. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/transactional_data: .. rst-class:: ansible-option-title **transactional_data** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth allocated to transactional data traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/bandwidth_percentages/voip_telephony: .. rst-class:: ansible-option-title **voip_telephony** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Bandwidth for voice and video calls over IP. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/interface_speed_settings/interface_speed: .. rst-class:: ansible-option-title **interface_speed** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
- Specifies the data transfer rate of a network interface. - Permissible values: - "ALL": Applies to all interface speeds. - "HUNDRED\_GBPS": 100 Gbps. - "TEN\_GBPS": 10 Gbps. - "ONE\_GBPS": 1 Gbps. - "HUNDRED\_MBPS": 100 Mbps. - "TEN\_MBPS": 10 Mbps. - "ONE\_MBPS": 1 Mbps. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/bandwidth_settings/is_common_between_all_interface_speeds: .. rst-class:: ansible-option-title **is_common_between_all_interface_speeds** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Indicates whether bandwidth settings apply uniformly across all interface speeds. .. 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.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings: .. rst-class:: ansible-option-title **dscp_settings** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
- Defines the DSCP (Differentiated Services Code Point) values assigned to different traffic categories. - Each DSCP value must be in the range of 0 to 63. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/best_effort: .. rst-class:: ansible-option-title **best_effort** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for best-effort traffic, which does not require specific quality or priority guarantees. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/broadcast_video: .. rst-class:: ansible-option-title **broadcast_video** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for broadcast video traffic, typically distributed in a one-to-many model. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/bulk_data: .. rst-class:: ansible-option-title **bulk_data** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for large-volume data transfers that can tolerate delays or interruptions. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/multimedia_conferencing: .. rst-class:: ansible-option-title **multimedia_conferencing** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for multimedia conferencing traffic, including both audio and video communication. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/multimedia_streaming: .. rst-class:: ansible-option-title **multimedia_streaming** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for real-time audio and video streaming traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/network_control: .. rst-class:: ansible-option-title **network_control** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for network control traffic related to management and operation. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/ops_admin_mgmt: .. rst-class:: ansible-option-title **ops_admin_mgmt** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for operations, administration, and management traffic. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/real_time_interactive: .. rst-class:: ansible-option-title **real_time_interactive** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for interactive applications requiring low latency and immediate responsiveness. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/scavenger: .. rst-class:: ansible-option-title **scavenger** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for low-priority traffic that can be delayed or dropped in case of congestion. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/signaling: .. rst-class:: ansible-option-title **signaling** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for signaling traffic used to establish, manage, and terminate communication sessions. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/transactional_data: .. rst-class:: ansible-option-title **transactional_data** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for transactional data traffic, involving data exchanges between systems. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/dscp_settings/voip_telephony: .. rst-class:: ansible-option-title **voip_telephony** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
DSCP value for voice and video calls transmitted over IP networks. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/new_profile_description: .. rst-class:: ansible-option-title **new_profile_description** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
New description of the queuing profile. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/new_profile_name: .. rst-class:: ansible-option-title **new_profile_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
New name for the queuing profile (used for updates). .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/profile_description: .. rst-class:: ansible-option-title **profile_description** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Description of the queuing profile. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config/queuing_profile/profile_name: .. rst-class:: ansible-option-title **profile_name** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Name of the queuing profile. Required for create, update, and delete operations. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-config_verify: .. rst-class:: ansible-option-title **config_verify** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Set to True to verify the Cisco Catalyst Center after applying the playbook config. .. 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.dnac.application_policy_workflow_manager_module__parameter-dnac_api_task_timeout: .. rst-class:: ansible-option-title **dnac_api_task_timeout** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Defines the timeout in seconds for API calls to retrieve task details. If the task details are not received within this period, the process will end, and a timeout notification will be logged. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`1200` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_debug: .. rst-class:: ansible-option-title **dnac_debug** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Indicates whether debugging is enabled in the Cisco Catalyst Center SDK. .. 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.dnac.application_policy_workflow_manager_module__parameter-dnac_host: .. rst-class:: ansible-option-title **dnac_host** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` / :ansible-option-required:`required` .. raw:: html
- .. raw:: html
The hostname of the Cisco Catalyst Center. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_log: .. rst-class:: ansible-option-title **dnac_log** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Flag to enable/disable playbook execution logging. When true and dnac\_log\_file\_path is provided, - Create the log file at the execution location with the specified name. When true and dnac\_log\_file\_path is not provided, - Create the log file at the execution location with the name 'dnac.log'. When false, - Logging is disabled. If the log file doesn't exist, - It is created in append or write mode based on the "dnac\_log\_append" flag. If the log file exists, - It is overwritten or appended based on the "dnac\_log\_append" flag. .. 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.dnac.application_policy_workflow_manager_module__parameter-dnac_log_append: .. rst-class:: ansible-option-title **dnac_log_append** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`boolean` .. raw:: html
- .. raw:: html
Determines the mode of the file. Set to True for 'append' mode. Set to False for 'write' mode. .. 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.dnac.application_policy_workflow_manager_module__parameter-dnac_log_file_path: .. rst-class:: ansible-option-title **dnac_log_file_path** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Governs logging. Logs are recorded if dnac\_log is True. If path is not specified, - When 'dnac\_log\_append' is True, 'dnac.log' is generated in the current Ansible directory; logs are appended. - When 'dnac\_log\_append' is False, 'dnac.log' is generated; logs are overwritten. If path is specified, - When 'dnac\_log\_append' is True, the file opens in append mode. - When 'dnac\_log\_append' is False, the file opens in write (w) mode. - In shared file scenarios, without append mode, content is overwritten after each module execution. - For a shared log file, set append to False for the 1st module (to overwrite); for subsequent modules, set append to True. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"dnac.log"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_log_level: .. rst-class:: ansible-option-title **dnac_log_level** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Sets the threshold for log level. Messages with a level equal to or higher than this will be logged. Levels are listed in order of severity [CRITICAL, ERROR, WARNING, INFO, DEBUG]. CRITICAL indicates serious errors halting the program. Displays only CRITICAL messages. ERROR indicates problems preventing a function. Displays ERROR and CRITICAL messages. WARNING indicates potential future issues. Displays WARNING, ERROR, CRITICAL messages. INFO tracks normal operation. Displays INFO, WARNING, ERROR, CRITICAL messages. DEBUG provides detailed diagnostic info. Displays all log messages. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"WARNING"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_password: .. rst-class:: ansible-option-title **dnac_password** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The password for authentication at the Cisco Catalyst Center. .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_port: .. rst-class:: ansible-option-title **dnac_port** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Specifies the port number associated with the Cisco Catalyst Center. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"443"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_task_poll_interval: .. rst-class:: ansible-option-title **dnac_task_poll_interval** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`integer` .. raw:: html
- .. raw:: html
Specifies the interval in seconds between successive calls to the API to retrieve task details. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`2` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_username: .. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-user: .. rst-class:: ansible-option-title **dnac_username** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-aliases:`aliases: user` .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The username for authentication at the Cisco Catalyst Center. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"admin"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-dnac_verify: .. rst-class:: ansible-option-title **dnac_verify** .. raw:: html .. 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.dnac.application_policy_workflow_manager_module__parameter-dnac_version: .. rst-class:: ansible-option-title **dnac_version** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
Specifies the version of the Cisco Catalyst Center that the SDK should use. .. rst-class:: ansible-option-line :ansible-option-default-bold:`Default:` :ansible-option-default:`"2.2.3.3"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__parameter-state: .. rst-class:: ansible-option-title **state** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`string` .. raw:: html
- .. raw:: html
The desired state of the configuration after module execution. .. rst-class:: ansible-option-line :ansible-option-choices:`Choices:` - :ansible-option-choices-entry-default:`"merged"` :ansible-option-choices-default-mark:`← (default)` - :ansible-option-choices-entry:`"deleted"` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_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
.. Attributes .. Notes Notes ----- .. note:: - SDK Methods used are - application\_policy.ApplicationPolicy.get\_application\_policy - application\_policy.ApplicationPolicy.application\_policy\_intent - application\_policy.ApplicationPolicy.get\_application\_policy\_queuing\_profile - application\_policy.ApplicationPolicy.update\_application\_policy\_queuing\_profile - application\_policy.ApplicationPolicy.create\_application\_policy\_queuing\_profile - application\_policy.ApplicationPolicy.delete\_application\_policy\_queuing\_profile - Paths used are - GET/dna/intent/api/v1/app-policy - POST/dna/intent/api/v1/app-policy-intent - GET/dna/intent/api/v1/app-policy-queuing-profile - POST/dna/intent/api/v1/app-policy-queuing-profile - PUT/dna/intent/api/v1/app-policy-queuing-profile - DELETE/dna/intent/api/v1/app-policy-queuing-profile/{id} - Does not support \ :literal:`check\_mode`\ - The plugin runs on the control node and does not use any ansible connection plugins instead embedded connection manager from Cisco Catalyst Center SDK - The parameters starting with dnac\_ are used by the Cisco Catalyst Center Python SDK to establish the connection .. Seealso .. Examples Examples -------- .. code-block:: yaml+jinja --- # Playbook - application queuing profile - type both ("bandwidth", "dscp") - name: Create Enterprise QoS Profile for Optimized Network Performance hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Create Enterprise QoS Profile for Optimized Network Performance cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise-QoS-Profile" profile_description: "QoS profile optimized for business-critical applications" bandwidth_settings: is_common_between_all_interface_speeds: true interface_speed: "ALL" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" dscp_settings: multimedia_conferencing: "20" ops_admin_mgmt: "23" transactional_data: "28" voip_telephony: "45" multimedia_streaming: "27" broadcast_video: "46" network_control: "48" best_effort: "0" signaling: "4" bulk_data: "10" scavenger: "2" real_time_interactive: "34" # Playbook - Enterprise QoS Profile (Common Across All Interface Speeds) - name: Deploy Enterprise QoS Profile in Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Configure Enterprise QoS Profile for Consistent Traffic Prioritization cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise-QoS-All-Speeds" profile_description: "Optimized QoS profile for consistent traffic prioritization across all interface speeds" bandwidth_settings: is_common_between_all_interface_speeds: true interface_speed: "ALL" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" # Playbook - QoS Profile Based on Interface Speeds - name: Deploy Interface-Specific QoS Profile in Cisco Catalyst Center hosts: localhost vars_files: - "credentials.yml" connection: local gather_facts: false tasks: - name: Configure QoS Profile for Different Interface Speeds cisco.dnac.application_policy_workflow_manager: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log: true dnac_log_level: DEBUG config_verify: false dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise-Speed-Based-QoS" profile_description: "Optimized traffic prioritization based on interface speed" bandwidth_settings: is_common_between_all_interface_speeds: false interface_speed_settings: - interface_speed: "HUNDRED_GBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "20" multimedia_streaming: "5" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: "TEN_GBPS" bandwidth_percentages: transactional_data: "5" best_effort: "5" voip_telephony: "25" multimedia_streaming: "5" real_time_interactive: "20" multimedia_conferencing: "5" signaling: "4" scavenger: "6" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "15" - interface_speed: "ONE_GBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: "HUNDRED_MBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "5" multimedia_streaming: "15" real_time_interactive: "25" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: "TEN_MBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: "ONE_MBPS" bandwidth_percentages: transactional_data: "5" best_effort: "5" voip_telephony: "25" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "5" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" # Playbook - for some interface speeds having common bandwidth percentage - name: Configure an Application Queueing Profile for Traffic Prioritization hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Create an Application Queueing Profile for Traffic Prioritization cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise_Traffic_Policy" profile_description: "Queueing profile for optimizing enterprise application traffic." bandwidth_settings: is_common_between_all_interface_speeds: false interface_speed_settings: - interface_speed: "HUNDRED_GBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "20" multimedia_streaming: "5" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: "TEN_GBPS" bandwidth_percentages: transactional_data: "5" best_effort: "5" voip_telephony: "25" multimedia_streaming: "5" real_time_interactive: "20" multimedia_conferencing: "5" signaling: "6" scavenger: "5" ops_admin_mgmt: "4" broadcast_video: "2" network_control: "3" bulk_data: "15" - interface_speed: "HUNDRED_MBPS" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "5" multimedia_streaming: "15" real_time_interactive: "25" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" - interface_speed: TEN_MBPS,ONE_MBPS,ONE_GBPS bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" # Playbook - application queuing profile - type dscp - name: Configure Application Queuing Profile (DSCP) in Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Create an Application Queuing Profile with DSCP Settings cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise_DSCP_Profile" profile_description: "DSCP-based queuing profile for traffic prioritization." dscp_settings: multimedia_conferencing: "20" ops_admin_mgmt: "23" transactional_data: "28" voip_telephony: "45" multimedia_streaming: "27" broadcast_video: "46" network_control: "48" best_effort: "0" signaling: "4" bulk_data: "10" scavenger: "2" real_time_interactive: "34" # Playbook - update application queuing profile - name: Application Queuing Profile update in Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Update Application Queuing Profile in Cisco Catalyst Center cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - queuing_profile: - profile_name: "Enterprise_Traffic_Profile" # Existing profile to be updated new_profile_name: "Enterprise_Traffic_Profile_v2" # New profile name after update profile_description: "Traffic queuing profile for enterprise applications." new_profile_description: "Updated queuing profile for optimized traffic management." bandwidth_settings: is_common_between_all_interface_speeds: true interface_speed: "ALL" bandwidth_percentages: transactional_data: "5" best_effort: "10" voip_telephony: "15" multimedia_streaming: "10" real_time_interactive: "20" multimedia_conferencing: "10" signaling: "10" scavenger: "5" ops_admin_mgmt: "5" broadcast_video: "2" network_control: "3" bulk_data: "5" dscp_settings: multimedia_conferencing: "20" ops_admin_mgmt: "23" transactional_data: "28" voip_telephony: "45" multimedia_streaming: "27" broadcast_video: "46" network_control: "48" best_effort: "0" signaling: "4" bulk_data: "10" scavenger: "2" real_time_interactive: "34" # Playbook - delete application queuing profile - name: Delete application queuing profile from Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Delete application queuing profile from Cisco Catalyst Center cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: deleted config: - queuing_profile: - profile_name: "Enterprise_Traffic_Profile" # Profile to be deleted # Playbook - create application policy – wired - name: Create Wired Application Policy in Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Define and Deploy Wired Application Policy cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - application_policy: - name: "wired_traffic_policy" policy_status: "deployed" site_names: ["Global/INDIA"] device_type: "wired" application_queuing_profile_name: "WiredStreamingQueuingProfile" clause: - clause_type: "BUSINESS_RELEVANCE" relevance_details: - relevance: "BUSINESS_RELEVANT" application_set_name: ["collaboration-apps"] - relevance: "BUSINESS_IRRELEVANT" application_set_name: ["email", "tunneling"] - relevance: "DEFAULT" application_set_name: ["backup-and-storage", "general-media", "file-sharing"] # Playbook - create application policy – wireless - name: Create Wireless Application Policy in Cisco Catalyst Center hosts: localhost connection: local gather_facts: false vars_files: - "credentials.yml" tasks: - name: Define and Deploy Wireless Application Policy cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: merged config: - application_policy: - name: "wireless_traffic_policy" policy_status: "deployed" site_names: ["global/Chennai/FLOOR1"] device_type: "wireless" ssid_name: "ent-ssid-2-wpa2" application_queuing_profile_name: "wireless_streaming_profile" clause: - clause_type: "BUSINESS_RELEVANCE" relevance_details: - relevance: "BUSINESS_RELEVANT" application_set_name: ["file-sharing"] - relevance: "BUSINESS_IRRELEVANT" application_set_name: ["email", "backup-and-storage"] - relevance: "DEFAULT" application_set_name: ["collaboration-apps", "tunneling", "general-media"] # Playbook - delete application policy - name: Delete Application Policy from Cisco Catalyst Center hosts: localhost connection: local vars_files: - "credentials.yml" tasks: - name: Delete application policy from Cisco Catalyst Center cisco.dnac.application_policy_workflow_manager: dnac_host: "{{ dnac_host }}" dnac_username: "{{ dnac_username }}" dnac_password: "{{ dnac_password }}" dnac_verify: "{{ dnac_verify }}" dnac_port: "{{ dnac_port }}" dnac_version: "{{ dnac_version }}" dnac_debug: "{{ dnac_debug }}" dnac_log: true dnac_log_level: DEBUG config_verify: true dnac_api_task_timeout: 1000 dnac_task_poll_interval: 1 state: deleted config: - application_policy: - name: "ObsoleteTrafficPolicy" .. 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.dnac.application_policy_workflow_manager_module__return-application_policy_not_found_response_task_execution: .. rst-class:: ansible-option-title **application_policy_not_found_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution .. 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:`{"msg": "Application policy 'WirelessTrafficOptimizationPolicy' does not present in the cisco catalyst center or its been already deleted", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-application_queuing_profile_not_found_response_task_execution: .. rst-class:: ansible-option-title **application_queuing_profile_not_found_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution .. 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:`{"msg": "Application queuing profile 'Enterprise-QoS-All-Speeds' does not present in the Cisco Catalyst Center or it has already been deleted.", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-creation_of_application_queuing_profile_response_task_execution: .. rst-class:: ansible-option-title **creation_of_application_queuing_profile_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
A dictionary with details for successful task execution. .. 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:`{"msg": "Application queuing profile 'Enterprise-QoS-Profile' created successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-deletion_of_application_queuing_profile_response_task_execution: .. rst-class:: ansible-option-title **deletion_of_application_queuing_profile_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution. .. 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:`{"msg": "Application policy queuing profile 'Enterprise-QoS-Profile' deleted successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-error_during_application_policy_create_response_task_execution: .. rst-class:: ansible-option-title **error_during_application_policy_create_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution .. 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:`{"msg": "( \\"Creation of the application policy failed due to - \\" \\"NCAS10157 The same site cannot be used in two different wired policies. \\" \\"Current policy 'WiredTrafficOptimizationPolicy' and policy 'ObsoleteTrafficPolicy' are both using \\" \\"the following site/s 'Chennai/LTTS/FLOOR1'\\" )", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-error_during_application_policy_update_response_task_execution: .. rst-class:: ansible-option-title **error_during_application_policy_update_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution .. 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:`{"...'\\" )": null, "msg": "( \\"Update of the application policy failed due to - \\" \\"NCAS10157 The same site cannot be used in two different wired policies. \\" \\"Current policy 'ObsoleteTrafficPolicy' and policy 'WiredTrafficOptimizationPolicy' \\" \\"are both using the following site/s 'mysore/Mod-x/Mezzanine", "mysore/Mod-x": null, "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-error_during_application_queuing_profile_create_response_task_execution: .. rst-class:: ansible-option-title **error_during_application_queuing_profile_create_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution. .. 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:`{"msg": "Failed to create application queuing profile reason - NCAS10031: The DSCP value of 'best-effort' traffic class should be '0'", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-error_during_application_queuing_profile_delete_response_task_execution: .. rst-class:: ansible-option-title **error_during_application_queuing_profile_delete_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution. .. 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:`{"msg": "( \\"Deletion of the application policy queuing profile failed due to - \\" \\"NCAS10011 Queuing profile 'Enterprise-QoS-All-Speeds' cannot be deleted \\" \\"as it is used by the policy\\" )", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-error_during_application_queuing_profile_update_response_task_execution: .. rst-class:: ansible-option-title **error_during_application_queuing_profile_update_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for task execution. .. 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:`{"msg": "( \\"Update of the application policy queuing profile failed due to \\" \\"NCAS10025 The sum of bandwidth percentages of all traffic classes \\" \\"should be '100'. The current sum is '101'.\\" )", "response": {"taskId": "str", "url": "str"}}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-successful_creation_of_application_policy_response_task_execution: .. rst-class:: ansible-option-title **successful_creation_of_application_policy_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution .. 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:`{"msg": "Application policy 'ObsoleteTrafficPolicy' created successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-successful_deletion_of_application_policy_response_task_execution: .. rst-class:: ansible-option-title **successful_deletion_of_application_policy_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution .. 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:`{"msg": "Application policy 'ObsoleteTrafficPolicy' deleted successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-successful_update_of_application_policy_response_task_execution: .. rst-class:: ansible-option-title **successful_update_of_application_policy_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution .. 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:`{"msg": "Application policy 'ObsoleteTrafficPolicy' updated successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-update_not_required_for_application_policy_response_task_execution: .. rst-class:: ansible-option-title **update_not_required_for_application_policy_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution .. 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:`{"msg": "Application policy 'ObsoleteTrafficPolicy' does not need any update. ", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-update_not_required_for_queuing_profile_response_task_execution: .. rst-class:: ansible-option-title **update_not_required_for_queuing_profile_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution. .. 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:`{"msg": "Application queuing profile 'Enterprise-QoS-Profile' does not need any update", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
* - .. raw:: html
.. _ansible_collections.cisco.dnac.application_policy_workflow_manager_module__return-update_of_application_queuing_profile_response_task_execution: .. rst-class:: ansible-option-title **update_of_application_queuing_profile_response_task_execution** .. raw:: html .. rst-class:: ansible-option-type-line :ansible-option-type:`dictionary` .. raw:: html
- .. raw:: html
With task id get details for successful task execution. .. 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:`{"msg": "Application policy queuing profile 'Enterprise-QoS-Profile' updated successfully.", "response": {"taskId": "str", "url": "str"}, "status": "success"}` .. raw:: html
.. Status (Presently only deprecated) .. Authors Authors ~~~~~~~ - Syed Khadeer Ahmed (@syed-khadeerahmed) - Madhan Sankaranarayanan (@madhansansel) .. Extra links Collection links ~~~~~~~~~~~~~~~~ .. raw:: html .. Parsing errors