diff --git a/plugins/modules/swim_workflow_manager.py b/plugins/modules/swim_workflow_manager.py index df7ddc067..3c341426c 100644 --- a/plugins/modules/swim_workflow_manager.py +++ b/plugins/modules/swim_workflow_manager.py @@ -189,6 +189,9 @@ Behavior: - If 'device_role' is a single string (e.g., `"ACCESS"`), only that role is tagged as golden. - If 'device_role' contains multiple roles (e.g., `"ACCESS,CORE"`), all specified roles are tagged as golden. + To replace an existing golden tag for a specific role: + - **Unassign** the tag from the current role (e.g., `ACCESS`). + - **Assign** the tag to the new role (e.g., `CORE`). Examples: - device_role: "ACCESS" tags only the `ACCESS` role as golden. - device_role: "ACCESS,CORE" tags both `ACCESS` and `CORE` roles as golden. @@ -343,6 +346,8 @@ - Added the parameter 'dnac_api_task_timeout', 'dnac_task_poll_interval' options in v6.13.2. + + """ EXAMPLES = r""" @@ -462,6 +467,30 @@ site_name: Global/USA/San Francisco/BGL_18 tagging: True +# Remove the golden tag from the specified image for the given device role and assign it to another device role. +- name: Update golden tag assignment for image based on device role + cisco.dnac.swim_workflow_manager: + dnac_host: "{{dnac_host}}" + dnac_username: "{{dnac_username}}" + dnac_password: "{{dnac_password}}" + dnac_verify: "{{dnac_verify}}" + dnac_port: "{{dnac_port}}" + dnac_version: "{{dnac_version}}" + dnac_debug: "{{dnac_debug}}" + dnac_log_level: "{{dnac_log_level}}" + dnac_log: true + config: + - tagging_details: + image_name: cat9k_iosxe.17.12.01.SPA.bin + device_role: CORE + device_image_family_name: Cisco Catalyst 9300 Switch + tagging: false + - tagging_details: + image_name: cat9k_iosxe.17.12.01.SPA.bin + device_role: ACCESS + device_image_family_name: Cisco Catalyst 9300 Switch + tagging: true + - name: Tag the specified image as golden for multiple device roles and load it into the device cisco.dnac.swim_workflow_manager: dnac_host: "{{dnac_host}}"