open-consul/api
Kyle Havlovitz d436463d75 revert go changes to hide rotation config 2018-06-25 12:26:18 -07:00
..
README.md
acl.go
acl_test.go
agent.go api: support native connect 2018-06-25 12:24:10 -07:00
agent_test.go Fix test broken by final telemetry PR change! 2018-06-25 12:25:40 -07:00
api.go api: change Connect to a query option 2018-06-25 12:24:14 -07:00
api_test.go
catalog.go
catalog_test.go api: support native connect 2018-06-25 12:24:10 -07:00
connect.go
connect_ca.go connect: fix two CA tests that were broken in a previous PR (#60) 2018-06-25 12:25:10 -07:00
connect_ca_test.go revert go changes to hide rotation config 2018-06-25 12:26:18 -07:00
connect_intention.go api: update intention struct for precedence 2018-06-25 12:24:16 -07:00
connect_intention_test.go Fix misc test failures (some from other PRs) 2018-06-25 12:25:13 -07:00
coordinate.go
coordinate_test.go
event.go
event_test.go
health.go Misc comment cleanups 2018-06-25 12:24:16 -07:00
health_test.go Misc comment cleanups 2018-06-25 12:24:16 -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 api: change Connect to a query option 2018-06-25 12:24:14 -07:00
prepared_query_test.go
raw.go
semaphore.go
semaphore_test.go
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)