github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0e25381494'
${ noResults }
consul/api
History
Michael Fraenkel 0e25381494
Reclaim locks 		10 years ago
..
README.md api: initial import from armon/consul-api 10 years ago
acl.go Revert "fixed: body not closed for non HTTP 200 responses" 10 years ago
acl_test.go api: add harnessing for tests 10 years ago
agent.go api: allow timeout field to be specified for checks 10 years ago
agent_test.go CHANGELOG update, gofmt 10 years ago
api.go Read select environment variables when generating the default configuration 10 years ago
api_test.go Read select environment variables when generating the default configuration 10 years ago
catalog.go Add 'ServiceAddress' field to 'CatalogService's truct 10 years ago
catalog_test.go api: improve reliability of catalog endpoint tests 10 years ago
event.go Revert "fixed: body not closed for non HTTP 200 responses" 10 years ago
event_test.go api: add harnessing for tests 10 years ago
health.go Revert "fixed: body not closed for non HTTP 200 responses" 10 years ago
health_test.go api: make node health test more reliable 10 years ago
kv.go Revert "fixed: body not closed for non HTTP 200 responses" 10 years ago
kv_test.go api: Add support for DeleteCAS 10 years ago
lock.go Reclaim locks 10 years ago
lock_test.go Reclaim locks 10 years ago
raw.go api: Refactoring into shared write logic 10 years ago
semaphore.go api: Refactor to share session renew code 10 years ago
semaphore_test.go api: Detect conflicting existing values for lock/semaphore 10 years ago
session.go api: Refactoring into shared write logic 10 years ago
session_test.go api: add harnessing for tests 10 years ago
status.go Revert "fixed: body not closed for non HTTP 200 responses" 10 years ago
status_test.go api: simple test for unix socket connectivity 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.3 are supported.

Documentation

The full documentation is available on Godoc

Usage

Below is an example of using the Consul client:

// Get a new client, with KV endpoints
client, _ := api.NewClient(api.DefaultConfig())
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)