open-nomad/vendor/github.com/hashicorp/consul/api
Chris Baker 01c79666f0
vendor: updated consul-template and downstream
consul-template -> v0.20.0
consul/api -> v1.2.1
vault/api -> v1.0.3
go-retryablehttp -> v0.5.2
circonus-gometrics: modified local source for compat with go-retryablehttp
2019-04-10 10:34:10 -05:00
..
acl.go vendor: update consul for grpc 2018-05-04 11:08:11 -07:00
agent.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
api.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
catalog.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
connect.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
connect_ca.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
connect_intention.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
coordinate.go vendor: update consul for grpc 2018-05-04 11:08:11 -07:00
event.go Using godeps to build 2016-02-12 10:02:16 -08:00
health.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
kv.go vendor: update consul for grpc 2018-05-04 11:08:11 -07:00
lock.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
operator.go Update consul/api to support unix socket addrs 2017-05-08 11:57:04 -07:00
operator_area.go Update vendored Consul to 1.0.0 2017-10-16 16:04:14 -07:00
operator_autopilot.go vendor: update consul for grpc 2018-05-04 11:08:11 -07:00
operator_keyring.go Update vendored Consul to 1.0.0 2017-10-16 16:04:14 -07:00
operator_raft.go Update vendored Consul to 1.0.0 2017-10-16 16:04:14 -07:00
operator_segment.go Update vendored Consul to 1.0.0 2017-10-16 16:04:14 -07:00
prepared_query.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
raw.go Using godeps to build 2016-02-12 10:02:16 -08:00
README.md Using godeps to build 2016-02-12 10:02:16 -08:00
semaphore.go vendor: updated consul-template and downstream 2019-04-10 10:34:10 -05:00
session.go Update Consul to v0.9.2 for Header and Method 2017-08-17 16:44:21 -07:00
snapshot.go vendor 2017-01-23 11:00:12 -08:00
status.go Using godeps to build 2016-02-12 10:02:16 -08:00

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)