History

Kyle Havlovitz 162daca4d7 revert go changes to hide rotation config		7 years ago
..
README.md	…
acl.go	…
acl_test.go	…
agent.go	api: support native connect	7 years ago
agent_test.go	Fix test broken by final telemetry PR change!	7 years ago
api.go	api: change Connect to a query option	7 years ago
api_test.go	…
catalog.go	…
catalog_test.go	api: support native connect	7 years ago
connect.go	…
connect_ca.go	connect: fix two CA tests that were broken in a previous PR (#60 )	7 years ago
connect_ca_test.go	revert go changes to hide rotation config	7 years ago
connect_intention.go	api: update intention struct for precedence	7 years ago
connect_intention_test.go	Fix misc test failures (some from other PRs)	7 years ago
coordinate.go	…
coordinate_test.go	…
event.go	…
event_test.go	…
health.go	Misc comment cleanups	7 years ago
health_test.go	Misc comment cleanups	7 years ago
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	7 years ago
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)