getAccountsList
This method lists the user accounts visible to the account which has generated the API key. It will return an empty list if there are no user accounts.
Note
When the accounts list is retrieved, the account which generated the API key will be omitted.
Parameters
Parameter | Type | Optional | Description |
---|---|---|---|
| Number | Yes | The results page number. Default value: |
| Number | Yes | The number of items displayed in a page. Possible values: Default value: |
Return value
This method returns an Object containing information regarding user accounts. The returned object contains:
page
- the current page displayedpagesCount
- the total number of available pagesperPage
- the total number of returned items per pageitems
- the list of user accounts. Each entry in the list has the following fields:id
, the ID of the user account.userName
, the username of the user account.email
, the email of the user account.profile
, the profile information of the user account containing:fullName
,timezone
,language
andlandingPage
.role
, the role assigned for the user account. Possible values: 1 - Company Administrator, 2 - Network Administrator, 3 - Reporter, 5 - Custom.rights
, object containing the rights of the user account with true or false values whether the right is allowed for user or not.passwordLifetime
, the password expiration policy. Possible values:0
- the password will never expire.90
- the password will expire every 90 days. When a password expires the owner will no longer be able to use to log into GravityZone and will be prompted to create a new one.
Default value:
0
.accountLockdown, a Boolean indicating if the account is set to lock down after after 5 unsuccessful attempts.
total
- the total number of items
Example
Request :
{ "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f", "jsonrpc": "2.0", "method": "getAccountsList", "params": { "perPage": 20, "page": 1 } }
Response:
{ "id": "787b5e36-89a8-4353-88b9-6b7a32e9c87f", "jsonrpc": "2.0", "result": { "total": 2, "page": 1, "perPage": 20, "pagesCount": 1, "items": [ { "id": "585d3170aaed70b7048b4633", "userName": "client", "email": "[email protected]", "profile": { "fullName": "Bitdefender User", "language": "en_US", "timezone": "Europe/Bucharest" }, "role": 5, "rights": { "companyManager": false, "manageNetworks": true, "manageInventory ": true, "managePoliciesRead": true, "managePoliciesWrite": true, "manageReports": true, "manageUsers": true }, { "id": "585d3170aaed70b7048b4633", "userName": "client2", "email": "[email protected]", "profile": { "fullName": "Bitdefender User", "language": "en_US", "timezone": "Europe/Bucharest" }, "role": 1, "rights": { "companyManager": true, "manageNetworks": true, "manageInventory ": true, "managePoliciesRead": true, "managePoliciesWrite": true, "manageReports": true, "manageUsers": true }, } ] } }