elasticsearch/docs/reference/sql/apis/delete-async-sql-search-api.asciidoc
James Rodewig f56a0f4b66
[DOCS] Remove testenv annotations from doc snippet tests (#80023)
Removes `testenv` annotations and related code. These annotations originally let you skip x-pack snippet tests in the docs. However, that's no longer possible.

Relates to #79309, #31619
2021-11-05 18:38:50 -04:00

40 lines
1.1 KiB
Text

[role="xpack"]
[[delete-async-sql-search-api]]
=== Delete async SQL search API
++++
<titleabbrev>Delete async SQL search</titleabbrev>
++++
Deletes an <<sql-async,async SQL search>> or a <<sql-store-searches,stored
synchronous SQL search>>. If the search is still running, the API cancels it.
[source,console]
----
DELETE _sql/async/delete/FkpMRkJGS1gzVDRlM3g4ZzMyRGlLbkEaTXlJZHdNT09TU2VTZVBoNDM3cFZMUToxMDM=
----
// TEST[skip: no access to search ID]
[[delete-async-sql-search-api-request]]
==== {api-request-title}
`DELETE _sql/async/delete/<search_id>`
[[delete-async-sql-search-api-prereqs]]
==== {api-prereq-title}
* If the {es} {security-features} are enabled, only the following users can
use this API to delete a search:
** Users with the `cancel_task` <<privileges-list-cluster,cluster privilege>>
** The user who first submitted the search
[[delete-async-sql-search-api-limitations]]
===== Limitations
See <<sql-limitations>>.
[[delete-async-sql-search-api-path-params]]
==== {api-path-parms-title}
`<search_id>`::
(Required, string) Identifier for the search.