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.
 
 
 
 
 
 
James Phillips 496b0bcf07 Adds support for agent-side ACL token management via API instead of config files. (#3324) 7 years ago
..
README.md
acl.go Tweaks ACL replication struct name. 8 years ago
acl_test.go api: refactor: unify naming of API tests 7 years ago
agent.go Adds support for agent-side ACL token management via API instead of config files. (#3324) 7 years ago
agent_test.go Adds support for agent-side ACL token management via API instead of config files. (#3324) 7 years ago
api.go Expands and rework context support in the API client. (#3273) 7 years ago
api_test.go api: refactor: prefix all API tests with API_ 7 years ago
catalog.go Add datacenter to catalog node API (#2917) 8 years ago
catalog_test.go api: fix TestAPI_CatalogNodes test 7 years ago
coordinate.go Adds router into RPC paths with work in progress on coordinates. 8 years ago
coordinate_test.go api: refactor: unify naming of API tests 7 years ago
event.go
event_test.go api: refactor: unify naming of API tests 7 years ago
health.go api: Add ServiceTags to Health state endpoint (#153) 8 years ago
health_test.go api: refactor: unify naming of API tests 7 years ago
kv.go Issue #2905: Add check-not-exists to TXN endpoint 8 years ago
kv_test.go api: refactor: unify naming of API tests 7 years ago
lock.go golint: Untangle if blocks with return in else 8 years ago
lock_test.go api: refactor: unify naming of API tests 7 years ago
operator.go Moves operator sub-functions into their own files. 8 years ago
operator_area.go Adds missing area API. 8 years ago
operator_autopilot.go Add UpgradeVersionTag to autopilot config 7 years ago
operator_autopilot_test.go api: refactor: unify naming of API tests 7 years ago
operator_keyring.go Moves operator sub-functions into their own files. 8 years ago
operator_keyring_test.go api: refactor: unify naming of API tests 7 years ago
operator_raft.go Moves operator sub-functions into their own files. 8 years ago
operator_raft_test.go api: refactor: unify naming of API tests 7 years ago
prepared_query.go
prepared_query_test.go api: refactor: prefix all API tests with API_ 7 years ago
raw.go
semaphore.go golint: Untangle if blocks with return in else 8 years ago
semaphore_test.go api: refactor: unify naming of API tests 7 years ago
session.go Expands and rework context support in the API client. (#3273) 7 years ago
session_test.go Expands and rework context support in the API client. (#3273) 7 years ago
snapshot.go
snapshot_test.go api: refactor: prefix all API tests with API_ 7 years ago
status.go
status_test.go api: refactor: prefix all API tests with API_ 7 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)