elastic/elasticsearch-netPublic

NotificationsYou must be signed in to change notification settings
Fork1.2k
Star3.6k

This strongly-typed, client library enables working with Elasticsearch. It is the official client maintained and supported by Elastic.

www.elastic.co/guide/en/elasticsearch/client/net-api/current/index.html

License

Apache-2.0 license

3.6k stars 1.2k forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 8,168 Commits
.buildkite		.buildkite
.ci		.ci
.github		.github
benchmarks		benchmarks
build		build
docfx		docfx
docs		docs
src		src
tests		tests
.dockerignore		.dockerignore
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.txt		CODE_OF_CONDUCT.txt
CONTRIBUTING.md		CONTRIBUTING.md
Directory.Build.props		Directory.Build.props
Directory.Build.targets		Directory.Build.targets
Elasticsearch.sln		Elasticsearch.sln
LICENSE.txt		LICENSE.txt
NOTICE.txt		NOTICE.txt
Packages.Stack.slnf		Packages.Stack.slnf
README.md		README.md
build.bat		build.bat
build.sh		build.sh
catalog-info.yaml		catalog-info.yaml
dotnet-tools.json		dotnet-tools.json
exclusion.dic		exclusion.dic
global.json		global.json
issue_template.md		issue_template.md
nuget.config		nuget.config
release.bat		release.bat

Repository files navigation

Elasticsearch .NET Client

Repository forElastic.Clients.Elasticsearch the official .NET client forElasticsearch.

Download the latest version of Elasticsearchorsign-upfor a free trial of Elastic Cloud.

The .NET client for Elasticsearch provides strongly typed requests and responsesfor Elasticsearch APIs. It delegates protocol handling to theElastic.Transport library,which takes care of all transport-level concerns (HTTP connection establishmentand pooling, retries, etc.).

Versioning

Themajor andminor version parts of the Elasticsearch .NET client are dictated by the version of the Elasticsearch server.

Warning

This means that the Elasticsearch .NET clientdoes not strictly follows semantic versioning!

Although we try to avoid this as much as possible, it can happen that aminor or evenpatch version contains breaking changes (see also:breaking changes policy). Please always check therelease notes before updating the client package.

Compatibility

Language clients areforward compatible:

Given a constant major version of the client, each related minor version is compatible with its equivalent- and all later Elasticsearch minor versions of thesame or next higher major version.

For example:

Client Version	Compatible with Elasticsearch`8.x`	Compatible with Elasticsearch`9.x`	Compatible with Elasticsearch`10.x`
9.x	❌ no	✅ yes	✅ yes
8.x	✅ yes	✅ yes	❌ no

Language clients are alsobackward compatible across minor versions within thesame major version (without strong guarantees), butnever backward compatible with earlier Elasticsearch major versions.

Note

Compatibility does not imply feature parity. For example, an8.12 client is compatible with8.13, but does not support any of the new features introduced in Elasticsearch8.13.