security login rest-role delete

Contributors

Delete a REST access control role

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

Description

The security login rest-role delete command deletes a Representational State Transfer (REST) access-control role.

Parameters

-vserver <Vserver Name> - Vserver

This optionally specifies the Vserver name associated with the REST role.

-role <text> - Role Name

This specifies the REST role that is to be deleted.

-api <text> - API Path

This specifies the Application Programming Interface (API) to which the REST role has access. This API can be a resource-qualified endpoint. Currently, the only supported resource-qualified endpoints are /api/storage/volumes/{volume.uuid}/snapshots and /api/storage/volumes/*/snapshots. . * is a wildcard character denoting all volumes.

Examples

The following command deletes a REST access-control role entry with the role name readonly and the API /api/storage/volumes from Vserver vs.example.com .

cluster1::> security login rest-role delete -role readonly -api "/api/storage/volumes" -vserver vs.example.com
cluster1::>

The following command deletes a REST access-control role entry with the role name vs1_role and the resource-qualified endpoint corresponding to all snapshots on the volume with UUID 0aa39ec1-b68d-11ea-9581-005056bbabe6 from Vserver vs1.example.com .

cluster1::> security login rest-role delete -role vs1_role -api "/api/storage/volumes/0aa39ec1-b68d-11ea-9581-005056bbabe6/snapshots" -vserver vs1.example.com
cluster1::>