Stop async ES|QL query
- POST /_query/async/{id}/stop
This API interrupts the query execution and returns the results so far. If the Elasticsearch security features are enabled, only the user who first submitted the ES|QL query can stop it.
Read the reference documentationPath Parameters
-
idstring Idrequired -
The unique identifier of the query. A query ID is provided in the ES|QL async query API response for a query that does not complete in the designated time. A query ID is also provided when the request was submitted with the
keep_on_completionparameter set totrue.
Query Parameters
-
drop_null_columnsboolean · default: false Indicates whether columns that are entirely
nullwill be removed from thecolumnsandvaluesportion of the results. Iftrue, the response will include an extra section under the nameall_columnswhich has the name of all the columns.
Response
-
tookDurationValueUnitMillis -
is_partialboolean -
all_columnsEsqlColumnInfo -
valuesFieldValuerequired -
_clustersEsqlClusterInfo -
Cross-cluster search information. Present if
include_ccs_metadatawastruein the request and a cross-cluster search was performed. -
totalnumberrequired -
successfulnumberrequired -
runningnumberrequired -
skippednumberrequired -
partialnumberrequired -
failednumberrequired -
detailsmap string to EsqlClusterDetailsrequired -
<string>EsqlClusterDetails -
statusEsqlClusterStatusrequired -
Values:
runningsuccessfulpartialskippedfailed -
indicesstringrequired -
tookDurationValueUnitMillis -
_shardsEsqlShardInfo -
totalnumberrequired -
successfulnumber -
skippednumber -
failednumber -
failuresEsqlShardFailure -
shardstring Idrequired -
indexstring IndexNamerequired -
nodestring -
reasonErrorCauserequired -
typestringrequired -
The type of error
-
reasonstringnullable -
A human-readable explanation of the error, in English.
-
stack_tracestring -
The server stack trace. Present only if the
error_trace=trueparameter was sent with the request. -
caused_byErrorCause -
root_causeErrorCause -
suppressedErrorCause -
profileobject -
Profiling information. Present if
profilewastruein the request. The contents of this field are currently unstable.