elasticsearch-js/docs/reference/api/DeleteByQueryRequest.md

Interface DeleteByQueryRequest

Name	Type	Description
allow_no_indices	boolean	If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.
analyze_wildcard	boolean	If true, wildcard and prefix queries are analyzed. This parameter can be used only when the q query string parameter is specified.
analyzer	string	Analyzer to use for the query string. This parameter can be used only when the q query string parameter is specified.
body	string	({ [key: string]: any; } & { index?: never; allow_no_indices?: never; analyzer?: never; analyze_wildcard?: never; conflicts?: never; default_operator?: never; df?: never; expand_wildcards?: never; from?: never; ignore_unavailable?: never; lenient?: never; preference?: never; refresh?: never; request_cache?: never; requests_per_second?: never; routing?: never; q?: never; scroll?: never; scroll_size?: never; search_timeout?: never; search_type?: never; slices?: never; sort?: never; stats?: never; terminate_after?: never; timeout?: never; version?: never; wait_for_active_shards?: never; wait_for_completion?: never; max_docs?: never; query?: never; slice?: never; })
conflicts	Conflicts	What to do if delete by query hits version conflicts: abort or proceed.
default_operator	QueryDslOperator	The default operator for query string query: AND or OR. This parameter can be used only when the q query string parameter is specified.
df	string	The field to use as default where no field prefix is given in the query string. This parameter can be used only when the q query string parameter is specified.
expand_wildcards	ExpandWildcards	The type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. It supports comma-separated values, such as open,hidden.
from	long	Skips the specified number of documents.
ignore_unavailable	boolean	If false, the request returns an error if it targets a missing or closed index.
index	Indices	A comma-separated list of data streams, indices, and aliases to search. It supports wildcards ( *). To search all data streams or indices, omit this parameter or use * or _all.
lenient	boolean	If true, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. This parameter can be used only when the q query string parameter is specified.
max_docs	long	The maximum number of documents to delete.
preference	string	The node or shard the operation should be performed on. It is random by default.
q	string	A query in the Lucene query string syntax.
query	QueryDslQueryContainer	The documents to delete specified with Query DSL.
querystring	{ [key: string]: any; } & { index?: never; allow_no_indices?: never; analyzer?: never; analyze_wildcard?: never; conflicts?: never; default_operator?: never; df?: never; expand_wildcards?: never; from?: never; ignore_unavailable?: never; lenient?: never; preference?: never; refresh?: never; request_cache?: never; requests_per_second?: never; routing?: never; q?: never; scroll?: never; scroll_size?: never; search_timeout?: never; search_type?: never; slices?: never; sort?: never; stats?: never; terminate_after?: never; timeout?: never; version?: never; wait_for_active_shards?: never; wait_for_completion?: never; max_docs?: never; query?: never; slice?: never; }	All values in querystring will be added to the request querystring.
refresh	boolean	If true, Elasticsearch refreshes all shards involved in the delete by query after the request completes. This is different than the delete API's refresh parameter, which causes just the shard that received the delete request to be refreshed. Unlike the delete API, it does not support wait_for.
request_cache	boolean	If true, the request cache is used for this request. Defaults to the index-level setting.
requests_per_second	float	The throttle for this request in sub-requests per second.
routing	Routing	A custom value used to route operations to a specific shard.
scroll_size	long	The size of the scroll request that powers the operation.
scroll	Duration	The period to retain the search context for scrolling.
search_timeout	Duration	The explicit timeout for each search request. It defaults to no timeout.
search_type	SearchType	The type of the search operation. Available options include query_then_fetch and dfs_query_then_fetch.
slice	SlicedScroll	Slice the request manually using the provided slice ID and total number of slices.
slices	Slices	The number of slices this task should be divided into.
sort	string[]	A comma-separated list of <field>:<direction> pairs.
stats	string[]	The specific tag of the request for logging and statistical purposes.
terminate_after	long	The maximum number of documents to collect for each shard. If a query reaches this limit, Elasticsearch terminates the query early. Elasticsearch collects documents before sorting. Use with caution. Elasticsearch applies this parameter to each shard handling the request. When possible, let Elasticsearch perform early termination automatically. Avoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers.
timeout	Duration	The period each deletion request waits for active shards.
version	boolean	If true, returns the document version as part of a hit.
wait_for_active_shards	WaitForActiveShards	The number of shard copies that must be active before proceeding with the operation. Set to all or any positive integer up to the total number of shards in the index ( number_of_replicas+1). The timeout value controls how long each write request waits for unavailable shards to become available.
wait_for_completion	boolean	If true, the request blocks until the operation is complete. If false, Elasticsearch performs some preflight checks, launches the request, and returns a task you can use to cancel or get the status of the task. Elasticsearch creates a record of this task as a document at .tasks/task/${taskId}. When you are done with a task, you should delete the task document so Elasticsearch can reclaim the space.