|
APIs in Category: useradmin |
API version 1.4 |
| 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.