Package org.opensearch.client.opensearch.core

Class DeleteByQueryRequest.Builder

java.lang.Object

org.opensearch.client.util.ObjectBuilderBase

org.opensearch.client.opensearch._types.RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>

org.opensearch.client.opensearch.core.DeleteByQueryRequest.Builder

All Implemented Interfaces:

CopyableBuilder<DeleteByQueryRequest.Builder,DeleteByQueryRequest>, MutableBuilder<DeleteByQueryRequest.Builder,DeleteByQueryRequest>, ObjectBuilder<DeleteByQueryRequest>

Enclosing class:

DeleteByQueryRequest

public static class DeleteByQueryRequest.Builder
extends RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>
implements CopyableBuilder<DeleteByQueryRequest.Builder,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 indexes.
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.
DeleteByQueryRequest.Builder	copy()	Create a new builder CopyableBuilder that is a copy of this one.
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(List<ExpandWildcard> list)	Type of index that wildcard patterns can match.
final DeleteByQueryRequest.Builder	expandWildcards(ExpandWildcard value, ExpandWildcard... values)	Type of index that wildcard patterns can match.
final DeleteByQueryRequest.Builder	from(Integer value)	Starting offset.
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, indexes, and aliases to search.
final DeleteByQueryRequest.Builder	index(List<String> list)	Required - Comma-separated list of data streams, indexes, 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(Integer 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(Function<Query.Builder,ObjectBuilder<Query>> fn)	API name: query
final DeleteByQueryRequest.Builder	query(Query value)	API name: query
final DeleteByQueryRequest.Builder	refresh(Refresh value)	If true, OpenSearch 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, String... values)	Custom value used to route operations to a specific shard.
final DeleteByQueryRequest.Builder	routing(List<String> list)	Custom value used to route operations to a specific shard.
final DeleteByQueryRequest.Builder	scroll(Function<Time.Builder,ObjectBuilder<Time>> fn)	Period to retain the search context for scrolling.
final DeleteByQueryRequest.Builder	scroll(Time value)	Period to retain the search context for scrolling.
final DeleteByQueryRequest.Builder	scrollSize(Integer value)	Size of the scroll request that powers the operation.
final DeleteByQueryRequest.Builder	searchTimeout(Function<Time.Builder,ObjectBuilder<Time>> fn)	Explicit timeout for each search request.
final DeleteByQueryRequest.Builder	searchTimeout(Time value)	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	size(Integer value)	Deprecated, use max_docs instead.
final DeleteByQueryRequest.Builder	slice(Function<SlicedScroll.Builder,ObjectBuilder<SlicedScroll>> fn)	API name: slice
final DeleteByQueryRequest.Builder	slice(SlicedScroll value)	API name: slice
final DeleteByQueryRequest.Builder	slices(Function<Slices.Builder,ObjectBuilder<Slices>> fn)	The number of slices this task should be divided into.
final DeleteByQueryRequest.Builder	slices(Slices value)	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	source(Function<SourceConfigParam.Builder,ObjectBuilder<SourceConfigParam>> fn)	Set to true or false to return the _source field or not, or a list of fields to return.
final DeleteByQueryRequest.Builder	source(SourceConfigParam value)	Set to true or false to return the _source field or not, or a list of fields to return.
final DeleteByQueryRequest.Builder	sourceExcludes(String value, String... values)	List of fields to exclude from the returned _source field.
final DeleteByQueryRequest.Builder	sourceExcludes(List<String> list)	List of fields to exclude from the returned _source field.
final DeleteByQueryRequest.Builder	sourceIncludes(String value, String... values)	List of fields to extract and return from the _source field.
final DeleteByQueryRequest.Builder	sourceIncludes(List<String> list)	List of fields to extract and return from the _source field.
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(Integer value)	Maximum number of documents to collect for each shard.
final DeleteByQueryRequest.Builder	timeout(Function<Time.Builder,ObjectBuilder<Time>> fn)	Period each deletion request waits for active shards.
final DeleteByQueryRequest.Builder	timeout(Time value)	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(Function<WaitForActiveShards.Builder,ObjectBuilder<WaitForActiveShards>> fn)	The number of shard copies that must be active before proceeding with the operation.
final DeleteByQueryRequest.Builder	waitForActiveShards(WaitForActiveShards value)	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 org.opensearch.client.opensearch._types.RequestBase.AbstractBuilder

errorTrace, human

Methods inherited from class org.opensearch.client.util.ObjectBuilderBase

_checkSingleUse, _listAdd, _listAddAll, _listCopy, _mapCopy, _mapPut, _mapPutAll

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensearch.client.util.MutableBuilder

applyMutation

Constructor Details

Builder

public Builder()

Method Details

copy

@Nonnull
public DeleteByQueryRequest.Builder copy()

Description copied from interface: CopyableBuilder

Create a new builder CopyableBuilder that is a copy of this one.

Specified by:

copy in interface CopyableBuilder<DeleteByQueryRequest.Builder,DeleteByQueryRequest>

Returns:

a new builder instance.

self

@Nonnull
protected DeleteByQueryRequest.Builder self()

Specified by:

self in class RequestBase.AbstractBuilder<DeleteByQueryRequest.Builder>

allowNoIndices

@Nonnull
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 indexes. This behavior applies even if the request targets other open indexes. 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

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

If true, wildcard and prefix queries are analyzed.

API name: analyze_wildcard

analyzer

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

Analyzer to use for the query string.

API name: analyzer

conflicts

@Nonnull
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

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

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

API name: default_operator

df

@Nonnull
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

@Nonnull
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

@Nonnull
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

@Nonnull
public final DeleteByQueryRequest.Builder from(@Nullable
 Integer value)

Starting offset.

API name: from

ignoreUnavailable

@Nonnull
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

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

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

API name: index

Adds all elements of list to index.

index

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

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

API name: index

Adds one or more values to index.

lenient

@Nonnull
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

@Nonnull
public final DeleteByQueryRequest.Builder maxDocs(@Nullable
 Integer value)

The maximum number of documents to delete.

API name: max_docs

preference

@Nonnull
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

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

Query in the Lucene query string syntax.

API name: q

query

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

API name: query

query

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

API name: query

refresh

@Nonnull
public final DeleteByQueryRequest.Builder refresh(@Nullable
 Refresh value)

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

API name: refresh

requestCache

@Nonnull
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

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

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

API name: requests_per_second

routing

@Nonnull
public final DeleteByQueryRequest.Builder routing(List<String> list)

Custom value used to route operations to a specific shard.

API name: routing

Adds all elements of list to routing.

routing

@Nonnull
public final DeleteByQueryRequest.Builder routing(String value,
 String... values)

Custom value used to route operations to a specific shard.

API name: routing

Adds one or more values to routing.

scroll

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

Period to retain the search context for scrolling.

API name: scroll

scroll

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

Period to retain the search context for scrolling.

API name: scroll

scrollSize

@Nonnull
public final DeleteByQueryRequest.Builder scrollSize(@Nullable
 Integer value)

Size of the scroll request that powers the operation.

API name: scroll_size

searchTimeout

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

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

API name: search_timeout

searchTimeout

@Nonnull
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

@Nonnull
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

size

@Nonnull
public final DeleteByQueryRequest.Builder size(@Nullable
 Integer value)

Deprecated, use max_docs instead.

API name: size

slice

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

API name: slice

slice

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

API name: slice

slices

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

The number of slices this task should be divided into.

API name: slices

slices

@Nonnull
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

@Nonnull
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

@Nonnull
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.

source

@Nonnull
public final DeleteByQueryRequest.Builder source(@Nullable
 SourceConfigParam value)

Set to true or false to return the _source field or not, or a list of fields to return.

API name: _source

source

@Nonnull
public final DeleteByQueryRequest.Builder source(Function<SourceConfigParam.Builder,ObjectBuilder<SourceConfigParam>> fn)

Set to true or false to return the _source field or not, or a list of fields to return.

API name: _source

sourceExcludes

@Nonnull
public final DeleteByQueryRequest.Builder sourceExcludes(List<String> list)

List of fields to exclude from the returned _source field.

API name: _source_excludes

Adds all elements of list to sourceExcludes.

sourceExcludes

@Nonnull
public final DeleteByQueryRequest.Builder sourceExcludes(String value,
 String... values)

List of fields to exclude from the returned _source field.

API name: _source_excludes

Adds one or more values to sourceExcludes.

sourceIncludes

@Nonnull
public final DeleteByQueryRequest.Builder sourceIncludes(List<String> list)

List of fields to extract and return from the _source field.

API name: _source_includes

Adds all elements of list to sourceIncludes.

sourceIncludes

@Nonnull
public final DeleteByQueryRequest.Builder sourceIncludes(String value,
 String... values)

List of fields to extract and return from the _source field.

API name: _source_includes

Adds one or more values to sourceIncludes.

stats

@Nonnull
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

@Nonnull
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

@Nonnull
public final DeleteByQueryRequest.Builder terminateAfter(@Nullable
 Integer value)

Maximum number of documents to collect for each shard. If a query reaches this limit, OpenSearch terminates the query early. OpenSearch collects documents before sorting. Use with caution. OpenSearch applies this parameter to each shard handling the request. When possible, let OpenSearch perform early termination automatically. Avoid specifying this parameter for requests that target data streams with backing indexes across multiple data tiers.

API name: terminate_after

timeout

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

Period each deletion request waits for active shards.

API name: timeout

timeout

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

Period each deletion request waits for active shards.

API name: timeout

version

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

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

API name: version

waitForActiveShards

@Nonnull
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

@Nonnull
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

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

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

API name: wait_for_completion

build

@Nonnull
public DeleteByQueryRequest build()

Builds a DeleteByQueryRequest.

Specified by:

build in interface ObjectBuilder<DeleteByQueryRequest>

Throws:

NullPointerException - if some of the required fields are null.