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 U11NTA35
DELETE /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