security login rest-role create

Contributors

Add an access control REST role

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

Description

The security login rest-role create command creates an access-control role. An access-control role consists of a role name and a api to which the role has access. It optionally includes an access level (none, readonly, or all) for api. After you create an access-control role, you can apply it to a management-utility login account by using the security login modify or security login create commands.

Parameters

-vserver <Vserver Name> - Vserver

This optionally specifies the Vserver name associated with the role.

-role <text> - Role Name

This specifies the role that is to be created.

-api <text> - api path

This specifies the api to which the role has access.

-access {none|readonly|all} - Access Level

This optionally specifies an access level for the role. Possible access level settings are none, readonly, and all. The default setting is all .

Examples

The following command creates an access-control role named "admin" for the vs1.example.com Vserver. The role has all access to the api "/api/storage/volume" but only within the "aggr0" aggregate.

cluster1::> security login rest-role create -role admin -api /api/storage/volume  -access all -vserver vs1.example.com