Package co.elastic.clients.elasticsearch.core

Class DeleteByQueryRequest.Builder

java.lang.Object

co.elastic.clients.util.ObjectBuilderBase

co.elastic.clients.util.WithJsonObjectBuilderBase<BuilderT>

co.elastic.clients.elasticsearch._types.RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>

co.elastic.clients.elasticsearch.core.DeleteByQueryRequest.Builder

All Implemented Interfaces:

WithJson<DeleteByQueryRequest.Builder>, ObjectBuilder<DeleteByQueryRequest>

Enclosing class:

DeleteByQueryRequest

public static class DeleteByQueryRequest.Builder
extends RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>
implements ObjectBuilder<DeleteByQueryRequest>

Builder for DeleteByQueryRequest.

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
final DeleteByQueryRequest.Builder	allowNoIndices(Boolean value)	If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices.
final DeleteByQueryRequest.Builder	analyzer(String value)	Analyzer to use for the query string.
final DeleteByQueryRequest.Builder	analyzeWildcard(Boolean value)	If true, wildcard and prefix queries are analyzed.
DeleteByQueryRequest	build()	Builds a DeleteByQueryRequest.
final DeleteByQueryRequest.Builder	conflicts(Conflicts value)	What to do if delete by query hits version conflicts: abort or proceed.
final DeleteByQueryRequest.Builder	defaultOperator(Operator value)	The default operator for query string query: AND or OR.
final DeleteByQueryRequest.Builder	df(String value)	Field to use as default where no field prefix is given in the query string.
final DeleteByQueryRequest.Builder	expandWildcards(ExpandWildcard value, ExpandWildcard... values)	Type of index that wildcard patterns can match.
final DeleteByQueryRequest.Builder	expandWildcards(List<ExpandWildcard> list)	Type of index that wildcard patterns can match.
final DeleteByQueryRequest.Builder	from(Long value)	Starting offset (default: 0)
final DeleteByQueryRequest.Builder	ignoreUnavailable(Boolean value)	If false, the request returns an error if it targets a missing or closed index.
final DeleteByQueryRequest.Builder	index(String value, String... values)	Required - Comma-separated list of data streams, indices, and aliases to search.
final DeleteByQueryRequest.Builder	index(List<String> list)	Required - Comma-separated list of data streams, indices, and aliases to search.
final DeleteByQueryRequest.Builder	lenient(Boolean value)	If true, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
final DeleteByQueryRequest.Builder	maxDocs(Long value)	The maximum number of documents to delete.
final DeleteByQueryRequest.Builder	preference(String value)	Specifies the node or shard the operation should be performed on.
final DeleteByQueryRequest.Builder	q(String value)	Query in the Lucene query string syntax.
final DeleteByQueryRequest.Builder	query(Query value)	Specifies the documents to delete using the Query DSL.
final DeleteByQueryRequest.Builder	query(Function<Query.Builder,ObjectBuilder<Query>> fn)	Specifies the documents to delete using the Query DSL.
final DeleteByQueryRequest.Builder	refresh(Boolean value)	If true, Elasticsearch refreshes all shards involved in the delete by query after the request completes.
final DeleteByQueryRequest.Builder	requestCache(Boolean value)	If true, the request cache is used for this request.
final DeleteByQueryRequest.Builder	requestsPerSecond(Float value)	The throttle for this request in sub-requests per second.
final DeleteByQueryRequest.Builder	routing(String value)	Custom value used to route operations to a specific shard.
final DeleteByQueryRequest.Builder	scroll(Time value)	Period to retain the search context for scrolling.
final DeleteByQueryRequest.Builder	scroll(Function<Time.Builder,ObjectBuilder<Time>> fn)	Period to retain the search context for scrolling.
final DeleteByQueryRequest.Builder	scrollSize(Long value)	Size of the scroll request that powers the operation.
final DeleteByQueryRequest.Builder	searchTimeout(Time value)	Explicit timeout for each search request.
final DeleteByQueryRequest.Builder	searchTimeout(Function<Time.Builder,ObjectBuilder<Time>> fn)	Explicit timeout for each search request.
final DeleteByQueryRequest.Builder	searchType(SearchType value)	The type of the search operation.
protected DeleteByQueryRequest.Builder	self()
final DeleteByQueryRequest.Builder	slice(SlicedScroll value)	Slice the request manually using the provided slice ID and total number of slices.
final DeleteByQueryRequest.Builder	slice(Function<SlicedScroll.Builder,ObjectBuilder<SlicedScroll>> fn)	Slice the request manually using the provided slice ID and total number of slices.
final DeleteByQueryRequest.Builder	slices(Slices value)	The number of slices this task should be divided into.
final DeleteByQueryRequest.Builder	slices(Function<Slices.Builder,ObjectBuilder<Slices>> fn)	The number of slices this task should be divided into.
final DeleteByQueryRequest.Builder	sort(String value, String... values)	A comma-separated list of <field>:<direction> pairs.
final DeleteByQueryRequest.Builder	sort(List<String> list)	A comma-separated list of <field>:<direction> pairs.
final DeleteByQueryRequest.Builder	stats(String value, String... values)	Specific tag of the request for logging and statistical purposes.
final DeleteByQueryRequest.Builder	stats(List<String> list)	Specific tag of the request for logging and statistical purposes.
final DeleteByQueryRequest.Builder	terminateAfter(Long value)	Maximum number of documents to collect for each shard.
final DeleteByQueryRequest.Builder	timeout(Time value)	Period each deletion request waits for active shards.
final DeleteByQueryRequest.Builder	timeout(Function<Time.Builder,ObjectBuilder<Time>> fn)	Period each deletion request waits for active shards.
final DeleteByQueryRequest.Builder	version(Boolean value)	If true, returns the document version as part of a hit.
final DeleteByQueryRequest.Builder	waitForActiveShards(WaitForActiveShards value)	The number of shard copies that must be active before proceeding with the operation.
final DeleteByQueryRequest.Builder	waitForActiveShards(Function<WaitForActiveShards.Builder,ObjectBuilder<WaitForActiveShards>> fn)	The number of shard copies that must be active before proceeding with the operation.
final DeleteByQueryRequest.Builder	waitForCompletion(Boolean value)	If true, the request blocks until the operation is complete.

Methods inherited from class co.elastic.clients.util.WithJsonObjectBuilderBase

withJson

Methods inherited from class co.elastic.clients.util.ObjectBuilderBase

_checkSingleUse, _listAdd, _listAddAll, _mapPut, _mapPutAll

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface co.elastic.clients.json.WithJson

withJson, withJson

Constructor Details

Builder

public Builder()

Method Details

allowNoIndices

public final DeleteByQueryRequest.Builder allowNoIndices(@Nullable
 Boolean value)

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.

API name: allow_no_indices

analyzeWildcard

public final DeleteByQueryRequest.Builder analyzeWildcard(@Nullable
 Boolean value)

If true, wildcard and prefix queries are analyzed.

API name: analyze_wildcard

analyzer

public final DeleteByQueryRequest.Builder analyzer(@Nullable
 String value)

Analyzer to use for the query string.

API name: analyzer

conflicts

public final DeleteByQueryRequest.Builder conflicts(@Nullable
 Conflicts value)

What to do if delete by query hits version conflicts: abort or proceed.

API name: conflicts

defaultOperator

public final DeleteByQueryRequest.Builder defaultOperator(@Nullable
 Operator value)

The default operator for query string query: AND or OR.

API name: default_operator

df

public final DeleteByQueryRequest.Builder df(@Nullable
 String value)

Field to use as default where no field prefix is given in the query string.

API name: df

expandWildcards

public final DeleteByQueryRequest.Builder expandWildcards(List<ExpandWildcard> list)

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. Supports comma-separated values, such as open,hidden. Valid values are: all, open, closed, hidden, none.

API name: expand_wildcards

Adds all elements of list to expandWildcards.

expandWildcards

public final DeleteByQueryRequest.Builder expandWildcards(ExpandWildcard value,
 ExpandWildcard... values)

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. Supports comma-separated values, such as open,hidden. Valid values are: all, open, closed, hidden, none.

API name: expand_wildcards

Adds one or more values to expandWildcards.

from

public final DeleteByQueryRequest.Builder from(@Nullable
 Long value)

Starting offset (default: 0)

API name: from

ignoreUnavailable

public final DeleteByQueryRequest.Builder ignoreUnavailable(@Nullable
 Boolean value)

If false, the request returns an error if it targets a missing or closed index.

API name: ignore_unavailable

index

public final DeleteByQueryRequest.Builder index(List<String> list)

Required - Comma-separated list of data streams, indices, and aliases to search. Supports wildcards (*). To search all data streams or indices, omit this parameter or use * or _all.

API name: index

Adds all elements of list to index.

index

public final DeleteByQueryRequest.Builder index(String value,
 String... values)

Required - Comma-separated list of data streams, indices, and aliases to search. Supports wildcards (*). To search all data streams or indices, omit this parameter or use * or _all.

API name: index

Adds one or more values to index.

lenient

public final DeleteByQueryRequest.Builder lenient(@Nullable
 Boolean value)

If true, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.

API name: lenient

maxDocs

public final DeleteByQueryRequest.Builder maxDocs(@Nullable
 Long value)

The maximum number of documents to delete.

API name: max_docs

preference

public final DeleteByQueryRequest.Builder preference(@Nullable
 String value)

Specifies the node or shard the operation should be performed on. Random by default.

API name: preference

q

public final DeleteByQueryRequest.Builder q(@Nullable
 String value)

Query in the Lucene query string syntax.

API name: q

query

public final DeleteByQueryRequest.Builder query(@Nullable
 Query value)

Specifies the documents to delete using the Query DSL.

API name: query

query

public final DeleteByQueryRequest.Builder query(Function<Query.Builder,ObjectBuilder<Query>> fn)

Specifies the documents to delete using the Query DSL.

API name: query

refresh

public final DeleteByQueryRequest.Builder refresh(@Nullable
 Boolean value)

If true, Elasticsearch refreshes all shards involved in the delete by query after the request completes.

API name: refresh

requestCache

public final DeleteByQueryRequest.Builder requestCache(@Nullable
 Boolean value)

If true, the request cache is used for this request. Defaults to the index-level setting.

API name: request_cache

requestsPerSecond

public final DeleteByQueryRequest.Builder requestsPerSecond(@Nullable
 Float value)

The throttle for this request in sub-requests per second.

API name: requests_per_second

routing

public final DeleteByQueryRequest.Builder routing(@Nullable
 String value)

Custom value used to route operations to a specific shard.

API name: routing

scroll

public final DeleteByQueryRequest.Builder scroll(@Nullable
 Time value)

Period to retain the search context for scrolling.

API name: scroll

scroll

public final DeleteByQueryRequest.Builder scroll(Function<Time.Builder,ObjectBuilder<Time>> fn)

Period to retain the search context for scrolling.

API name: scroll

scrollSize

public final DeleteByQueryRequest.Builder scrollSize(@Nullable
 Long value)

Size of the scroll request that powers the operation.

API name: scroll_size

searchTimeout

public final DeleteByQueryRequest.Builder searchTimeout(@Nullable
 Time value)

Explicit timeout for each search request. Defaults to no timeout.

API name: search_timeout

searchTimeout

public final DeleteByQueryRequest.Builder searchTimeout(Function<Time.Builder,ObjectBuilder<Time>> fn)

Explicit timeout for each search request. Defaults to no timeout.

API name: search_timeout

searchType

public final DeleteByQueryRequest.Builder searchType(@Nullable
 SearchType value)

The type of the search operation. Available options: query_then_fetch, dfs_query_then_fetch.

API name: search_type

slice

public final DeleteByQueryRequest.Builder slice(@Nullable
 SlicedScroll value)

Slice the request manually using the provided slice ID and total number of slices.

API name: slice

slice

public final DeleteByQueryRequest.Builder slice(Function<SlicedScroll.Builder,ObjectBuilder<SlicedScroll>> fn)

Slice the request manually using the provided slice ID and total number of slices.

API name: slice

slices

public final DeleteByQueryRequest.Builder slices(@Nullable
 Slices value)

The number of slices this task should be divided into.

API name: slices

slices

public final DeleteByQueryRequest.Builder slices(Function<Slices.Builder,ObjectBuilder<Slices>> fn)

The number of slices this task should be divided into.

API name: slices

sort

public final DeleteByQueryRequest.Builder sort(List<String> list)

A comma-separated list of <field>:<direction> pairs.

API name: sort

Adds all elements of list to sort.

sort

public final DeleteByQueryRequest.Builder sort(String value,
 String... values)

A comma-separated list of <field>:<direction> pairs.

API name: sort

Adds one or more values to sort.

stats

public final DeleteByQueryRequest.Builder stats(List<String> list)

Specific tag of the request for logging and statistical purposes.

API name: stats

Adds all elements of list to stats.

stats

public final DeleteByQueryRequest.Builder stats(String value,
 String... values)

Specific tag of the request for logging and statistical purposes.

API name: stats

Adds one or more values to stats.

terminateAfter

public final DeleteByQueryRequest.Builder terminateAfter(@Nullable
 Long value)

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.

API name: terminate_after

timeout

public final DeleteByQueryRequest.Builder timeout(@Nullable
 Time value)

Period each deletion request waits for active shards.

API name: timeout

timeout

public final DeleteByQueryRequest.Builder timeout(Function<Time.Builder,ObjectBuilder<Time>> fn)

Period each deletion request waits for active shards.

API name: timeout

version

public final DeleteByQueryRequest.Builder version(@Nullable
 Boolean value)

If true, returns the document version as part of a hit.

API name: version

waitForActiveShards

public final DeleteByQueryRequest.Builder waitForActiveShards(@Nullable
 WaitForActiveShards value)

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).

API name: wait_for_active_shards

waitForActiveShards

public final DeleteByQueryRequest.Builder waitForActiveShards(Function<WaitForActiveShards.Builder,ObjectBuilder<WaitForActiveShards>> fn)

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).

API name: wait_for_active_shards

waitForCompletion

public final DeleteByQueryRequest.Builder waitForCompletion(@Nullable
 Boolean value)

If true, the request blocks until the operation is complete.

API name: wait_for_completion

self

protected DeleteByQueryRequest.Builder self()

Specified by:

self in class RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>

build

public DeleteByQueryRequest build()

Builds a DeleteByQueryRequest.

Specified by:

build in interface ObjectBuilder<DeleteByQueryRequest>

Throws:

NullPointerException - if some of the required fields are null.