History

Ryan Slade dcb392df46 Simplify string(buf.Bytes()) to buf.String() (#3590 )		7 years ago
..
README.md	…
acl.go	…
acl_test.go	…
agent.go	Fixes API client for ScriptArgs and updates documentation. (#3589 )	7 years ago
agent_test.go	Fixes API client for ScriptArgs and updates documentation. (#3589 )	7 years ago
api.go	Replace time.Now().Sub(x) with time.Since(x)	7 years ago
api_test.go	retry locks on network errors (#3553 )	7 years ago
catalog.go	…
catalog_test.go	New config parser, HCL support, multiple bind addrs (#3480 )	7 years ago
coordinate.go	…
coordinate_test.go	…
event.go	…
event_test.go	…
health.go	…
health_test.go	New config parser, HCL support, multiple bind addrs (#3480 )	7 years ago
kv.go	Simplify string(buf.Bytes()) to buf.String() (#3590 )	7 years ago
kv_test.go	…
lock.go	Replace time.Now().Sub(x) with time.Since(x)	7 years ago
lock_test.go	Replace time.Now().Sub(x) with time.Since(x)	7 years ago
operator.go	…
operator_area.go	Cleans up some drift between the OSS and Enterprise trees.	7 years ago
operator_autopilot.go	Simplify string(buf.Bytes()) to buf.String() (#3590 )	7 years ago
operator_autopilot_test.go	…
operator_keyring.go	Shows the segment name in the keyring API and command output.	7 years ago
operator_keyring_test.go	New config parser, HCL support, multiple bind addrs (#3480 )	7 years ago
operator_raft.go	Move Raft protocol version for list peers end point to server side, fix unit tests. This fixes #3449	7 years ago
operator_raft_test.go	…
operator_segment.go	Change segment list endpoint in docs/client api	7 years ago
prepared_query.go	…
prepared_query_test.go	…
raw.go	…
semaphore.go	Replace time.Now().Sub(x) with time.Since(x)	7 years ago
semaphore_test.go	Replace time.Now().Sub(x) with time.Since(x)	7 years ago
session.go	…
session_test.go	…
snapshot.go	…
snapshot_test.go	…
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)