DELETE: Delete a Saved Trace
Use the
NetMaster API Service
to delete a saved SmartTrace trace.The DELETE: Delete a Saved Trace endpoint deletes a saved SmartTrace trace, allowing you to clear un-needed saved traces. The following reference article includes:
- URI (Uniform Resource Identifier) Parameters
- Status Codes
- Sample Request and Response
URI Parameters
The URI for DELETE: Delete a Saved Trace is:
DELETE /api/v1/tcpip/{region}/smart/saved/{id}
Parameter | Description |
region | The NetMaster region |
id | The ID of the saved trace. Enter the trace ID for a saved trace in the format tracename-n , where "n" is the number of a saved trace for a specific trace definition. |
Status Codes
The following status codes can appear in the response to a DELETE: Delete a Saved Trace request:
- 204 No Content- The saved trace was deleted. No content is returned.
- 400 Bad Request- The saved trace could not be deleted due to an invalid format for the URI name parameter.
- 401 Unauthorized- The user is not authenticated to the application. They must provide either a valid login token or valid credentials before continuing.
- 403 Forbidden- The trace could not be deleted because the user does not have the appropriate authority to delete a saved SmartTrace.
- 404- A trace matching the URI id parameter was not found.
- 500 Server error
Sample Request and Response
Request:
The following syntax is a request to delete the SmartTrace with ID
ATRACE-1
, on NetMaster
region U11NTA35DELETE /api/v1/tcpip/U11NTA35/smart/saved/ATRACE-1
Response:
The following response indicates that the saved SmartTrace definition was deleted:
HTTP/1.1 204 NO CONTENT