Package co.elastic.clients.elasticsearch._core

Class UpdateByQueryRequest

java.lang.Object
co.elastic.clients.elasticsearch._types.RequestBase
co.elastic.clients.elasticsearch._core.UpdateByQueryRequest
All Implemented Interfaces:
ElasticsearchCommonRequest, JsonpSerializable
@JsonpDeserializable
public final class UpdateByQueryRequest
extends RequestBase
implements JsonpSerializable

  • Nested Class Summary

    Nested Classes
    Modifier and Type Class Description
    static class  UpdateByQueryRequest.Builder
    Builder for UpdateByQueryRequest.

    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<UpdateByQueryRequest> _DESERIALIZER
    Json deserializer for UpdateByQueryRequest
    static Endpoint<UpdateByQueryRequest,​UpdateByQueryResponse,​ElasticsearchError> ENDPOINT
    Endpoint "update_by_query".

  • Constructor Summary

    Constructors
    Constructor Description
    UpdateByQueryRequest​(UpdateByQueryRequest.Builder builder)  
    UpdateByQueryRequest​(java.util.function.Function<UpdateByQueryRequest.Builder,​UpdateByQueryRequest.Builder> fn)  

  • 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()
    API name: conflicts
    DefaultOperator 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<ExpandWildcardOptions> 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
    java.lang.String pipeline()
    Ingest pipeline to set on index requests made by this action.
    java.lang.String preference()
    Specify the node or shard the operation should be performed on (default: random)
    Query query()
    API name: query
    java.lang.Boolean refresh()
    Should the affected 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 to set on this request in sub-requests per second.
    java.lang.String routing()
    A comma-separated list of specific routing values
    jakarta.json.JsonValue script()
    API name: script
    java.lang.String 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 update by query
    java.lang.String 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 setupUpdateByQueryRequestDeserializer​(DelegatingDeserializer<UpdateByQueryRequest.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
    jakarta.json.JsonValue 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.
    java.lang.String 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
    java.lang.Boolean versionType()
    Should the document increment the version number (internal) on hit or not (reindex)
    jakarta.json.JsonValue waitForActiveShards()
    Sets the number of shard copies that must be active before proceeding with the update by query operation.
    java.lang.Boolean waitForCompletion()
    Should the request should block until the update by query operation is complete.

    Methods inherited from class java.lang.Object

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

  • Field Details

  • Constructor Details

  • Method Details

    • index

      public 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

    • type

      @Nullable public 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

    • allowNoIndices

      @Nullable public 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

    • analyzer

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

      API name: analyzer

    • analyzeWildcard

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

      API name: analyze_wildcard

    • defaultOperator

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

      API name: default_operator

    • df

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

      API name: df

    • expandWildcards

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

      API name: expand_wildcards

    • from

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

      API name: from

    • ignoreUnavailable

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

      API name: ignore_unavailable

    • lenient

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

      API name: lenient

    • pipeline

      @Nullable public java.lang.String pipeline()
      Ingest pipeline to set on index requests made by this action. (default: none)

      API name: pipeline

    • preference

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

      API name: preference

    • refresh

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

      API name: refresh

    • requestCache

      @Nullable public 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 java.lang.Long requestsPerSecond()
      The throttle to set on this request in sub-requests per second. -1 means no throttle.

      API name: requests_per_second

    • routing

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

      API name: routing

    • scroll

      @Nullable public java.lang.String scroll()
      Specify how long a consistent view of the index should be maintained for scrolled search

      API name: scroll

    • scrollSize

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

      API name: scroll_size

    • searchTimeout

      @Nullable public java.lang.String searchTimeout()
      Explicit timeout for each search request. Defaults to no timeout.

      API name: search_timeout

    • searchType

      @Nullable public SearchType searchType()
      Search operation type

      API name: search_type

    • size

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

      API name: size

    • slices

      @Nullable public 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

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

      API name: sort

    • source

      @Nullable public jakarta.json.JsonValue source()
      True or false to return the _source field or not, or a list of fields to return

      API name: _source

    • sourceExcludes

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

      API name: _source_excludes

    • sourceIncludes

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

      API name: _source_includes

    • stats

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

      API name: stats

    • terminateAfter

      @Nullable public 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 java.lang.String timeout()
      Time each individual bulk request should wait for shards that are unavailable.

      API name: timeout

    • version

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

      API name: version

    • versionType

      @Nullable public java.lang.Boolean versionType()
      Should the document increment the version number (internal) on hit or not (reindex)

      API name: version_type

    • waitForActiveShards

      @Nullable public jakarta.json.JsonValue waitForActiveShards()
      Sets the number of shard copies that must be active before proceeding with the update 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 java.lang.Boolean waitForCompletion()
      Should the request should block until the update by query operation is complete.

      API name: wait_for_completion

    • maxDocs

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

    • query

      @Nullable public Query query()
      API name: query

    • script

      @Nullable public jakarta.json.JsonValue script()
      API name: script

    • slice

      @Nullable public SlicedScroll slice()
      API name: slice

    • conflicts

      @Nullable public Conflicts conflicts()
      API name: conflicts

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

    • setupUpdateByQueryRequestDeserializer

      protected static void setupUpdateByQueryRequestDeserializer​(DelegatingDeserializer<UpdateByQueryRequest.Builder> op)