| Richard Marian Thomaiyar | 05375b1 | 2018-05-24 10:33:27 +0530 | [diff] [blame^] | 1 | description: > |
| 2 | Provides user management functionality. |
| 3 | As communication to this service is done through authenticated |
| 4 | & authorized session, there won't be any validation for both. |
| 5 | |
| 6 | methods: |
| 7 | - name: CreateUser |
| 8 | description: > |
| 9 | Creates a new user. If the user already exists, then it will throw |
| 10 | an error. |
| 11 | parameters: |
| 12 | - name: UserName |
| 13 | type: string |
| 14 | description: > |
| 15 | User name which has to be created. |
| 16 | - name: GroupNames |
| 17 | type: array[string] |
| 18 | description: > |
| 19 | List of groups to which the user has to be added. |
| 20 | - name: Privilege |
| 21 | type: string |
| 22 | description: > |
| 23 | Privilege of the user to be added. |
| 24 | - name: Enabled |
| 25 | type: boolean |
| 26 | description: > |
| 27 | User enabled / disabled. |
| 28 | errors: |
| 29 | - xyz.openbmc_project.Common.Error.InternalFailure |
| 30 | - xyz.openbmc_project.Common.Error.InsufficientPermission |
| 31 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| 32 | - xyz.openbmc_project.User.Common.Error.UserNameExists |
| 33 | - xyz.openbmc_project.User.Common.Error.UserNameGroupFail |
| 34 | - xyz.openbmc_project.User.Common.Error.UserNamePrivFail |
| 35 | - xyz.openbmc_project.User.Common.Error.NoResource |
| 36 | |
| 37 | - name: RenameUser |
| 38 | description: > |
| 39 | Rename's existing user to new one. All other properties of the |
| 40 | user will remain same. |
| 41 | parameters: |
| 42 | - name: UserName |
| 43 | type: string |
| 44 | description: > |
| 45 | User name which has to be updated. |
| 46 | - name: NewUserName |
| 47 | type: string |
| 48 | description: > |
| 49 | New User name to which user has to be updated. |
| 50 | errors: |
| 51 | - xyz.openbmc_project.Common.Error.InternalFailure |
| 52 | - xyz.openbmc_project.Common.Error.InsufficientPermission |
| 53 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| 54 | - xyz.openbmc_project.User.Common.Error.UserNameDoesNotExist |
| 55 | - xyz.openbmc_project.User.Common.Error.UserNameExists |
| 56 | - xyz.openbmc_project.User.Common.Error.UserNameGroupFail |
| 57 | - xyz.openbmc_project.User.Common.Error.UserNamePrivFail |
| 58 | - xyz.openbmc_project.User.Common.Error.NoResource |
| 59 | |
| 60 | properties: |
| 61 | - name: AllPrivileges |
| 62 | type: array[string] |
| 63 | description: > |
| 64 | Lists all available user privileges in the system. |
| 65 | |
| 66 | - name: AllGroups |
| 67 | type: array[string] |
| 68 | description: > |
| 69 | Lists all available groups in the system. |
| 70 | |
| 71 | signals: |
| 72 | - name: UserRenamed |
| 73 | description: > |
| 74 | Signal indicating user's name is updated. |
| 75 | properties: |
| 76 | - name: UserName |
| 77 | type: string |
| 78 | description: Name of the user which got renamed. |
| 79 | - name: NewUserName |
| 80 | type: string |
| 81 | description: New name of the user. |
| 82 | |
| 83 | # vim: tabstop=8 expandtab shiftwidth=4 softtabstop=4 |