Struct Client 

pub struct Client { /* private fields */ }

Implementations

impl Client

pub fn new( peers: impl IntoIterator<Item = impl AsRef<str>> + ExactSizeIterator, endpoint_config: ClientEndpointConfig, ) -> Self

pub fn set_auth_token(&self, token: HeaderValue)

Updates the authentication token used by the client.

This token will be used for all future requests made by the client. This method can be used to do live token rotation, without having to create a new client.

pub fn clear_auth_token(&self)

Clears the authentication token used by the client.

This will cause the client to make requests without an authentication token.

pub fn watcher(&self) -> Arc<WatcherHandle>

Creates, or returns an existing [Watcher] that can be used to watch keys in etcd.

If there is already an existing watcher, this method will return a clone of it, otherwise it will create a new watcher. When all references to the watcher are dropped, the watcher will be dropped as well.

The watcher coalesces watch requests, so that multiple requests watching the same key will only result in a single watch request being made to etcd.

pub async fn grant_lease(&self, ttl: Duration) -> Result<LeaseHandle, Status>

Acquires a lease with the given TTL, spawning a background worker to continue to keep-alive the lease as long as the returned lease::LeaseHandle is alive.

The lease handle provides methods for checking if the lease is still valid.

ttl must be above 10 seconds.