open-consul/api
2015-01-12 17:43:54 -08:00
..
acl.go
acl_test.go
agent.go
agent_test.go
api.go
api_test.go api: test for a known leader as well as index > 0 2015-01-09 16:39:35 -08:00
catalog.go
catalog_test.go api: improve reliability of catalog endpoint tests 2015-01-07 18:29:42 -08:00
event.go
event_test.go
health.go
health_test.go
kv.go
kv_test.go
lock.go api: Minor cleanups in lock 2015-01-12 17:43:13 -08:00
lock_test.go api: Fixing typos 2015-01-09 17:42:24 -08:00
README.md
semaphore.go api: First pass at semaphore 2015-01-12 17:43:54 -08:00
session.go
session_test.go
status.go
status_test.go

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.3 are supported.

Documentation

The full documentation is available on Godoc

Usage

Below is an example of using the Consul client:

// Get a new client, with KV endpoints
client, _ := api.NewClient(api.DefaultConfig())
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)