Tenant-level user account resources let you create, retrieve information about, modify, and delete tenant-level user accounts. The table below provides information about these resources.
User account resources are not available for the default tenant.
Data type |
Method |
Use |
Access |
Notes |
---|---|---|---|---|
userAccount |
Create a user account for a tenant |
Tenant-level user account with the security role |
For information about the required query parameter for creating a user account, see Query parameter for setting user account passwords. |
|
List |
Retrieve a list of the user accounts defined for a tenant |
Tenant-level user account with the monitor, administrator, or security role |
The listed user accounts are identified by the account username. In XML, the element that identifies each user account is username. The root element for the list of user accounts is userAccounts. In JSON, the name in the name/value pair that lists the user accounts is username. |
|
N/A |
Reset the passwords of all locally authenticated user accounts with the security role |
System-level user account with the security role |
For information about the required query parameter for resetting passwords, see Query parameter for resetting security user passwords. |
|
userAccount |
Retrieve information about a user account |
Tenant-level user account with the monitor, administrator, or security role |
The information returned depends on the roles associated with the user making the request. |
|
N/A |
Check for the existence of a user account |
Tenant-level user account with the monitor, administrator, or security role |
|
|
userAccount |
Modify a user account |
Tenant-level user account with the administrator or security role |
A user with only the administrator role can modify only the allow-NamespaceManagement property. A user with only the security role cannot modify that property. For information about the query parameter for changing the password for a user account, see Query parameter for setting user account passwords. |
|
N/A |
Delete a user account |
Tenant-level user account with the security role |
|
|
updatePassword |
Reset the passwords of all locally authenticated user accounts with the security role |
System-level user account with the security role |
For information about the required query parameter for resetting passwords, see Query parameter for resetting security user passwords. |
|
.../tenants/tenant-name/userAccounts/username/changePassword |
||||
updatePassword |
POST |
Change the password for a locally authenticated tenant-level user account |
System-level user account with the security role or tenant-level user account with the security role |
For information about the query parameter for changing the password for a user account, see Query parameter for setting user account passwords. |
.../tenants/tenant-name/userAccounts/username/dataAccessPermissions |
||||
dataAccess |
Retrieve information about the data access permissions associated with a user account |
Tenant-level user account with the administrator or security role |
|
|
Modify the data access permissions associated with a user account |
Tenant-level user account with the administrator role |
The request body must contain all permissions granted for each included namespace. If a namespace is not included, its permissions are not changed by the POST request. By default, when you create a user account, it does not include any data access permissions. |
© 2015, 2020 Hitachi Vantara LLC. All rights reserved.