examppple added for un-tag and tag a image

[syed-khadeerahmed]

Description

Please include a summary of the changes and the related issue. Also, include relevant motivation and context.

Type of Change

• Bug fix
• New feature
• Breaking change
• Documentation update

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published in downstream modules
• All the sanity checks have been completed and the sanity test cases have been executed

Ansible Best Practices

• Tasks are idempotent (can be run multiple times without changing state)
• Variables and secrets are handled securely (e.g., using ansible-vault or environment variables)
• Playbooks are modular and reusable
• Handlers are used for actions that need to run on change

Documentation

• All options and parameters are documented clearly.
• Examples are provided and tested.
• Notes and limitations are clearly stated.

Screenshots (if applicable)

Notes to Reviewers

[madhansansel]

- name: Replace golden tag from one device role to another for the specified image
or

- name: Remove golden tag from one device role and assign it to another

[madhansansel]

CORE or Core
ACCESS or Access? Follow one style?

[madhansansel]

true

[madhansansel]

false

[madhansansel]

true

[madhansansel]

We can include this information in device_role itself

device_role:
  description: |
    Specifies the device role(s) for tagging or untagging the image as golden.

    Permissible values:
    - 'ALL': Applies the golden tag to all devices, regardless of role.
    - 'UNKNOWN': Tags devices without a specified classification.
    - 'ACCESS': Tags devices that connect end-user devices (e.g., access switches).
    - 'BORDER ROUTER': Tags devices linking different network segments or domains.
    - 'DISTRIBUTION': Tags devices aggregating traffic toward the core.
    - 'CORE': Tags backbone devices handling high-volume network traffic.

    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.
  type: str