Skip to main content

Consul.NET

.NET client library for the Consul HTTP API

Downloads
NuGet
CI
License
Contributors
Contribute with GitPod
.NET Framework: >= 4.6.1
.NET Core: >= 2.0.0
dotnet add package Consul

Curious about what's next? try the โšก preview version

Easy to Use

Consul.NET was designed by humans, for humans. It's meant to be intuitive, simple and easy to use.

Open-Source

Consul.NET is open-source and free to use. It's developed by the community and for the community.

Production Ready

Consul.NET is used in production by many companies and is battle-tested.

Supported APIs

Consul API: 1.7.14

This version indicates the version of Consul API that is fully supported. Recent versions may still work, but with some missing features.

โœ… supported ยท ๐Ÿšง in progress ยท โŒ not supported

GroupEndpointRouteStatus
Agent - BaseList MembersGET /v1/agent/membersโœ…
Read ConfigurationGET /v1/agent/selfโœ…
Reload AgentPUT /v1/agent/reloadโœ…
Enable Maintenance ModePUT /v1/agent/maintenanceโœ…
Join AgentGET /v1/agent/join/:idโœ…
Graceful Leave + ShutdownPUT /v1/agent/leaveโœ…
Force Leave + ShutdownPUT /v1/agent/force-leaveโœ…
Agent - ChecksList ChecksGET /v1/agent/checksโœ…
Register CheckPUT /v1/agent/check/registerโœ…
Deregister CheckPUT /v1/agent/check/deregister/:idโœ…
TLL Check PassGET /v1/agent/check/pass/:idโœ…
TLL Check WarnGET /v1/agent/check/warn/:idโœ…
TLL Check FailGET /v1/agent/check/fail/:idโœ…
TLL Check UpdateGET /v1/agent/check/update/:idโœ…
Agent - ServicesList ServicesGET /v1/agent/servicesโœ…
Register ServicePUT /v1/agent/service/registerโœ…
Deregister ServicePUT /v1/agent/service/deregister/:idโœ…
Enable Maintenance ModePUT /v1/agent/service/maintenance/:idโœ…
CatalogList DatacentersGET /v1/catalog/datacentersโœ…
List Nodes in a given DCGET /v1/catalog/nodesโœ…
List Services in a given DCGET /v1/catalog/servicesโœ…
List Nodes for ServiceGET /v1/catalog/service/:idโœ…
List Services for NodeGET /v1/catalog/node/:idโœ…
CoordinatesRead WAN CoordinatesGET /v1/coordinates/datacentersโœ…
Read LAN CoordinatesGET /v1/coordinates/nodesโœ…
EventsFire EventPUT /v1/event/fire/:nameโœ…
List EventsGET /v1/event/listโœ…
HealthList Checks for NodeGET /v1/health/node/:idโœ…
List Checks for ServiceGET /v1/health/checks/:idโœ…
List Nodes for ServiceGET /v1/health/service/:idโœ…
List Checks in StateGET /v1/health/state/:stateโœ…
KV StoreRead KeyGET /v1/kv/:keyโœ…
Create/Update KeyPUT /v1/kv/:keyโœ…
Delete KeyDELETE /v2/kv/:keyโœ…
NamespaceList NamespacesGET /v1/namespacesโœ…
Read NamespaceGET /v1/namespace/:nameโœ…
Create NamespacePUT /v1/namespaceโœ…
Update NamespacePUT /v1/namespace/:nameโœ…
Delete NamespaceDELETE /v1/namespace/:nameโœ…