DELETE /api/topology/groups/{groupID}

Description

Delete a group from the topology.


Resource URL

https://localhost:8090/api/topology/groups/{groupID}
https://localhost:8090/api/topology/groups/{groupID}?deleteDiskGroup=false


Parameters

groupID mandatory The id of the group to delete.
deleteDiskGroup optional If true the group related files are removed off disk on all hosts that run API Servers in this group. This defaults to true.

Response Codes

Response Code Description
204 Success. Group is deleted.
400 The response contains an error e.g.:-
  • An attempt is made to delete a group that contains Node Managers.
  • A failure occurs while deleting group related files off disk on any of the hosts.
404 The response contains an error indicating that the group does not exist in the topology.
500 The response contains an error e.g. a failure occurred when propagating this topology update to other Node Managers.

Example Request and Response

DELETE https://localhost:8090/api/topology/groups/group-2

HTTP 1.1 204 No Content