consul/api
James Phillips de29cb4968 Fixes a broken unit test introduced by #834. 2015-06-09 12:01:20 -07:00
..
README.md
acl.go
acl_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
agent.go Allow specifying a status field in the agent/service/register and agent/check/register endpoints. 2015-04-12 02:00:31 +00:00
agent_test.go Fix tests after merge 2015-05-11 18:53:09 -07:00
api.go Read select environment variables when generating the default configuration 2015-03-18 11:12:10 -04:00
api_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
catalog.go Add 'ServiceAddress' field to 'CatalogService's truct 2015-03-04 10:29:57 +01:00
catalog_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
event.go
event_test.go api: improve test reliability 2015-05-12 12:10:25 -07:00
health.go
health_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
kv.go Returns an error for a key with a '/' 2015-03-31 21:08:06 -06:00
kv_test.go Fixes a broken unit test introduced by #834. 2015-06-09 12:01:20 -07:00
lock.go Check to see why a lock acquisition failed 2015-06-05 13:23:23 -07:00
lock_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
raw.go api: Refactoring into shared write logic 2015-02-18 15:15:02 -08:00
semaphore.go Remove unused DefaultSemaphoreRetryTime 2015-05-15 08:25:02 -07:00
semaphore_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
session.go modify RenewPeriodic to retry failed Renews until TTL elapses 2015-05-06 16:40:45 -07:00
session_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
status.go
status_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00

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.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)