NAME Net::Etcd SYNOPSIS Etcd v3.1.0 or greater is required. To use the v3 API make sure to set environment variable ETCDCTL_API=3. Precompiled binaries can be downloaded at https://github.com/coreos/etcd/releases. $etcd = Net::Etcd->new(); # host: 127.0.0.1 port: 2379 $etcd = Net::Etcd->new({ host => $host, port => $port, ssl => 1 }); # put key $result = $etcd->put({ key =>'foo1', value => 'bar' }); # get single key $key = $etcd->range({ key =>'test0' }); # return single key value or the first in a list. $key->get_value # get range of keys $range = $etcd->range({ key =>'test0', range_end => 'test100' }); # return array { key => value } pairs from range request. my @users = $range->all # watch key range, streaming. $watch = $etcd->watch( { key => 'foo', range_end => 'fop'}, sub { my ($result) = @_; print STDERR Dumper($result); })->create; # create/grant 20 second lease $etcd->lease( { ID => 7587821338341002662, TTL => 20 } )->grant; # attach lease to put $etcd->put( { key => 'foo2', value => 'bar2', lease => 7587821338341002662 } ); DESCRIPTION Net::Etcd is object oriented interface to the v3 REST API provided by the etcd grpc-gateway . ACCESSORS host port username password ssl api_root api_prefix defaults to /v3alpha api_path auth_token PUBLIC METHODS watch Returns a Net::Etcd::Watch object. $etcd->watch({ key =>'foo', range_end => 'fop' }) role Returns a Net::Etcd::Auth::Role object. $etcd->role({ role => 'foo' }); user_role Returns a Net::Etcd::User::Role object. $etcd->user_role({ name => 'samba', role => 'foo' }); auth Returns a Net::Etcd::Auth object. lease Returns a Net::Etcd::Lease object. maintenance Returns a Net::Etcd::Maintenance object. user Returns a Net::Etcd::User object. put Returns a Net::Etcd::KV::Put object. range Returns a Net::Etcd::KV::Range object. txn Returns a Net::Etcd::KV::Txn object. configuration Initialize configuration checks to see it etcd is installed locally. AUTHOR Sam Batschelet, ACKNOWLEDGEMENTS The etcd developers and community. CAVEATS The etcd v3 API is in heavy development and can change at anytime please see https://github.com/coreos/etcd/blob/master/Documentation/dev-guide/api_r eference_v3.md for latest details. LICENSE AND COPYRIGHT Copyright 2017 Sam Batschelet (hexfusion). This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.