Add management user

Last updated
Save as PDF

Adds a new management user.

Users created at SUPERVISOR level have full control, whereas USER level users are read-only.

HTTP request syntax (URI)

POST <base_URI>/v8/storage/file-devices/management/users

Parameters

Name	Type	Required	Values	Description
userName	BODY	Y	string	Name of the new user to create.
accessLevel	BODY	Y	string	Access level of the new user. Accepted values are: USER SUPERVISOR
password	BODY	Y	string	Password to associate with the new user.

Return codes

Code	Data	Description
201	managementUser	Management user successfully added.
400	Error Message	Missing or invalid request contents.
403	Error Message	Operation forbidden by access level.
500	Error message	Error associated with the storage system.

Any HTTP status code other than 201 indicates that the API did not complete successfully.

Request example: Add new read-only user called "bob"

curl -vk -H "X-Api-Key: zrxvSDAv9x.RIP4gkmKarG3beF.or.4Tc2im7oeqYN88C9XPGHxbXC" https://172.17.11.11:8444/v8/storage/file-devices/management/users -X POST -d '{"userName":"bob", "accessLevel":"USER", "password":"passwd"}'

Response example

HTTP/1.1 201 Created
{
  "managementUser": {
    "accessLevel": "USER",
    "isDeletable": true,
    "isPasswordModifiable": true,
    "lastLogin": "none",
    "objectId": "626f623a3a3a555345523a3a3a303a3a3a4f49445f24232140255f56",
    "type": "NORMAL",
    "userName": "bob"
  },
  "uri": "https://172.17.11.11:8444/v8/storage/file-devices/management/users/626f623a3a3a555345523a3a3a303a3a3a4f49445f24232140255f56"
}

Quick Links