cisco.ise.personas_update_roles – Update the roles of a node

Note

This plugin is part of the cisco.ise collection (version 1.2.1).

To install it use: ansible-galaxy collection install cisco.ise.

To use it in a playbook, specify: cisco.ise.personas_update_roles.

New in version 0.0.8: of cisco.ise

Synopsis

  • Update the roles of a node

Note

This module has a corresponding action plugin.

Requirements

The below requirements are needed on the host that executes this module.

  • requests >= 2.25.1

  • python >= 3.5

Parameters

Parameter Choices/Defaults Comments
domain
string
The domain of the node.
ise_verify
boolean
    Choices:
  • no
  • yes
Whether or not to verify the identity of the node.
ise_version
string
The version of the ISE node.
ise_wait_on_rate_limit
boolean
    Choices:
  • no
  • yes
Whether or not to wait on rate limit
local_ip
string
The local IP address of the node
name
string
The name of the node.
password
string
The password to log into the node.
primary_ip
string
The public IP address of the primary node.
primary_password
string
The password for the primary node.
primary_username
string
The username for the primary node.
roles
list / elements=string
The roles to be fulfilled by this node. Possible roles are SPAN or MNT-ACTIVE or MNT-STANDBY or PDP
username
string
The username to log into the node.

Notes

Note

  • Does not support check_mode

See Also

See also

cisco.ise.plugins.modules.personas_update_roles

The official documentation on the cisco.ise.plugins.modules.personas_update_roles module.

Examples

- name: Update roles on the rest of the nodes
  cisco.ise.personas_update_roles:
    primary_ip: 10.1.1.1
    primary_username: admin
    primary_password: cisco123
    name: "{{ item.name }}"
    local_ip: "{{ item.local_ip }}"
    hostname: "{{ item.hostname }}"
    username: admin
    password: cisco123
    domain: sstcloud.com
    roles: "{{ item.roles }}"
  loop:
    - name: ISE PAN Server 2
      local_ip: 10.1.1.2
      hostname: ise-pan-server-2
      roles:
        - SPAN
        - MNT-STANDBY
    - name: ISE PSN Server 1
      local_ip: 10.1.1.3
      hostname: ise-psn-server-1
      roles:
        - PDP
    - name: ISE PSN Server 2
      local_ip: 10.1.1.4
      hostname: ise-psn-server-2
      roles:
        - PDP

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
ise_response
string
always
A string stating that the node was successfully updated

Sample:
Node ISE PAN Server 2 updated successfully


Authors

  • Rafael Campos (@racampos)