Class DeleteByQueryRequest

java.lang.Object
co.elastic.clients.elasticsearch._types.RequestBase
co.elastic.clients.elasticsearch.core.DeleteByQueryRequest
All Implemented Interfaces:
JsonpSerializable

@JsonpDeserializable
public class DeleteByQueryRequest
extends RequestBase
implements JsonpSerializable
Deletes documents matching the provided query.
See Also:
API specification
  • Nested Class Summary

    Nested Classes
    Modifier and Type Class Description
    static class  DeleteByQueryRequest.Builder

    Nested classes/interfaces inherited from class co.elastic.clients.elasticsearch._types.RequestBase

    RequestBase.AbstractBuilder<BuilderT extends RequestBase.AbstractBuilder<BuilderT>>
  • Field Summary

    Fields
    Modifier and Type Field Description
    static JsonpDeserializer<DeleteByQueryRequest> _DESERIALIZER
    Json deserializer for DeleteByQueryRequest
    static Endpoint<DeleteByQueryRequest,​DeleteByQueryResponse,​ErrorResponse> _ENDPOINT
    Endpoint "delete_by_query".
  • Method Summary

    Modifier and Type Method Description
    java.lang.Boolean allowNoIndices()
    Whether to ignore if a wildcard indices expression resolves into no concrete indices.
    java.lang.String analyzer()
    The analyzer to use for the query string
    java.lang.Boolean analyzeWildcard()
    Specify whether wildcard and prefix queries should be analyzed (default: false)
    Conflicts conflicts()
    What to do when the delete by query hits version conflicts?
    Operator defaultOperator()
    The default operator for query string query (AND or OR)
    java.lang.String df()
    The field to use as default where no field prefix is given in the query string
    java.util.List<ExpandWildcard> expandWildcards()
    Whether to expand wildcard expression to concrete indices that are open, closed or both.
    java.lang.Long from()
    Starting offset (default: 0)
    java.lang.Boolean ignoreUnavailable()
    Whether specified concrete indices should be ignored when unavailable (missing or closed)
    java.util.List<java.lang.String> index()
    Required - A comma-separated list of index names to search; use _all or empty string to perform the operation on all indices
    java.lang.Boolean lenient()
    Specify whether format-based query failures (such as providing text to a numeric field) should be ignored
    java.lang.Long maxDocs()
    API name: max_docs
    static DeleteByQueryRequest of​(java.util.function.Function<DeleteByQueryRequest.Builder,​ObjectBuilder<DeleteByQueryRequest>> fn)  
    java.lang.String preference()
    Specify the node or shard the operation should be performed on (default: random)
    java.lang.String q()
    Query in the Lucene query string syntax
    Query query()
    API name: query
    java.lang.Boolean refresh()
    Should the effected indexes be refreshed?
    java.lang.Boolean requestCache()
    Specify if request cache should be used for this request or not, defaults to index level setting
    java.lang.Long requestsPerSecond()
    The throttle for this request in sub-requests per second.
    java.lang.String routing()
    A comma-separated list of specific routing values
    Time scroll()
    Specify how long a consistent view of the index should be maintained for scrolled search
    java.lang.Long scrollSize()
    Size on the scroll request powering the delete by query
    Time searchTimeout()
    Explicit timeout for each search request.
    SearchType searchType()
    Search operation type
    void serialize​(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)
    Serialize this object to JSON.
    protected void serializeInternal​(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)  
    protected static void setupDeleteByQueryRequestDeserializer​(ObjectDeserializer<DeleteByQueryRequest.Builder> op)  
    java.lang.Long size()
    Deprecated, please use max_docs instead
    SlicedScroll slice()
    API name: slice
    java.lang.Long slices()
    The number of slices this task should be divided into.
    java.util.List<java.lang.String> sort()
    A comma-separated list of <field>:<direction> pairs
    SourceConfigParam source()
    True or false to return the _source field or not, or a list of fields to return
    java.util.List<java.lang.String> sourceExcludes()
    A list of fields to exclude from the returned _source field
    java.util.List<java.lang.String> sourceIncludes()
    A list of fields to extract and return from the _source field
    java.util.List<java.lang.String> stats()
    Specific 'tag' of the request for logging and statistical purposes
    java.lang.Long terminateAfter()
    The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.
    Time timeout()
    Time each individual bulk request should wait for shards that are unavailable.
    java.util.List<java.lang.String> type()
    A comma-separated list of document types to search; leave empty to perform the operation on all types
    java.lang.Boolean version()
    Specify whether to return document version as part of a hit
    WaitForActiveShards waitForActiveShards()
    Sets the number of shard copies that must be active before proceeding with the delete by query operation.
    java.lang.Boolean waitForCompletion()
    Should the request should block until the delete by query is complete.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

  • Method Details

    • of

      public static DeleteByQueryRequest of​(java.util.function.Function<DeleteByQueryRequest.Builder,​ObjectBuilder<DeleteByQueryRequest>> fn)
    • source

      @Nullable public final SourceConfigParam source()
      True or false to return the _source field or not, or a list of fields to return

      API name: _source

    • sourceExcludes

      public final java.util.List<java.lang.String> sourceExcludes()
      A list of fields to exclude from the returned _source field

      API name: _source_excludes

    • sourceIncludes

      public final java.util.List<java.lang.String> sourceIncludes()
      A list of fields to extract and return from the _source field

      API name: _source_includes

    • allowNoIndices

      @Nullable public final java.lang.Boolean allowNoIndices()
      Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes _all string or when no indices have been specified)

      API name: allow_no_indices

    • analyzeWildcard

      @Nullable public final java.lang.Boolean analyzeWildcard()
      Specify whether wildcard and prefix queries should be analyzed (default: false)

      API name: analyze_wildcard

    • analyzer

      @Nullable public final java.lang.String analyzer()
      The analyzer to use for the query string

      API name: analyzer

    • conflicts

      @Nullable public final Conflicts conflicts()
      What to do when the delete by query hits version conflicts?

      API name: conflicts

    • defaultOperator

      @Nullable public final Operator defaultOperator()
      The default operator for query string query (AND or OR)

      API name: default_operator

    • df

      @Nullable public final java.lang.String df()
      The field to use as default where no field prefix is given in the query string

      API name: df

    • expandWildcards

      public final java.util.List<ExpandWildcard> expandWildcards()
      Whether to expand wildcard expression to concrete indices that are open, closed or both.

      API name: expand_wildcards

    • from

      @Nullable public final java.lang.Long from()
      Starting offset (default: 0)

      API name: from

    • ignoreUnavailable

      @Nullable public final java.lang.Boolean ignoreUnavailable()
      Whether specified concrete indices should be ignored when unavailable (missing or closed)

      API name: ignore_unavailable

    • index

      public final java.util.List<java.lang.String> index()
      Required - A comma-separated list of index names to search; use _all or empty string to perform the operation on all indices

      API name: index

    • lenient

      @Nullable public final java.lang.Boolean lenient()
      Specify whether format-based query failures (such as providing text to a numeric field) should be ignored

      API name: lenient

    • maxDocs

      @Nullable public final java.lang.Long maxDocs()
      API name: max_docs
    • preference

      @Nullable public final java.lang.String preference()
      Specify the node or shard the operation should be performed on (default: random)

      API name: preference

    • q

      @Nullable public final java.lang.String q()
      Query in the Lucene query string syntax

      API name: q

    • query

      @Nullable public final Query query()
      API name: query
    • refresh

      @Nullable public final java.lang.Boolean refresh()
      Should the effected indexes be refreshed?

      API name: refresh

    • requestCache

      @Nullable public final java.lang.Boolean requestCache()
      Specify if request cache should be used for this request or not, defaults to index level setting

      API name: request_cache

    • requestsPerSecond

      @Nullable public final java.lang.Long requestsPerSecond()
      The throttle for this request in sub-requests per second. -1 means no throttle.

      API name: requests_per_second

    • routing

      @Nullable public final java.lang.String routing()
      A comma-separated list of specific routing values

      API name: routing

    • scroll

      @Nullable public final Time scroll()
      Specify how long a consistent view of the index should be maintained for scrolled search

      API name: scroll

    • scrollSize

      @Nullable public final java.lang.Long scrollSize()
      Size on the scroll request powering the delete by query

      API name: scroll_size

    • searchTimeout

      @Nullable public final Time searchTimeout()
      Explicit timeout for each search request. Defaults to no timeout.

      API name: search_timeout

    • searchType

      @Nullable public final SearchType searchType()
      Search operation type

      API name: search_type

    • size

      @Nullable public final java.lang.Long size()
      Deprecated, please use max_docs instead

      API name: size

    • slice

      @Nullable public final SlicedScroll slice()
      API name: slice
    • slices

      @Nullable public final java.lang.Long slices()
      The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to auto.

      API name: slices

    • sort

      public final java.util.List<java.lang.String> sort()
      A comma-separated list of <field>:<direction> pairs

      API name: sort

    • stats

      public final java.util.List<java.lang.String> stats()
      Specific 'tag' of the request for logging and statistical purposes

      API name: stats

    • terminateAfter

      @Nullable public final java.lang.Long terminateAfter()
      The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.

      API name: terminate_after

    • timeout

      @Nullable public final Time timeout()
      Time each individual bulk request should wait for shards that are unavailable.

      API name: timeout

    • type

      public final java.util.List<java.lang.String> type()
      A comma-separated list of document types to search; leave empty to perform the operation on all types

      API name: type

    • version

      @Nullable public final java.lang.Boolean version()
      Specify whether to return document version as part of a hit

      API name: version

    • waitForActiveShards

      @Nullable public final WaitForActiveShards waitForActiveShards()
      Sets the number of shard copies that must be active before proceeding with the delete by query operation. Defaults to 1, meaning the primary shard only. Set to all for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)

      API name: wait_for_active_shards

    • waitForCompletion

      @Nullable public final java.lang.Boolean waitForCompletion()
      Should the request should block until the delete by query is complete.

      API name: wait_for_completion

    • serialize

      public void serialize​(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)
      Serialize this object to JSON.
      Specified by:
      serialize in interface JsonpSerializable
    • serializeInternal

      protected void serializeInternal​(jakarta.json.stream.JsonGenerator generator, JsonpMapper mapper)
    • setupDeleteByQueryRequestDeserializer

      protected static void setupDeleteByQueryRequestDeserializer​(ObjectDeserializer<DeleteByQueryRequest.Builder> op)