Summary
Get a list of groups.
Description
Get a list of groups
Route
GET /authorization/groups
Roles
admin
apiread
Parameters
DetailsExampleSchema
Name |
Type |
Required |
Description |
queryOptions |
object |
yes |
The query options for searching groups. |
Copied to Clipboard
{
"queryOptions": {
"multiContains": {
"name": "group1",
"provenance": "Local AAA",
"description": "this is group1"
},
"multiEquals": {
"name": "group1",
"provenance": "Local AAA",
"description": "this is group1"
},
"multiStartsWith": {
"name": "group1",
"provenance": "Local AAA",
"description": "this is group1"
},
"inactive": false,
"skip": 1,
"limit": 10,
"sort": "name",
"order": 1,
"refresh": false
}
}
Copied to Clipboard
{
"type": "object",
"properties": {
"queryOptions": {
"title": "queryOptions",
"type": "object",
"properties": {
"multiContains": {
"$ref": "authorization-common#/definitions/groups-query"
},
"multiEquals": {
"$ref": "authorization-common#/definitions/groups-query"
},
"multiStartsWith": {
"$ref": "authorization-common#/definitions/groups-query"
},
"inactive": {
"$ref": "groups-schema#/properties/inactive"
},
"skip": {
"$ref": "common-schema#/definitions/skip"
},
"limit": {
"$ref": "common-schema#/definitions/limit"
},
"sort": {
"$ref": "common-schema#/definitions/sort"
},
"order": {
"$ref": "common-schema#/definitions/order"
},
"refresh": {
"type": "boolean",
"title": "refresh",
"description": "whether to refresh groups from AAA",
"default": false
}
}
}
},
"required": [
"queryOptions"
],
"additionalProperties": false
}
Return
DetailsExampleSchema
Name |
Type |
Description |
result |
object |
The groups matching the specified query. |
Copied to Clipboard
{
"results": {
"provenance": "Pronghorn",
"name": "group_1",
"description": "description of group_1",
"memberOf": [
{
"aaaManaged": false,
"groupId": "5cb7b531d06cceb89fd21b1c"
},
{
"aaaManaged": true,
"groupId": "5cb7b531d06cceb89fd21b1c"
},
{
"aaaManaged": true,
"groupId": "5cb7b531d06cceb89fd21b1c"
}
],
"assignedRoles": [
{
"roleId": "5cb7b531d06cceb89fd21b1c"
},
{
"roleId": "5cb7b531d06cceb89fd21b1c"
},
{
"roleId": "5cb7b531d06cceb89fd21b1c"
}
],
"inactive": true,
"_meta": {
"created": "2018-08-02T15:56:12.912Z",
"updated": "2018-08-02T15:56:12.912Z"
}
},
"total": 50
}