4.14. role

The role resource type groups all individual roles in a Red Hat Virtualization environment.

Table 4.37. Role parameters
Name	Type	Description	Required	User Creatable	User Updatable
`--name`	string	The name of the role.	Yes	Yes	Yes
`--permits-permit`	collection	A list of permits for initial inclusion with the role. Additional permits included with the permit resource type.	Yes	Yes	No
`--description`	string	A description for the role.	No	Yes	Yes
`--administrative`	Boolean	Set to `true` if this is an administrative role.	No	Yes	Yes

The --permits-permit parameter is a collection that uses the sub-parameters in the following table.

Table 4.38. --permits-permit parameters
Name	Type	Description
`permit.id`	string	A reference to a permit to add to the role's permits.

Example 4.32. Creating a new role

[RHEVM shell (connected)]# add role --name MyRole --permits-permit {permit.id: 1;},{permit.id: 2;)