History

James Phillips 3340d7ccd7 Merge pull request #1876 from hashicorp/f-tls-helper Adds TLS config helper to API client.		9 years ago
..
README.md	Use HTTPS + www. where appropriate	9 years ago
acl.go	…
acl_test.go	…
agent.go	Added some constants in the api for check health statuses	9 years ago
agent_test.go	Adds support for new PUT API for checks.	9 years ago
api.go	Improves the comment for the Address field.	9 years ago
api_test.go	Adds TLS config helper to API client.	9 years ago
catalog.go	Adds support for EnableTagOverride to the API client.	9 years ago
catalog_test.go	Adds support for EnableTagOverride to the API client.	9 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	…
event_test.go	…
health.go	Added some constants in the api for check health statuses	9 years ago
health_test.go	…
kv.go	…
kv_test.go	…
lock.go	Use HTTPS + www. where appropriate	9 years ago
lock_test.go	Makes the timeout behavior more intuitive.	9 years ago
prepared_query.go	Removes a useless empty import and fixes some stale comments.	9 years ago
prepared_query_test.go	Adds API client support for prepared queries.	9 years ago
raw.go	…
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	…
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)