Skip to main content

security login rest-role show

Show access control REST roles

Availability: This command is available to cluster administrators at the admin privilege level.

Description​

The security login rest-role show command displays the following information about access-control roles:

  • vserver
  • Role name
  • api to which the role has access
  • Access level (none, read-only, or all)

Parameters​

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all fields.
[-vserver <Vserver Name>] - Vserver
Selects the roles that match this parameter value.
[-role <text>] - Role Name
Selects the roles that match this parameter value. If this parameter and the -api parameter are both used, the command displays detailed information about the specified access-control role.
[-api <text>] - api path
Selects the roles that match this parameter value. If this parameter and the -role parameter are both used, the command displays detailed information about the specified access-control role.
[-access {none|readonly|all}] - Access Level
Selects the roles that match this parameter value.

Examples​

The example below displays information about all access-control roles: 

cluster1::> security login rest-role show

        Role                Access
Vserver     Name        API     Level
----------  -------------   ----------- -----------
vs      vsadmin     /api        none
cluster1    readonly    /api/storage    none