DELETE /api/topology/services/{groupID}/{serviceID}

Description

Delete a service from the topology.


Resource URL

https://localhost:8090/api/topology/services/{groupID}/{serviceID}
https://localhost:8090/api/topology/services/{groupID}/{serviceID}?deleteDiskInstance=false


Parameters

groupID mandatory The id of the group that the service resides in.
serviceID mandatory The id of the service to delete.
deleteDiskInstance optional If true the disk files relating to the API Server instance are removed. This defaults to true.

Response Codes

Response Code Description
204 Success. Service is deleted.
400 The response contains an error e.g.:-
  • An attempt is made to delete node manager the API is running on.
  • A failure occurs while deleting instance related files off disk. This may happen if the API Server instance is running.
404 The response contains an error indicating that the service 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/services/group-2/instance-1

HTTP 1.1 204 No Content