DELETE Discovery/{guid}
Deletes a Network Discovery job including all stored results. If the Discovery job is pending or currently in progress, this method cancels the job, removes all associated data, and deletes the Discovery object. For help making the correct API calls to delete data, see Deleting data via the Web SDK.
BEST PRACTICE Run DELETE Discovery/{guid} when the Network Discovery job is not currently running. Otherwise, partial scan results can appear in the Policy tree. For more information, see Managing discovery jobs.
Requirements
- Permissions: The caller must have Delete permission to the requested object.
- Token scope: Certificate:Delete
Headers
-
Content type: Content-Type:application/json.
- Token: The bearer access token that you received. For example, Authorization:Bearer 4MyGeneratedBearerTknz==. For more information, see Passing a bearer token in your API calls.
Parameters
Name |
Description |
---|---|
{guid} |
In the request URL, specify the GUID of the Network Discovery job. For example:
|
Returns
Name |
Description |
---|---|
Success |
The status of job deletion:
|
Error |
The reason for failure. If Discovery/Delete{guid} ran successfully, this field is omitted.
|
Example: Delete a Network Discovery job
Request
DELETE https://tpp.venafi.example/vedsdk/Discovery/{fdb929ee-07eb-48bd-8610-b5f2cc43de7f} Authorization:Bearer 4MyGeneratedBearerTknz==
Response
HTTP/1.1 200 OK { "Success":true }