[Index]

Model: view/HcsMoveUsersVIEW

Move Users

You can move users between any hierarchy nodes at or below the hierarchy node where the users were originally created or synced in. A common practice is to move users synced in at a customer hierarchy node to various customer sites.

Note

The following restrictions exist when moving users that have been pushed to Cisco Unified Communications Manager:

Important

Site-to-Site user move is not supported in the Enterprise product, and will fail with dialplan errors.

You can choose the users to be moved in the following three ways:

When you move users, choose a Move To Role from the drop-down for the users that is appropriate for the target hierarchy node.

Model Details

Title Description Details
Action The type of Move action to perform.
  • Field Name: move_action
  • Type: String
  • Choices: ["Move users by filters", "Move users by usernames", "Move user by username"]
Action The type of Move action to perform. This attribute is deprecated and move_action should be used instead.
  • Field Name: action
  • Type: String
  • Choices: ["Move users by filters", "Move users by usernames", "Move user by username"]
User Name of individual user who will be moved.
  • Field Name: one_username
  • Type: String
  • Choices: [" "]
Note Information regarding the specified action.
  • Field Name: note
  • Type: String
Move From Hierarchy The name of the hierarchy node from which the user will be moved if the conditions are satisfied.
  • Field Name: move_from_hn
  • Type: String
Move From Hierarchy Count The number of the hierarchy nodes that match the from username. Default: TBD
  • Field Name: move_from_hn_count
  • Type: String
  • Default: TBD
Move To Hierarchy The name of the hierarchy node to which the user will be moved if the conditions are satisfied.
  • Field Name: move_to_hn
  • Type: String
  • Choices: [" "]
Set Default Role The default role to assign to the moved user (if no other LDAP Custom Role Mappings are applicable for the moved user, then this fallback/default role will be applied)
  • Field Name: move_to_role_user
  • Type: String
  • Choices: [" "]
Move All Users Move all the users at the move from hierarchy. Default: false
  • Field Name: move_all
  • Type: Boolean
  • Default: false
Filters Select move filters to be applied when the transaction is submitted.
  • Field Name: filters.[n]
  • Type: Array
Users Names of users who will be moved.
  • Field Name: usernames.[n]
  • Type: Array
API reference for view/HcsMoveUsersVIEW