History

Kyle Havlovitz 8c3db1c5c6 Trim leading slash on key to avoid redirect (golang/go#4800) (#2476 )		8 years ago
..
README.md	Use HTTPS + www. where appropriate	9 years ago
acl.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
acl_test.go	api: run ACL tests by default	10 years ago
agent.go	Add setting to skip ssl certificate verification for HTTP checks (#1984 )	8 years ago
agent_test.go	Adds ability to deregister a service based on critical check state longer than a timeout.	8 years ago
api.go	Adds an `X-Consul-Translate-Addresses` to signal translation is enabled.	8 years ago
api_test.go	Adds an `X-Consul-Translate-Addresses` to signal translation is enabled.	8 years ago
catalog.go	Adds missing TaggedAddress structures to API client.	8 years ago
catalog_test.go	More flaky unit test fixes (#2449 )	8 years ago
coordinate.go	Adds support for coordinates to client API.	9 years ago
coordinate_test.go	Adds support for coordinates to client API.	9 years ago
event.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
event_test.go	api: improve test reliability	10 years ago
health.go	Fixes #1775 ; Removes 'unknown' state	8 years ago
health_test.go	More flaky unit test fixes (#2449 )	8 years ago
kv.go	Trim leading slash on key to avoid redirect (golang/go#4800) (#2476 )	8 years ago
kv_test.go	Fix race condition in TestClient_WatchList and TestClient_WatchGet	8 years ago
lock.go	Adds comment about SessionOpts.	8 years ago
lock_test.go	More flaky unit test fixes (#2449 )	8 years ago
operator.go	Removes Raft types from public API interface.	8 years ago
operator_test.go	Makes the Raft configuration API easier to consume.	8 years ago
prepared_query.go	Delete prepared query using WriteOptions (#2417 )	8 years ago
prepared_query_test.go	Adds missing TaggedAddress structures to API client.	8 years ago
raw.go	api: Refactoring into shared write logic	10 years ago
semaphore.go	Factors server error checking into a new function.	9 years ago
semaphore_test.go	Makes the timeout behavior more intuitive.	9 years ago
session.go	Merge pull request #1041 from rboyer/api-fix-session-renew	9 years ago
session_test.go	Correct the Session.Renew{,Periodic} to handle session expiration better	9 years ago
snapshot.go	Adds support for snapshots and restores. (#2396 )	8 years ago
snapshot_test.go	Adds support for snapshots and restores. (#2396 )	8 years ago
status.go	Revert "fixed: body not closed for non HTTP 200 responses"	10 years ago
status_test.go	api: run tests in parallel	10 years ago

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)