Model: view/DeleteUnusedRoles

Delete Unused Roles

Tip

Use the Action search to navigate Automate

This procedure deletes unused roles from all hierarchies or a selection of hierarchies.

The Delete Unused Roles tool allows you to delete:

All unused roles
Unused roles at specified hierarchies
Unused roles down from specified hierarchies - with the option to select hierarchies

Note

Only unused roles are deleted.
Use this tool with caution since the transaction to delete unused roles can't be rolled back.

Roles are used in for example the following functional areas:

Site Defaults
Add admin user
Set up LDAP for User Synchronization
Define a Filter
Authorized Admin Hierarchies and Roles

To delete unused roles:

Log in to the Admin portal as Hcsadmin.
Go to Delete Unused Roles.
At Would you like to delete unused roles at all hierarchies, choose delete options:
- Delete unused roles at all hierarchies? Select Yes. Confirm your choice, then save. All unused roles at the current hierarchy and down are deleted.
- Delete unused roles from selected hierarchies and define delete scope? Select No, then:
  - Choose hierarchy scope, either At or Down from a specific hierarchy, then choose options for the selected hierarchy, for example, all or a subset of your customers, resellers, or sites.
  - If deleting from a subset of a hierarchy, choose the subset (one or more customers, sites, resellers, and so on), depending on the selected hierarchy.
  - Confirm your choices, then save. Unused roles are deleted for the options selected.
Check the transaction log to monitor progress of the role delete. See Transaction Logging and Audit.

Model Details: view/DeleteUnusedRoles

An asterisk * in the title indicates the field is mandatory.
If a field has a default value, it is shown in the Description column.
If the field type is an array, the Field Name has a .[n] suffix, where n is the array index placeholder.
Object and array field names are listed to provide context. If a field belongs to an object or an array, the full field name is shown in dot separated notation.

Title															Description																				Details
															Default: Delete Unused Roles																				Field Name: description Type: String Default: Delete Unused Roles
															Default: This tool allows you to delete all unused roles at a specified hierarchy/hierarchies or down from a specified hierarchy/hierarchies. Used roles will be skipped. Take caution. It is very destructive and cannot be rolled back. Please select the options from the dropdowns. If you select "Yes" in the first dropdown, all the unused roles down from the current Provider hierarchy will be deleted. Models where roles are used are: SiteDefaultsDoc, User, HcsLdapUserSyncDAT, HcsMoveFilterDAT, AuthorizedAdminHierarchy.																				Field Name: notes Type: String Default: This tool allows you to delete all unused roles at a specified hierarchy/hierarchies or down from a specified hierarchy/hierarchies. Used roles will be skipped. Take caution. It is very destructive and cannot be rolled back. Please select the options from the dropdowns. If you select "Yes" in the first dropdown, all the unused roles down from the current Provider hierarchy will be deleted. Models where roles are used are: SiteDefaultsDoc, User, HcsLdapUserSyncDAT, HcsMoveFilterDAT, AuthorizedAdminHierarchy.
Would you like to delete unused roles at all hierarchies?															Default: Yes																				Field Name: all_hierarchies Type: String Default: Yes Choices: ["Yes", "No"]
Would you like to delete unused roles at a specific hierarchy or down from a specific hierarchy?															Default: At																				Field Name: direction Type: String Default: At Choices: ["At", "Down"]
At which hierarchy do you want to delete unused roles?															Default: Provider																				Field Name: at_hierarchy Type: String Default: Provider Choices: ["Provider", "Reseller", "Customer", "Site"]
From which hierarchy do you want to delete unused roles?															Default: Reseller																				Field Name: from_hierarchy Type: String Default: Reseller Choices: ["Reseller", "Customer", "IntermediateNode", "Site"]
All resellers or a subset of resellers?															Default: All																				Field Name: reseller_scope Type: String Default: All Choices: ["All", "Specific"]
	Resellers																																		Field Name: reseller_x.[n] Type: Array
All customers or a subset of customers?															Default: All																				Field Name: customer_scope Type: String Default: All Choices: ["All", "Specific"]
	Customers																																		Field Name: customer_x.[n] Type: Array
All IntermediateNodes or a subset of IntermediateNodes?															Default: All																				Field Name: intermediatenode_scope Type: String Default: All Choices: ["All", "Specific"]
	IntermediateNodes																																		Field Name: intermediatenode_x.[n] Type: Array
All sites or a subset of sites?															Default: All																				Field Name: site_scope Type: String Default: All Choices: ["All", "Specific"]
	Sites																																		Field Name: site_x.[n] Type: Array
Confirmation *																																			Field Name: confirmation Type: String Choices: ["Yes, I confirm that I want to delete unused roles"]