Deprecated API

• Deprecated Interfaces

  Interface and Description
  org.elasticsearch.river.River See blog post https://www.elastic.co/blog/deprecating_rivers
  org.elasticsearch.river.RiverComponent See blog post https://www.elastic.co/blog/deprecating_rivers

• Deprecated Classes

  Class and Description
  org.elasticsearch.river.AbstractRiverComponent See blog post https://www.elastic.co/blog/deprecating_rivers
  org.elasticsearch.index.codec.postingsformat.BloomFilterPostingsFormat only for reading old segments
  org.elasticsearch.index.codec.postingsformat.BloomFilterPostingsFormatProvider only for reading old segments
  org.elasticsearch.common.lucene.search.function.BoostScoreFunction
  org.elasticsearch.index.query.BytesFilterBuilder replace with WrapperFilterBuilder
  org.elasticsearch.common.compress.CompressedIndexInput Used only for backward comp. to read old compressed files, since we now use codec based compression
  org.elasticsearch.action.deletebyquery.DeleteByQueryAction Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.deletebyquery.DeleteByQueryRequest Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.deletebyquery.DeleteByQueryRequestBuilder Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.deletebyquery.DeleteByQueryResponse Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.cluster.routing.allocation.decider.DisableAllocationDecider In favour for EnableAllocationDecider.
  org.elasticsearch.action.admin.indices.status.DocsStatus
  org.elasticsearch.index.codec.postingsformat.Elasticsearch090PostingsFormat only for reading old segments
  org.elasticsearch.search.facet.FacetBuilders Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.index.query.functionscore.factor.FactorBuilder
  org.elasticsearch.index.query.functionscore.factor.FactorParser
  org.elasticsearch.index.query.FuzzyLikeThisFieldQueryBuilder this query was too costly and has been removed
  org.elasticsearch.index.query.FuzzyLikeThisQueryBuilder this query was too costly and has been removed
  org.elasticsearch.action.admin.indices.status.GatewayRecoveryStatus
  org.elasticsearch.action.admin.indices.status.GatewaySnapshotStatus
  org.elasticsearch.index.cache.id.IdCacheStats Id cache has been removed in favor for ParentChildIndexFieldData this class now reports field data memory usage for _parent field.
  org.elasticsearch.action.deletebyquery.IndexDeleteByQueryResponse Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.index.query.IndexQueryParserModule.QueryParsersProcessor query parsers should be registered globally via IndicesQueriesModule.addQuery(Class) instead
  org.elasticsearch.action.admin.indices.status.IndexShardStatus
  org.elasticsearch.action.admin.indices.status.IndexStatus
  org.elasticsearch.action.admin.indices.status.IndicesStatusAction
  org.elasticsearch.action.admin.indices.status.IndicesStatusRequest
  org.elasticsearch.action.admin.indices.status.IndicesStatusRequestBuilder
  org.elasticsearch.action.admin.indices.status.IndicesStatusResponse
  org.elasticsearch.index.query.LimitFilterBuilder Use SearchRequestBuilder.setTerminateAfter(int) instead.
  org.elasticsearch.common.compress.lzf.LZFCompressedIndexInput
  org.elasticsearch.action.mlt.MoreLikeThisAction The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.index.query.MoreLikeThisFieldQueryBuilder
  org.elasticsearch.index.query.MoreLikeThisFieldQueryParser
  org.elasticsearch.action.mlt.MoreLikeThisRequest The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.action.mlt.MoreLikeThisRequestBuilder The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.index.query.NumericRangeFilterBuilder This filter will be removed at some point in time in favor for the range filter with the execution mode fielddata.
  org.elasticsearch.index.query.NumericRangeFilterParser
  org.elasticsearch.action.admin.indices.status.PeerRecoveryStatus
  org.elasticsearch.rest.action.deletebyquery.RestDeleteByQueryAction Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.rest.action.admin.indices.alias.get.RestGetIndicesAliasesAction
  org.elasticsearch.rest.action.mlt.RestMoreLikeThisAction The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.river.RiverName See blog post https://www.elastic.co/blog/deprecating_rivers
  org.elasticsearch.index.merge.scheduler.SerialMergeSchedulerProvider This provider just provides ConcurrentMergeScheduler, and is removed in master.
  org.elasticsearch.action.deletebyquery.ShardDeleteByQueryRequest Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.deletebyquery.ShardDeleteByQueryResponse Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.admin.indices.status.ShardStatus
  org.elasticsearch.index.search.child.TopChildrenQuery
  org.elasticsearch.index.query.TopChildrenQueryBuilder
  org.elasticsearch.index.query.TopChildrenQueryParser
  org.elasticsearch.action.deletebyquery.TransportDeleteByQueryAction Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.deletebyquery.TransportIndexDeleteByQueryAction Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.action.admin.indices.status.TransportIndicesStatusAction
  org.elasticsearch.action.mlt.TransportMoreLikeThisAction The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.action.deletebyquery.TransportShardDeleteByQueryAction Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.

• Deprecated Enums

  Enum and Description
  org.elasticsearch.action.support.replication.ReplicationType will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171

• Deprecated Exceptions

  Exceptions and Description
  org.elasticsearch.index.engine.DeleteByQueryFailedEngineException Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.

• Deprecated Annotation Types

  Annotation Type and Description
  org.elasticsearch.common.inject.assistedinject.AssistedInject FactoryProvider now works better with the standard @Inject annotation. When using that annotation, parameters are matched by name and type rather than by position. In addition, values that use the standard @Inject constructor annotation are eligible for method interception.

• Deprecated Fields

  Field and Description
  org.apache.lucene.util.XIOUtils.CHARSET_UTF_8 Use StandardCharsets.UTF_8 instead.
  org.elasticsearch.indices.recovery.RecoverySettings.INDICES_RECOVERY_MAX_SIZE_PER_SEC

• Deprecated Methods

  Method and Description
  org.elasticsearch.action.search.SearchRequestBuilder.addFacet(FacetBuilder) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.admin.indices.get.GetIndexRequestBuilder.addFeatures(String...) use #addFeatures(Feature[]) instead
  org.elasticsearch.action.admin.indices.get.GetIndexRequest.addFeatures(String[]) use GetIndexRequest.addFeatures(Feature[]) instead
  org.elasticsearch.indices.query.IndicesQueriesModule.addFilter(FilterParser) use instead
  org.elasticsearch.indices.query.IndicesQueriesRegistry.addFilterParser(FilterParser) use instead
  org.elasticsearch.index.query.IndexQueryParserModule.addFilterParser(String, Class<? extends FilterParser>) use IndicesQueriesModule.addFilter(Class) instead
  org.elasticsearch.action.search.SearchRequestBuilder.addPartialField(String, String[], String[]) since 1.0.0 use SearchRequestBuilder.setFetchSource(String[], String[]) instead
  org.elasticsearch.action.search.SearchRequestBuilder.addPartialField(String, String, String) since 1.0.0 use SearchRequestBuilder.setFetchSource(String, String) instead
  org.elasticsearch.indices.query.IndicesQueriesModule.addQuery(QueryParser) use instead
  org.elasticsearch.indices.query.IndicesQueriesRegistry.addQueryParser(QueryParser) use instead
  org.elasticsearch.index.query.IndexQueryParserModule.addQueryParser(String, Class<? extends QueryParser>) use IndicesQueriesModule.addQuery(Class) instead
  org.elasticsearch.common.xcontent.XContentParser.bytes() use XContentParser.utf8Bytes() instead
  org.elasticsearch.index.query.FilterBuilders.bytesFilter(BytesReference) replace with FilterBuilders.wrapperFilter(byte[], int, int)
  org.elasticsearch.common.xcontent.XContentParser.bytesOrNull() use XContentParser.utf8BytesOrNull() instead
  org.elasticsearch.search.suggest.phrase.PhraseSuggestionBuilder.collateFilter(String)
  org.elasticsearch.index.query.QueryBuilders.commonTerms(String, Object) by commonTermsQuery(String, Object) Will be removed in elasticsearch 2.0.0
  org.elasticsearch.script.ScriptService.compile(String, String, ScriptService.ScriptType) use the method variant that accepts the ScriptContext argument too: ScriptService.compile(String, String, ScriptType, ScriptContext)
  org.elasticsearch.cluster.metadata.MetaData.concreteIndices(String[]) use MetaData.concreteIndices(org.elasticsearch.action.support.IndicesOptions, String...) instead and be explicit about indices options to be used for indices resolution
  org.elasticsearch.client.Client.deleteByQuery(DeleteByQueryRequest) Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.client.Client.deleteByQuery(DeleteByQueryRequest, ActionListener<DeleteByQueryResponse>) Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.script.ScriptService.executable(String, String, ScriptService.ScriptType, Map<String, Object>) use the method variant that accepts the ScriptContext argument too: ScriptService.executable(String, String, ScriptType, ScriptContext, Map)
  org.elasticsearch.index.query.functionscore.ScoreFunctionBuilders.factorFunction(float)
  org.elasticsearch.action.admin.indices.get.GetIndexRequest.features() use GetIndexRequest.featuresAsEnums() instead
  org.elasticsearch.action.admin.indices.get.GetIndexRequest.features(String[]) use GetIndexRequest.features(Feature[]) instead
  org.elasticsearch.common.xcontent.XContentBuilder.field(XContentBuilderString, BytesRef)
  org.elasticsearch.index.query.QueryBuilders.filtered(QueryBuilder, FilterBuilder) Use filteredQuery instead (rename) Will be removed in elasticsearch 2.0.0
  org.elasticsearch.common.lucene.store.FilterIndexOutput.flush()
  org.elasticsearch.action.admin.indices.refresh.RefreshRequest.force()
  org.elasticsearch.action.admin.indices.optimize.OptimizeRequest.force() See UpgradeRequest
  org.elasticsearch.action.admin.indices.refresh.RefreshRequest.force(boolean) unnecessary flag since 1.5.0
  org.elasticsearch.action.admin.indices.optimize.OptimizeRequest.force(boolean)
  org.elasticsearch.index.query.QueryBuilders.fuzzyLikeThisFieldQuery(String) this query was too costly and has been removed
  org.elasticsearch.index.query.QueryBuilders.fuzzyLikeThisQuery() this query was too costly and has been removed
  org.elasticsearch.index.query.QueryBuilders.fuzzyLikeThisQuery(String...) this query was too costly and has been removed
  org.elasticsearch.search.sort.FieldSortBuilder.ignoreUnmapped(boolean) Use FieldSortBuilder.unmappedType(String) instead.
  org.elasticsearch.common.compress.Compressor.indexInput(IndexInput) Used for backward comp. since we now use Lucene compressed codec.
  org.elasticsearch.env.NodeEnvironment.indexLocations(Index) use NodeEnvironment.indexPaths(org.elasticsearch.index.Index) instead
  org.elasticsearch.client.Requests.indicesStatusRequest(String...)
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, Collection<?>) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, double...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, float...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, int...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, long...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, Object...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.inQuery(String, String...) not used Will be removed in elasticsearch 2.0.0
  org.elasticsearch.action.support.IndicesOptions.lenient() in favor of IndicesOptions.lenientExpandOpen() whose name makes it clearer what the method actually does.
  org.elasticsearch.index.query.FilterBuilders.limitFilter(int) Use SearchRequestBuilder.setTerminateAfter(int) instead.
  org.elasticsearch.client.Client.moreLikeThis(MoreLikeThisRequest) The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.client.Client.moreLikeThis(MoreLikeThisRequest, ActionListener<SearchResponse>) The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.index.query.QueryBuilders.moreLikeThisFieldQuery(String) this query was too costly and has been removed
  org.elasticsearch.client.Requests.moreLikeThisRequest(String) The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.env.NodeEnvironment.nodeDataLocations() use NodeEnvironment.nodeDataPaths() instead
  org.elasticsearch.index.query.MatchAllQueryBuilder.normsField(String) the norms field is not supported since lucene 4. Will be removed in ES 2.0
  org.elasticsearch.index.query.FilterBuilders.numericRangeFilter(String) The numeric_range filter will be removed at some point in time in favor for the range filter with the execution mode fielddata.
  org.elasticsearch.common.xcontent.ToXContent.Params.paramAsBooleanOptional(String, Boolean) since 1.0.0 use ToXContent.Params.paramAsBoolean(String, Boolean) instead
  org.elasticsearch.common.xcontent.ToXContent.MapParams.paramAsBooleanOptional(String, Boolean)
  org.elasticsearch.common.xcontent.ToXContent.DelegatingMapParams.paramAsBooleanOptional(String, Boolean)
  org.elasticsearch.rest.RestRequest.paramAsBooleanOptional(String, Boolean)
  org.elasticsearch.search.builder.SearchSourceBuilder.partialField(String, String[], String[]) since 1.0.0 use SearchSourceBuilder.fetchSource(String[], String[]) instead
  org.elasticsearch.search.builder.SearchSourceBuilder.partialField(String, String, String) since 1.0.0 use SearchSourceBuilder.fetchSource(String, String) instead
  org.elasticsearch.action.mlt.MoreLikeThisRequest.percentTermsToMatch()
  org.elasticsearch.action.mlt.MoreLikeThisRequest.percentTermsToMatch(float)
  org.elasticsearch.index.query.MoreLikeThisQueryBuilder.percentTermsToMatch(float)
  org.elasticsearch.index.query.MoreLikeThisFieldQueryBuilder.percentTermsToMatch(float)
  org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramBuilder.postOffset(String) the postOffset option will be replaced by offset in future version.
  org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramBuilder.postZone(String) this option is going to be removed in 2.0 releases
  org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramBuilder.preOffset(String) the preOffset option will be replaced by offset in future version.
  org.elasticsearch.client.Client.prepareDeleteByQuery(String...) Delete by query will be removed in 2.0. Instead, use the scroll/scan API to find all matching IDs and then issue a bulk request to delete them.
  org.elasticsearch.client.Client.prepareMoreLikeThis(String, String, String) The More Like This API will be removed in 2.0. Instead, use the More Like This Query.
  org.elasticsearch.client.IndicesAdminClient.prepareStatus(String...)
  org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramBuilder.preZone(String) use timeZone() instead
  org.elasticsearch.search.aggregations.bucket.histogram.DateHistogramBuilder.preZoneAdjustLargeInterval(boolean) this option is going to be removed in 2.0 releases
  org.elasticsearch.node.service.NodeService.putNodeAttribute(String, String)
  org.elasticsearch.index.query.QueryBuilders.queryString(String) by queryStringQuery(String)
  org.elasticsearch.node.service.NodeService.removeNodeAttribute(String)
  org.elasticsearch.action.bulk.BulkRequest.replicationType() will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.ShardReplicationOperationRequest.replicationType() will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.update.UpdateRequest.replicationType() will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.bulk.BulkRequest.replicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.ShardReplicationOperationRequest.replicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.update.UpdateRequest.replicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.ShardReplicationOperationRequest.replicationType(String) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.script.ScriptService.search(SearchLookup, String, String, ScriptService.ScriptType, Map<String, Object>) use the method variant that accepts the ScriptContext argument too: ScriptService.search(SearchLookup, String, String, ScriptType, ScriptContext, Map)
  org.elasticsearch.action.search.SearchRequestBuilder.setFacets(byte[]) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.search.SearchRequestBuilder.setFacets(byte[], int, int) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.search.SearchRequestBuilder.setFacets(BytesReference) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.search.SearchRequestBuilder.setFacets(Map) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.search.SearchRequestBuilder.setFacets(XContentBuilder) Facets are deprecated and will be removed in a future release. Please use aggregations instead.
  org.elasticsearch.action.admin.indices.get.GetIndexRequestBuilder.setFeatures(String...) use #setFeatures(Feature[]) instead
  org.elasticsearch.action.admin.indices.refresh.RefreshRequestBuilder.setForce(boolean) unnecessary flag since 1.5.0
  org.elasticsearch.common.io.UTF8StreamWriter.setOutputStream(OutputStream) Replaced by UTF8StreamWriter.setOutput(OutputStream)
  org.elasticsearch.action.bulk.BulkRequestBuilder.setReplicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.IndicesReplicationOperationRequestBuilder.setReplicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.ShardReplicationOperationRequestBuilder.setReplicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.update.UpdateRequestBuilder.setReplicationType(ReplicationType) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.IndicesReplicationOperationRequestBuilder.setReplicationType(String) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.action.support.replication.ShardReplicationOperationRequestBuilder.setReplicationType(String) will be removed in 2.0.0. See https://github.com/elastic/elasticsearch/pull/10171
  org.elasticsearch.env.NodeEnvironment.shardDataLocations(ShardId, Settings) use shardDataPaths instead
  org.elasticsearch.env.NodeEnvironment.shardLocations(ShardId) use NodeEnvironment.shardPaths(org.elasticsearch.index.shard.ShardId) instead
  org.elasticsearch.index.query.QueryBuilders.simpleQueryString(String) by simpleQueryStringQuery(String)
  org.elasticsearch.client.IndicesAdminClient.status(IndicesStatusRequest)
  org.elasticsearch.client.IndicesAdminClient.status(IndicesStatusRequest, ActionListener<IndicesStatusResponse>)
  org.elasticsearch.action.support.IndicesOptions.strict() in favor of IndicesOptions.strictExpandOpen() whose name makes it clearer what the method actually does.
  org.elasticsearch.index.query.QueryBuilders.textPhrase(String, Object) use QueryBuilders.textPhraseQuery(String, Object) instead Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.textPhrasePrefix(String, Object) use QueryBuilders.textPhrasePrefixQuery(String, Object) instead Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.textPhrasePrefixQuery(String, Object) Use QueryBuilders.matchPhrasePrefixQuery(String, Object) Will be removed in elasticsearch 2.0.0
  org.elasticsearch.index.query.QueryBuilders.textPhraseQuery(String, Object) Use QueryBuilders.matchPhraseQuery(String, Object)
  org.elasticsearch.index.query.QueryBuilders.topChildrenQuery(String, QueryBuilder)
  org.elasticsearch.index.query.MultiMatchQueryBuilder.useDisMax(boolean) use a tieBreaker of 1.0f to disable "dis-max" query or select the appropriate MultiMatchQueryBuilder.Type

• Deprecated Constructors

  Constructor and Description
  org.elasticsearch.index.analysis.StandardHtmlStripAnalyzer(Version) use StandardHtmlStripAnalyzer.StandardHtmlStripAnalyzer(org.apache.lucene.util.Version, org.apache.lucene.analysis.util.CharArraySet) instead

• Deprecated Enum Constants

  Enum Constant and Description
  org.elasticsearch.search.aggregations.support.ValueType.ANY
  org.elasticsearch.script.ScriptContext.Standard.GENERIC_PLUGIN create a new ScriptContext.Plugin instance instead
  org.elasticsearch.cluster.block.ClusterBlockLevel.METADATA Use METADATA_READ or METADATA_WRITE instead.