UserGroups
UserGroups - Create
Creates a new user group in a Fabric-enabled LogPoint.
POST
https://api-server-host-name/configapi/{pool_UUID}/{logpoint_identifier}/UserGroupsParameters
description
Description
String
Description of usergroup. Optional Field
name
Name
String
Name of usergroup. Mandatory Field
object_permission
Object Permission
json
Mandatory Field. Specify permission for repos, usergroups, devices and ips. The following parameters should be provided to define object_permission. include_all_permission: Specifies full permission for repos and device_groups for all logpoints. If include_all_permission key is set as true, user should not give permission parameter in object_permission json. permission: List of jsons. To define permission, the following parameters should be provided. - logpoint_ip: Private IP of the logpoint. Use DistributedLogpoints - List API to obtain the private_ip of the required distributed logpoints. For localhost the logpoint_ip value is "127.0.0.1". Mandatory Field. - include_all_repos: Select/Unselect all repos for the given logpoint. If include_all_repos key is set as true, user should not give repos parameter. - repos: Name of the repos. Use Repos - FetchRemoteRepos API to obtain the names of the repos. - include_all_device_groups: Select/Unselect all device groups for the given logpoint. If include_all_device_groups key is set as true, user should not give device_groups parameter. - device_groups: List of jsons. To define device_groups, the following parameters should be provided. - name: Name of device group. Use DeviceGroups - List API to obtain the names of the device groups. Mandatory field. - include_all_devices: Select/Unselect all devices of given device_groups. If include_all_devices key is set as true, user should not give devices parameter. - devices: List of jsons. To define devices, the following parameters should be provided. - name: Name of devices or logsources. Use Devices - List API to obtain the names of the devices. Use LogSources - List API to obtain the names of the logsources. Mandatory field. - include_all_ips: Select/Unselect all ips of given devices or logsources. If include_all_ips key is set as true, user should not give ips parameter. - ips: List of ips of devices or logsources. Use Devices - List API to obtain the ips of the devices. Use LogSources - List API to obtain the addresses of the logsources.
query
Universal Query
String
Universal Query for a user group. Optional Field
roles
Permission Group
String
Permission group. Mandatory Field
Request Example
{
"data": {
"description": "New usergroup",
"name": "usergroup1",
"object_permission": {
"include_all_permission": false,
"permission": [
{
"include_all_device_groups": true,
"include_all_repos": true,
"logpoint_ip": "10.45.1.1"
},
{
"device_groups": [
{
"include_all_devices": true,
"name": "devicegroup3"
},
{
"devices": [
{
"include_all_ips": true,
"name": "device2"
}
],
"include_all_devices": false,
"name": "devicegroup2"
},
{
"devices": [
{
"include_all_ips": false,
"ips": [
"10.40.1.2"
],
"name": "device1"
},
{
"name": "logsource",
"include_all_ips": false,
"ips": [
"10.40.1.3"
]
}
],
"include_all_devices": false,
"name": "devicegroup1"
}
],
"logpoint_ip": "127.0.0.1",
"repos": [
"_logpoint"
]
}
]
},
"query": "col_type=syslog",
"roles": "5bebd9fdd8aaa42840edc84e"
}
}Success Response
UserGroups - Edit
Edits a user group in a Fabric-enabled LogPoint.
PUT
Parameters
description
Description
String
Description of usergroup. Optional Field
id
-
String
Existing Usergroup id. Obtain the value of the required Usergroup id using Usergroups - List API. Mandatory Field
name
Name
String
Name of usergroup. Mandatory Field
object_permission
Object Permission
json
Mandatory Field. Specify permission for repos, usergroups, devices and ips. The following parameters should be provided to define object_permission. include_all_permission: Specifies full permission for repos and device_groups for all logpoints. If include_all_permission key is set as true, user should not give permission parameter in object_permission json. permission: List of jsons. To define permission, the following parameters should be provided. - logpoint_ip: Private IP of the logpoint. Use DistributedLogpoints - List API to obtain the private_ip of the required distributed logpoints. For localhost the logpoint_ip value is "127.0.0.1". Mandatory Field. - include_all_repos: Select/Unselect all repos for the given logpoint. If include_all_repos key is set as true, user should not give repos parameter. - repos: Name of the repos. Use Repos - FetchRemoteRepos API to obtain the names of the repos. - include_all_device_groups: Select/Unselect all device groups for the given logpoint. If include_all_device_groups key is set as true, user should not give device_groups parameter. - device_groups: List of jsons. To define device_groups, the following parameters should be provided. - name: Name of device group. Use DeviceGroups - List API to obtain the names of the device groups. Mandatory field. - include_all_devices: Select/Unselect all devices of given device_groups. If include_all_devices key is set as true, user should not give devices parameter. - devices: List of jsons. To define devices, the following parameters should be provided. - name: Name of devices or logsources. Use Devices - List API to obtain the names of the devices. Use LogSources - List API to obtain the names of the logsources. Mandatory field. - include_all_ips: Select/Unselect all ips of given devices or logsources. If include_all_ips key is set as true, user should not give ips parameter. - ips: List of ips of devices or logsources. Use Devices - List API to obtain the ips of the devices. Use LogSources - List API to obtain the addresses of the logsources.
query
Universal Query
String
Universal Query for a user group. Optional Field
roles
Permission Group
String
Permission group. Mandatory Field
Request Example
Success Response
UserGroups - Get
Fetches a User Group with given ID.
GET
Parameters
id
-
String
ID of the existing usergroup that you want to fetch.
Success Response
UserGroups - List
Lists all existing User Groups.
GET
Success Response
UserGroups - RefreshList
Syncs the current User Group List with LogPoint's User Group List.
POST
Request Example
Success Response
UserGroups - Trash
Removes the usergroup with given ID.
DELETE
Parameters
id
-
String
ID of the existing device that you want to delete. Mandatory Field
Success Response
You can use the Ungrouped value in the device_groups parameter of the UserGroups - Create and UserGroups - Edit APIs to include the devices that do not belong to any device groups.
While configuring the user groups for remote Logpoint instances, if you are using the Ungrouped value then at least one of the given devices must not belong to any device group for the API to execute successfully.
You must execute the UserGroups - RefreshList API until the data in the API Server is synced with the Fabric-enabled Logpoint data in the following cases:
After adding or deleting distributed Logpoints.
After creating, editing, or deleting repos, device groups, and devices.
After creating or editing user groups.
Last updated
Was this helpful?