(408) 943-4100               V   Commercial Support


  1 minute read.

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


Simplification for renaming a server group to a different name. If a group with the new name exists, then this will effectively “merge” the old group into the new one.

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

Input Arguments

  • Required:
    • “groupname_old” : (String) Existing name for the group.
    • “groupname_new” : (String) New name for the group.
  • Optional:
    • none ({})

Request Example Arguments

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

  "groupname_old" : "group01",
  "groupname_new" : "group_1"

Reply Example

  "result" : "success",
  "group_renamed" : "group01",
  "new_group" : "group_1"


This API call will generate a standard “servers/list_groups” event due to the group name changes. See the servers/list_groups API documentation for event formatting and examples.

Log Summary

Log entries for this API call will have the following “summary” object.

"summary" : {
  "action" : "servers/groups_rename",
  "added_by_username" : "admin_user",
  "added_by_uuid" : "admin_user_uuid",
  "group_renamed" : "group01",
  "new_group" : "group_1"

See Also