History

Kyle Havlovitz c1f776c78b Added operator autopilot subcommands		8 years ago
..
README.md	…
acl.go	…
acl_test.go	…
agent.go	Add reload/leave http endpoints (#2516 )	8 years ago
agent_test.go	Lets the leave unit test proceed even after an EOF.	8 years ago
api.go	Update unix dial functions to use DialContext with new go-cleanhttp	8 years ago
api_test.go	Update unix dial functions to use DialContext with new go-cleanhttp	8 years ago
catalog.go	Adds catalog support for node IDs.	8 years ago
catalog_test.go	Add node metadata filtering to remaining health/catalog endpoints	8 years ago
coordinate.go	…
coordinate_test.go	…
event.go	…
event_test.go	…
health.go	Return the correct type	8 years ago
health_test.go	Add node metadata filtering to remaining health/catalog endpoints	8 years ago
kv.go	fix KVOp types	8 years ago
kv_test.go	Fix race condition in TestClient_WatchList and TestClient_WatchGet	8 years ago
lock.go	Adds comment about SessionOpts.	8 years ago
lock_test.go	More flaky unit test fixes (#2449 )	8 years ago
operator.go	Added operator autopilot subcommands	8 years ago
operator_test.go	Added operator autopilot subcommands	8 years ago
prepared_query.go	Add tests for node meta in prepared queries and update docs	8 years ago
prepared_query_test.go	Add tests for node meta in prepared queries and update docs	8 years ago
raw.go	…
semaphore.go	…
semaphore_test.go	…
session.go	…
session_test.go	…
snapshot.go	Adds support for snapshots and restores. (#2396 )	8 years ago
snapshot_test.go	Adds support for snapshots and restores. (#2396 )	8 years ago
status.go	…
status_test.go	…

README.md

Consul API client

This package provides the api package which attempts to provide programmatic access to the full Consul API.

Currently, all of the Consul APIs included in version 0.6.0 are supported.

Documentation

The full documentation is available on Godoc

Usage

Below is an example of using the Consul client:

// Get a new client
client, err := api.NewClient(api.DefaultConfig())
if err != nil {
    panic(err)
}

// Get a handle to the KV API
kv := client.KV()

// PUT a new KV pair
p := &api.KVPair{Key: "foo", Value: []byte("test")}
_, err = kv.Put(p, nil)
if err != nil {
    panic(err)
}

// Lookup the pair
pair, _, err := kv.Get("foo", nil)
if err != nil {
    panic(err)
}
fmt.Printf("KV: %v", pair)