open-consul/api
2018-06-14 09:41:58 -07:00
..
acl.go
acl_test.go
agent.go Adds api client code and tests for new Proxy Config endpoint, registering with proxy and seeing proxy config in /agent/services list. 2018-06-14 09:41:58 -07:00
agent_test.go Adds api client code and tests for new Proxy Config endpoint, registering with proxy and seeing proxy config in /agent/services list. 2018-06-14 09:41:58 -07:00
api.go Adds api client code and tests for new Proxy Config endpoint, registering with proxy and seeing proxy config in /agent/services list. 2018-06-14 09:41:58 -07:00
api_test.go
catalog.go Add Connect agent, catalog and health endpoints to api Client 2018-06-14 09:41:54 -07:00
catalog_test.go Add Connect agent, catalog and health endpoints to api Client 2018-06-14 09:41:54 -07:00
connect.go api: fix up some comments and rename IssuedCert to LeafCert 2018-06-14 09:41:56 -07:00
connect_ca.go api: fix up some comments and rename IssuedCert to LeafCert 2018-06-14 09:41:56 -07:00
connect_ca_test.go api: starting intention endpoints, reorganize files slightly 2018-06-14 09:41:55 -07:00
connect_intention.go api: IntentionMatch 2018-06-14 09:41:56 -07:00
connect_intention_test.go api: IntentionMatch 2018-06-14 09:41:56 -07:00
coordinate.go
coordinate_test.go
event.go
event_test.go
health.go Add Connect agent, catalog and health endpoints to api Client 2018-06-14 09:41:54 -07:00
health_test.go require -> assert until rebase 2018-06-14 09:41:54 -07:00
kv.go
kv_test.go
lock.go
lock_test.go
operator.go
operator_area.go
operator_autopilot.go
operator_autopilot_test.go
operator_keyring.go
operator_keyring_test.go
operator_raft.go
operator_raft_test.go
operator_segment.go
prepared_query.go
prepared_query_test.go
raw.go
README.md
semaphore.go
semaphore_test.go
session.go
session_test.go
snapshot.go
snapshot_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.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)