consul/api
Jeff Mitchell 1e3840b044 Update cleanhttp repo location 2015-10-22 14:14:22 -04:00
..
README.md api: initial import from armon/consul-api 2015-01-06 10:40:00 -08:00
acl.go Revert "fixed: body not closed for non HTTP 200 responses" 2015-01-19 11:51:51 +09:00
acl_test.go api: run ACL tests by default 2015-06-13 23:51:30 +02:00
agent.go Add TCP check type 2015-07-24 14:06:05 +10:00
agent_test.go Fix tests after merge 2015-05-11 18:53:09 -07:00
api.go Update cleanhttp repo location 2015-10-22 14:14:22 -04:00
api_test.go api: run ACL tests by default 2015-06-13 23:51:30 +02: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 Revert "fixed: body not closed for non HTTP 200 responses" 2015-01-19 11:51:51 +09:00
event_test.go api: improve test reliability 2015-05-12 12:10:25 -07:00
health.go remove various typos 2015-09-11 12:29:54 -07:00
health_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
kv.go Fix a bunch of typos. 2015-09-15 13:22:08 +01: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 Fixes a typo. 2015-10-15 14:59:09 -07:00
raw.go api: Refactoring into shared write logic 2015-02-18 15:15:02 -08:00
semaphore.go Fix a bunch of typos. 2015-09-15 13:22:08 +01:00
semaphore_test.go api: run tests in parallel 2015-05-08 10:27:24 -07:00
session.go Merge pull request #1041 from rboyer/api-fix-session-renew 2015-09-25 13:15:54 -07:00
session_test.go Correct the Session.Renew{,Periodic} to handle session expiration better 2015-09-14 08:52:32 -05:00
status.go Revert "fixed: body not closed for non HTTP 200 responses" 2015-01-19 11:51:51 +09:00
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)