(408) 943-4100               V   Commercial Support

servers/list_groups

  1 minute read.

Last Modified 2021-02-04 11:38 EST
NamespaceNameAdmin OnlyLog SummaryGenerates EventVersion Added
serverslist_groupsnonoYes1

Description

List all the current groups and which servers are associated with each group. If a non-administrator makes this API call, it will only return information about the groups that the user currently has access to see.

NOTE: Administrator access requirement removed in version 1.2

Input Arguments

  • Required:
    • none ({})
  • Optional:
    • none ({})

Request Example Arguments

ARGUMENTS ONLY: See the basics of API requests for additional formatting information.

{}

Reply Example

{
  "group1" : ["server_1", "server_2"],
  "group2" : ["server_1", "server_3"],
  "group3" : ["server_4"]
}

Events

Events will be sent to all currently-connected administrators when the list of groups on the system is changed via any of the servers/groups_* API calls.

Example event message:

{
"namespace" : "event",
"name" : "servers/list_groups",
"id" : "",
"args" : {
  "group1" : ["server_1", "server_2"],
  "group2" : ["server_1", "server_3"],
  "group3" : ["server_4"]
  }
}

Log Summary

This API call does not generate a detailed log summary item

See Also