(408) 943-4100               V   Commercial Support

servers/groups_remove

  1 minute read.

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

Description

Simplification for removing existing servers from existing groups

NOTE: Administrator access only - all others will get a 403/Forbidden error

Input Arguments

  • Required:
    • “[server_id]” : String or array of strings for groups which need to be removed from this server
  • Optional:
    • none ({})

Request Example Arguments

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

{
  "server_id_1" : "previous_group_1",
  "server_id_2" : [ "previous_group_2", "previous_group_3" ]
}
  • Example Group Assignments (initial, before example request)
  "server_id_1" : [ "previous_group_1", "previous_group_2" ],
  "server_id_2" : [ "previous_group_1", "previous_group_2" ]

Reply Example

{
  "server_id_1" : [ "previous_group_2" ],
  "server_id_2" : [ "previous_group_1" ]
}

Events

Events from this change will be sent to all administrators and any user with read access to this server.

Example:

{
"namespace" : "event",
"name" : "servers/edit",
"id" : "",
"args" : {}
}

Log Summary

This API call does not generate a detailed log summary item

See Also