APIs in Category: useradmin
API version 1.4

 
useradmin-group-add
useradmin-group-delete
useradmin-group-list
useradmin-group-modify
useradmin-role-add
useradmin-role-delete
useradmin-role-list
useradmin-role-modify
useradmin-user-add
useradmin-user-delete
useradmin-user-list
useradmin-user-modify
useradmin-user-modify-password

NetApp Manage ONTAP
 
useradmin-group-add [top]

Adds a group given the information provided.
Input Name Range Type Description
useradmin-group useradmin-group-info
New group information. A group must have a name and at least one role. A comment is also allowed. All other fields are ignored.
 Errno  Description
 EINTERNALERROR

 
useradmin-group-delete [top]
Deletes a group.
Input Name Range Type Description
group-name string
The name of the group to be deleted.
 Errno  Description
 EINTERNALERROR

 
useradmin-group-list [top]
Lists full information for all groups on the system.
Input Name Range Type Description
group-name string
optional
List only the information associated with this group.
verbose boolean
optional
Default is false. If set to true, then the allowed capabilities are placed into the group-info structure. Depending on number of groups and roles, this operation may take a long time.
 
Output Name Range Type Description
useradmin-groups useradmin-group-info[]
List of groups and information associated with them.
 Errno  Description
 EINTERNALERROR

 
useradmin-group-modify [top]
Modifies a group given the information provided.
Input Name Range Type Description
new-group-name string
optional
New group name for this group. This is used to rename the group specified in useradmin-group. If this value is invalid, useradmin-group-modify fails without changing anything. The value is optional, and if not provided, the group name will be unchanged.
useradmin-group useradmin-group-info
A group must have a name. If one or more roless and/or a comment is provided, the group is modified accordingly. All other fields are ignored.
 Errno  Description
 EINTERNALERROR

 
useradmin-role-add [top]
Adds a role given the information provided.
Input Name Range Type Description
useradmin-role useradmin-role-info
New role information. A role must have a name and at least one allowed capability. A role-info comment is also allowed. All other fields are ignored.
 Errno  Description
 EINTERNALERROR

 
useradmin-role-delete [top]
Deletes a role.
Input Name Range Type Description
role-name string
The name of the role to be deleted.
 Errno  Description
 EINTERNALERROR

 
useradmin-role-list [top]
Lists full information for all roles on the system.
Input Name Range Type Description
role-name string
optional
List only the information associated with this role.
 
Output Name Range Type Description
useradmin-roles useradmin-role-info[]
List of roles and information associated with them.
 Errno  Description
 EINTERNALERROR

 
useradmin-role-modify [top]
Modifies a role given the information provided.
Input Name Range Type Description
useradmin-role useradmin-role-info
A role must have a name. If one or more capabilities and/or a comment is provided, the role is modified accordingly.
 Errno  Description
 EINTERNALERROR

 
useradmin-user-add [top]
Adds a user given the information provided.
Input Name Range Type Description
password string
Password for the user. Please see documentation for constraints on the password.
useradmin-user useradmin-user-info
New user information. A user must have a name and at least one group. A comment and full-name are also allowed. All other fields are ignored.
 Errno  Description
 EINTERNALERROR
 EINVALIDPASSWORD

 
useradmin-user-delete [top]
Deletes a user.
Input Name Range Type Description
user-name string
The name of the user to be deleted.
 Errno  Description
 EINTERNALERROR

 
useradmin-user-list [top]
Lists information for all administrative users on the system with the exception of root and snmp.
Input Name Range Type Description
group-name string
optional
List only the users which are a part of this group. This option must be left empty if the option "user-name" contains a value.
user-name string
optional
List only the information associated with this user. This option must be left empty if the option "group-name" contains a value.
verbose boolean
optional
Default is false. If set to true, then the allowed capabilities are placed into the user-info structure. Depending on number of users, groups, and roles; this operation may take a long time.
 
Output Name Range Type Description
useradmin-users useradmin-user-info[]
List of users and information associated with them.
 Errno  Description
 EINTERNALERROR

 
useradmin-user-modify [top]
Modifies a user given the information provided.
Input Name Range Type Description
useradmin-user useradmin-user-info
A user must have a name. If one or more groups a comment and/or a full-name is provided, the user is modified accordingly. All other fields are ignored.
 Errno  Description
 EINTERNALERROR

 
useradmin-user-modify-password [top]
Changes the password of a specified user.
Input Name Range Type Description
new-password string
New password for the user. Please see documentation for constraints on the password.
old-password string
optional
Current password for the user. A user with the capability 'security-passwd-change-others' does not need to enter the current password in order to change it to a new one.
user-name string
The user who's password should be changed.
 Errno  Description
 EINTERNALERROR
 EINVALIDPASSWORD
 EPERM

 
Element definition: useradmin-group-info [top]
Structure containing information pertaining to a group.
Name Range Type Description
allowed-capabilities useradmin-capability-info[]
optional
List of capabilities the group is allowed.
comment string
optional
Comment for the group.
name string
Name of the group.
rid string
optional
Unique relative identifier (per domain) for this group. (Used only for Windows.)
useradmin-roles useradmin-role-info[]
optional
List of roles this group contains. The only included entry in this structure is the name field. For full role information user useradmin-role-list.

 
Element definition: useradmin-role-info [top]
Structure containing information pertaining to a role.
Name Range Type Description
allowed-capabilities useradmin-capability-info[]
optional
List of capabilities the role is allowed.
comment string
optional
Comment for the role.
name string
Name of the role.

 
Element definition: useradmin-user-info [top]
Structure containing information pertaining to a user.
Name Range Type Description
allowed-capabilities useradmin-capability-info[]
optional
List of capabilities the user is allowed.
comment string
optional
Comment for the user. This is only set if the user has a comment.
full-name string
optional
Full name of the user. (Used only for Windows.) This is only set if the user has a full-name.
name string
Name of the user.
rid string
optional
Unique relative identifier (per domain) for this user. (Used only for Windows.)
useradmin-groups useradmin-group-info[]
List of groups this user is part of. The only included entry in this structure is the name field. For full group information user useradmin-group-list.

 
Element definition: useradmin-capability-info [top]
Capability to run a command or commands on the filer.
Name Range Type Description
name string
Name of the capability Possible values include: "*", "login-*", "cli-*", "api-*", "security-*"... Instead of "*", commands and subcommands can be specified directly. Please see man page or other documentation for more details.

 
Element definition: useradmin-group-info [top]
Structure containing information pertaining to a group.
Name Range Type Description
allowed-capabilities useradmin-capability-info[]
optional
List of capabilities the group is allowed.
comment string
optional
Comment for the group.
name string
Name of the group.
rid string
optional
Unique relative identifier (per domain) for this group. (Used only for Windows.)
useradmin-roles useradmin-role-info[]
optional
List of roles this group contains. The only included entry in this structure is the name field. For full role information user useradmin-role-list.

 
Element definition: useradmin-role-info [top]
Structure containing information pertaining to a role.
Name Range Type Description
allowed-capabilities useradmin-capability-info[]
optional
List of capabilities the role is allowed.
comment string
optional
Comment for the role.
name string
Name of the role.

 
Element definition: useradmin-capability-info [top]
Capability to run a command or commands on the filer.
Name Range Type Description
name string
Name of the capability Possible values include: "*", "login-*", "cli-*", "api-*", "security-*"... Instead of "*", commands and subcommands can be specified directly. Please see man page or other documentation for more details.