github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
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.
3386 Commits
1703 Branches
457 Tags
697 MiB
 
 
 
 
 
 
Tree: 7af6a94edb
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '7af6a94edb'
${ noResults }
consul/api
Seth Vargo cae0ff354a
Use HTTPS + www. where appropriate 		9 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 Adds Docker checks support to client API. 9 years ago
agent_test.go Adds Docker checks support to client API. 9 years ago
api.go Factors server error checking into a new function. 9 years ago
api_test.go Factors server error checking into a new function. 9 years ago
catalog.go Add 'ServiceAddress' field to 'CatalogService's truct 10 years ago
catalog_test.go api: run tests in parallel 10 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 remove various typos 9 years ago
health_test.go api: run tests in parallel 10 years ago
kv.go Fix a bunch of typos. 9 years ago
kv_test.go Fixes a broken unit test introduced by #834. 10 years ago
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 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
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)