Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion docs/reference/release-highlights.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,11 @@ mapped_pages:

These are the important new features and changes in minor releases. Every release also updates the Java API Client to the latest [API specification](https://github.com/elastic/elasticsearch-specification). This includes new APIs, as well as bug fixes in the specification of existing APIs.

For a list of detailed changes, including bug fixes, see the [GitHub project release notes](https://github.com/elastic/elasticsearch-java/releases).
For a list of detailed changes, including bug fixes, refer to the [GitHub project release notes](https://github.com/elastic/elasticsearch-java/releases).

## 9.4.0 [release-highlights-940]

[Release notes](/release-notes/9-4-0.md)

## 9.3.0 [release-highlights-930]

Expand Down
120 changes: 120 additions & 0 deletions docs/release-notes/9-4-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,120 @@
---
navigation_title: "9.4.0"
---
# Elasticsearch Java Client 9.4.0 [elasticsearch-java-client-940]

Discover what changed in the 9.4.0 version of the Java client.

## Breaking changes [elasticsearch-java-client-940-breaking-changes]

This version presents many updates to existing fields that were wrongly mapped, or incomplete. Here is the complete list of changes:

::::{dropdown} From generic json to specific type

- elasticsearch.inference.CustomResponseParams
- `jsonParser`: modified from `json.JsonData` to `Map`

- elasticsearch.inference.CustomServiceSettings
- `headers`: modified from `json.JsonData` to `Map`, now required
- `inputType`: modified from `json.JsonData` to `Map`, now required
- `queryParameters`: modified from `json.JsonData` to `List`, now required
- `secretParameters`: modified from `json.JsonData` to `Map`

- elasticsearch.inference.CustomTaskSettings
- `parameters`: modified from `json.JsonData` to `Map`, now required

- elasticsearch.inference.OpenAITaskSettings
- `headers`: modified from `json.JsonData` to `Map`, now required
::::

::::{dropdown} From String to Enum

- elasticsearch.inference.ContentObject
- `type`: modified from `String` to `elasticsearch.inference.ContentType`

- elasticsearch.searchable_snapshots.MountRequest
- `storage`: modified from `String` to `elasticsearch.searchable_snapshots.mount.StorageOption`
::::

::::{dropdown} Serialization changes

From this version of the client, CSV type URL parameters with value `null` will no longer be serialized as `null`, and will be instead filtered out.
More information in the relevant PR [#1222](https://github.com/elastic/elasticsearch-java/pull/1222).
::::

::::{dropdown} Type removals

- elasticsearch.indices.get_all_sample_configuration.IndexSamplingConfiguration: **removed**

- elasticsearch.indices.DeleteSampleConfigurationRequest: **removed**

- elasticsearch.indices.DeleteSampleConfigurationResponse: **removed**

- elasticsearch.indices.get_sample.RawDocument: **removed**

- elasticsearch.indices.GetAllSampleConfigurationRequest: **removed**

- elasticsearch.indices.GetAllSampleConfigurationResponse: **removed**

- elasticsearch.indices.GetSampleConfigurationRequest: **removed**

- elasticsearch.indices.GetSampleConfigurationResponse: **removed**

- elasticsearch.indices.GetSampleRequest: **removed**

- elasticsearch.indices.GetSampleResponse: **removed**

- elasticsearch.indices.GetSampleStatsRequest: **removed**

- elasticsearch.indices.GetSampleStatsResponse: **removed**

- elasticsearch.indices.PutSampleConfigurationRequest: **removed**

- elasticsearch.indices.PutSampleConfigurationResponse: **removed**

- elasticsearch.indices.SamplingConfiguration: **removed**

- elasticsearch.inference.TextEmbeddingByteResult: **removed**

- elasticsearch.inference.TextEmbeddingResult: **removed**

- elasticsearch.security.ApiKeyManagedBy: **removed**

- elasticsearch.streams.status.LogsStatus: **removed**
::::

::::{dropdown} Other changes

- elasticsearch._types.aggregations.FieldDateMath
- `value`: modified from `Double` to `Long`

- elasticsearch.cluster.ComponentTemplate
- `componentTemplate`: modified from `elasticsearch.cluster.ComponentTemplateNode` to `elasticsearch.cluster.ComponentTemplateNodeWithRollover`

- elasticsearch.cluster.ComponentTemplateSummary
- `lifecycle`: modified from `elasticsearch.indices.DataStreamLifecycleWithRollover` to `elasticsearch.indices.DataStreamLifecycle`

- elasticsearch.indices.get_index_template.IndexTemplateItem
- `indexTemplate`: modified from `elasticsearch.indices.IndexTemplate` to `elasticsearch.indices.IndexTemplateWithRollover`

- elasticsearch.indices.IndexTemplateSummary
- `lifecycle`: modified from `elasticsearch.indices.DataStreamLifecycleWithRollover` to `elasticsearch.indices.DataStreamLifecycle`

- elasticsearch.security.authenticate.AuthenticateApiKey
- `managedBy`: modified from `elasticsearch.security.ApiKeyManagedBy` to `elasticsearch.security.CredentialManagedBy`

- elasticsearch.streams.StreamsStatusResponse
- `logs`: modified from `elasticsearch.streams.status.LogsStatus` to `elasticsearch.streams.status.StreamStatus`
::::

## Features and enhancements [elasticsearch-java-client-940-features-enhancements]

::::{dropdown} Less generic exception messages

Introduced with [#1213](https://github.com/elastic/elasticsearch-java/pull/1213), adding more information taken from `ElasticsearchException`'s fields to the main error message.
For example, instead of `all shards failed` the error message will be `all shards failed - Failed to parse query ["test"]`.
::::

## Deprecations [elasticsearch-java-client-940-deprecations]

Nothing was deprecated in this version of the client.
3 changes: 3 additions & 0 deletions docs/release-notes/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ To check for security updates, refer to [Security announcements for the Elastic

To check for issues, refer to [Known issues](../release-notes/known-issues.md).

## 9.4.0
[Release notes](../release-notes/9-4-0.md)

## 9.3.0
[Release notes](../release-notes/9-3-0.md)

Expand Down
1 change: 1 addition & 0 deletions docs/release-notes/toc.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
toc:
- file: index.md
- file: known-issues.md
- file: 9-4-0.md
- file: 9-3-0.md
- file: 9-2-0.md
- file: 9-1-0.md
Expand Down
Loading