History

Mitchell Hashimoto 1c3e9af316 agent: 400 error on invalid UUID format, api handles errors properly		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	agent: 400 error on invalid UUID format, api handles errors properly	7 years ago
connect_intention_test.go	agent: 400 error on invalid UUID format, api handles errors properly	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)